@capgo/capacitor-native-map

iOS (Apple MapKit)	Android (Google Maps)

El mismo code de TypeScript funciona en ambas plataformas. Estas grabaciones provienen del app de ejemplotour de demostración de code, ejecutándose en un simulador iOS y un emulador Android reales. El code de cada paso está en los demos del README.

Resumen

@capgo/capacitor-native-map te ofrece un único API de TypeScript para rendimiento de mapas nativos en móvil y Google Maps JS en web. Crea mapas embebidos en un contenedor DOM o usa modo en segundo plano (toBack) para dibujar el mapa detrás de un WebView transparente y crear una interfaz de marca con HTML.

Soporte de plataformas

Plataforma	Soporte	Notas
iOS	Sí	MapKit
Android	Sí	Google Maps
Web	Sí	Google Maps JS

Funcionalidades principales

• Ciclo de vida: create, destroy, show, hide, updateLayout, resize sincronizado con las vistas de scroll de Ionic.
• Modo en segundo plano: toBack composición con passthrough multitáctil en HTML transparente.
• Cámara: setCamera, fitBounds, getMapBounds, zoom mín/máx, orientación e inclinación.
• Marcadores: añadir, actualizar, eliminar, arrastrar, clustering y listeners de eventos.
• Superposiciones: polígonos, polilíneas, círculos y overlays de tiles (según la plataforma).
• Eventos: callbacks de map, marker, shape, cluster y camera idle/move.

Público API

Método	Descripción
create	Crear un mapa (CreateMapArgs: id, config, opcional element, apiKey, toBack, forceCreate).
destroy	Destruir la instancia del mapa y liberar recursos nativos.
show / hide	Muestra u oculta el mapa nativo sin destruirlo.
updateLayout	Actualiza la posición y el tamaño en píxeles CSS (especialmente en toBack modo).
enableTouch / disableTouch	Activa o desactiva si el mapa recibe gestos.
setCamera	Mueve o anima la cámara del mapa.
getMapType / setMapType	Lee o establece el tipo de mapa (Normal, Hybrid, Satellite, Terrain, None).
fitBounds	Ajusta el viewport a los límites de latitud y longitud con padding opcional.
getMapBounds	Lee los límites visibles actuales.
setPadding	Establece el padding en la región visible del mapa.
addMarker / addMarkers	Añade uno o varios marcadores; devuelve los ids de los marcadores.
removeMarker / removeMarkers	Elimina marcadores por id.
addPolygons / removePolygons	Añade o elimina overlays de polígonos.
addPolylines / removePolylines	Añadir o eliminar polilíneas.
addCircles / removeCircles	Añadir o eliminar círculos.
addTileOverlay / removeTileOverlay	Capas de tiles personalizadas (Android y web; iOS rechaza con UNAVAILABLE).
enableClustering / disableClustering	Agrupación de marcadores (clustering) con tamaño mínimo opcional.
enableCurrentLocation	Mostrar el punto de ubicación del usuario si hay permisos.
enableIndoorMaps / enableTrafficLayer	Alternar mapas de interiores y tráfico (según la plataforma).
setOnMapClickListener	Detectar toques en la superficie del mapa.
setOnMarkerClickListener	Detectar toques en marcadores.
setOnCameraIdleListener / setOnCameraMoveStartedListener	Eventos de movimiento de cámara.
setOnClusterClickListener	Eventos de toque en clusters.
setOnPolygonClickListener / setOnCircleClickListener / setOnPolylineClickListener	Eventos de toque en formas.
setOnMarkerDragStartListener / setOnMarkerDragListener / setOnMarkerDragEndListener	Eventos de arrastre de marcadores.

Fuente de verdad

Esta referencia de API se genera desde el plugin src/definitions.ts en la capacitor-native-map del repositorio.

Continúa con @capgo/capacitor-native-map

Si estás usando @capgo/capacitor-native-map en tu app Capacitor, conéctala con Uso de @capgo/capacitor-native-map para el tutorial de SEO y la documentación de Capgo relacionada.