Configurar iOS

iOS utiliza Apple MapKit. No necesitas necesitas una clave de API de Google Maps en iOS.

Si llamas a enableCurrentLocation, añade un string de uso de ubicación a ios/App/App/Info.plist:

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

El plugin solicita la ubicación con keepAlive para que enableCurrentLocation puede resolverse de forma fiable tras conceder el permiso.

Mapa detrás del WebView

El modo nativo MKMapView se monta en la jerarquía Capacitor WKWebView y rastrea el elemento DOM vinculado mediante onResize y onDisplayAl volver a entrar en las páginas de Ionic, las rutas del plugin vuelven a montar el mapa si WebKit reconstruyó las scroll views.

Usa un WebView transparente o un fondo de página donde el mapa deba verse a través de las capas HTML sobre el contenedor del mapa.

En toBack modo, coloca data-map-overlay en los wrappers de HUD para que el CSS del overlay del README permita los taps. El router de toque nativo envía gestos al mapa cuando el objetivo es transparente y no está bajo un elemento interactivo.

Métodos de plugin exclusivos de iOS

El bridge nativo de iOS también expone takeSnapshot, searchAutocomplete, searchPlaces, searchResolve, geocode, y reverseGeocode. Estos aún no están en el NativeMap wrapper de la clase. Úsalos directamente en el plugin handle de bajo nivel cuando necesites MapKit search o geocoding en 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');