Setup iOS

iOS menggunakan Apple MapKit. Anda tidak tidak butuh API key Google Maps API di iOS.

Jika Anda memanggil enableCurrentLocation, tambahkan location usage string ke ios/App/App/Info.plist:

<key>NSLocationWhenInUseUsageDescription</key>
<string>We use your location to show you on the map.</string>

Plugin ini meminta lokasi dengan keepAlive agar enableCurrentLocation dapat berjalan dengan andal setelah izin diberikan.

Map di balik WebView

Native MKMapView dimasukkan ke dalam hierarki Capacitor WKWebView dan melacak elemen DOM yang terikat melalui onResize dan onDisplay. Saat halaman Ionic masuk kembali, jalur pemanggilan di plugin akan me-remount map jika WebKit membangun ulang scroll view.

Gunakan WebView transparan atau latar belakang halaman agar map dapat terlihat menembus lapisan HTML di atas kontainer map.

Di toBack mode, letakkan data-map-overlay pada wrapper HUD agar overlay CSS README memungkinkan tap. Native touch router akan mengirimkan gesture ke map saat target hit bersifat transparan dan tidak berada di bawah elemen interaktif.

Metode plugin khusus iOS

Bridge native iOS juga mengekspos takeSnapshot, searchAutocomplete, searchPlaces, searchResolve, geocode, dan reverseGeocode. Ini belum tersedia di NativeMap wrapper class. Panggil langsung pada plugin handle low-level saat Anda butuh MapKit search atau geocoding di iOS:

import { registerPlugin } from '@capacitor/core';

type NativeMapBridge = {
  takeSnapshot(options: { id: string }): Promise<{ image: string }>;
  geocode(options: { address: string }): Promise<Record<string, unknown>>;
};

const NativeMapBridge = registerPlugin<NativeMapBridge>('NativeMap');