Configurar iOS
Copia un prompt de configuración con los pasos de instalación y la guía completa en markdown para este plugin.
iOS usa Apple MapKit. No necesitas necesitas una clave de Google Maps API en iOS.
Si llamas a enableCurrentLocation, añade una cadena 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 una vez concedido el permiso.
Mapa detrás del WebView
Sección titulada «Mapa detrás del WebView»El nativo MKMapView se monta en la jerarquía de WKWebView de Capacitor y sigue el elemento DOM vinculado a través onResize y onDisplay. Cuando las páginas de Ionic vuelven a entrar, las llamadas al plugin vuelven a montar el mapa si WebKit reconstruyó las vistas de desplazamiento.
Usa un WebView o fondo de página transparente donde el mapa debe verse a través de las capas HTML sobre el contenedor del mapa.
En toBack modo, coloca data-map-overlay en los contenedores HUD para que el CSS de superposición del README habilite los toques. El enrutador táctil nativo envía gestos al mapa cuando el objetivo de impacto es transparente y no está bajo un elemento interactivo.
Métodos de plugin exclusivos de iOS
Sección titulada “Métodos de plugin exclusivos de iOS”El puente nativo de iOS también expone takeSnapshot, searchAutocomplete, searchPlaces, searchResolve, geocode, y reverseGeocode. Estos aún no están en el NativeMap envolvente de clase. Llámalos en el manejador de plugin de bajo nivel cuando necesites búsqueda o geocodificación de MapKit 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');