@capgo/capacitor-native-map

iOS (Apple MapKit)	Android (Google Maps)

Lo stesso TypeScript code gira su entrambe le piattaforme. Queste registrazioni provengono dall' app di esempiodemo tour, in esecuzione su un simulatore iOS reale e un emulatore Android. Il code per ogni passaggio si trova nel Demo del README.

Panoramica

@capgo/capacitor-native-map ti offre un unico API TypeScript per le mappe native su mobile e Google Maps JS su web. Crea mappe incorporate in un contenitore DOM, oppure usa modalità background (toBack) per disegnare la mappa dietro una WebView trasparente e creare UI con il tuo brand in HTML.

Supporto piattaforme

Piattaforma	Supporto	Note
iOS	Sì	MapKit
Android	Sì	Google Maps
Web	Sì	Google Maps JS

Funzionalità principali

• Ciclo di vita: create, destroy, show, hide, updateLayout, resize sincronizzato con le scroll view di Ionic.
• Modalità background: toBack compositing con multi-touch passthrough su HTML trasparente.
• Fotocamera: setCamera, fitBounds, getMapBounds, zoom min/max, bearing e tilt.
• Marker: aggiungi, aggiorna, rimuovi, trascina, clustering e listener di eventi.
• Overlay: poligoni, polilinee, cerchi e tile overlay (dipendenti dalla piattaforma).
• Eventi: callback per mappa, marker, shape, cluster e idle/move della camera.

Pubblico API

Metodo	Descrizione
create	Crea una mappa (CreateMapArgs: id, config, opzionale element, apiKey, toBack, forceCreate).
destroy	Distruggi l'istanza della mappa e rilascia le risorse native.
show / hide	Mostra o nascondi la mappa nativa senza distruggerla.
updateLayout	Aggiorna posizione e dimensione in pixel CSS (specialmente in toBack modalità).
enableTouch / disableTouch	Attiva o disattiva la ricezione dei gesti sulla mappa.
setCamera	Sposta o anima la camera della mappa.
getMapType / setMapType	Leggi o imposta il tipo di mappa (Normal, Hybrid, Satellite, Terrain, None).
fitBounds	Adatta la viewport ai limiti di latitudine e longitudine con padding opzionale.
getMapBounds	Leggi i limiti (bounds) attualmente visibili.
setPadding	Imposta il padding sulla regione visibile della mappa.
addMarker / addMarkers	Aggiungi uno o più marker; restituisce gli ID dei marker.
removeMarker / removeMarkers	Rimuovi i marker tramite ID.
addPolygons / removePolygons	Aggiungi o rimuovi overlay poligonali.
addPolylines / removePolylines	Aggiungi o rimuovi polilinee.
addCircles / removeCircles	Aggiungi o rimuovi cerchi.
addTileOverlay / removeTileOverlay	Tile layer personalizzati (Android e web; iOS rifiuta con UNAVAILABLE).
enableClustering / disableClustering	Marker clustering con dimensione minima opzionale.
enableCurrentLocation	Mostra il punto della posizione utente quando i permessi lo consentono.
enableIndoorMaps / enableTrafficLayer	Attiva/disattiva mappe indoor e traffico (dipende dalla piattaforma).
setOnMapClickListener	Ascolta i tap sulla superficie della mappa.
setOnMarkerClickListener	Ascolta i tap sui marker.
setOnCameraIdleListener / setOnCameraMoveStartedListener	Eventi di movimento della camera.
setOnClusterClickListener	Eventi di tap sui cluster.
setOnPolygonClickListener / setOnCircleClickListener / setOnPolylineClickListener	Eventi di tap sulle forme.
setOnMarkerDragStartListener / setOnMarkerDragListener / setOnMarkerDragEndListener	Eventi di trascinamento dei marker.

Fonte di verità

Questa API di riferimento è generata dal plugin src/definitions.ts nel capacitor-native-map repository.

Continua da @capgo/capacitor-native-map

Se stai usando @capgo/capacitor-native-map nella tua app Capacitor, connettila con Usare @capgo/capacitor-native-map per il tutorial SEO e la documentazione del plugin Capgo correlata.