@capgo/capacitor-native-map

iOS (Apple MapKit)	Android (Google Maps)

Le même code TypeScript s'exécute sur les deux plateformes. Ces enregistrements proviennent de la example apptournant sur un vrai simulateur iOS et un émulateur Android. Le code de chaque étape se trouve dans les démos du README.

Aperçu

@capgo/capacitor-native-map vous offre un API TypeScript unique pour des performances de cartes natives sur mobile et Google Maps JS sur le web. Créez des cartes intégrées dans un conteneur DOM, ou utilisez le mode arrière-plan (toBack) pour afficher la carte derrière une WebView transparente et créer une interface à votre image en HTML.

Support des plateformes

Plateforme	Support	Notes
iOS	Oui	MapKit
Android	Oui	Google Maps
Le Web	Oui	Google Maps JS

Fonctionnalités clés

• Cycle de vie: create, destroy, show, hide, updateLayout, resize sync with Ionic scroll views.
• Mode en arrière-plan: toBack compositing avec passthrough multi-touch sur du HTML transparent.
• Caméra: setCamera, fitBounds, getMapBounds, zoom min/max, orientation et inclinaison.
• Marqueurs: ajout, mise à jour, suppression, glisser-déposer, clustering et écouteurs d'événements.
• Overlays: polygones, polylignes, cercles et overlays de tuiles (selon la plateforme).
• Événements: map, marker, shape, cluster et callbacks d’arrêt/déplacement de la caméra.

API public

Méthode	Description
create	Créer une carte (CreateMapArgs: id, config, facultatif element, apiKey, toBack, forceCreate).
destroy	Détruit l’instance de la carte et libère les ressources natives.
show / hide	Afficher ou masquer la carte native sans la détruire.
updateLayout	Mettre à jour la position et la taille en pixels CSS (particulièrement en toBack mode).
enableTouch / disableTouch	Activez ou désactivez les gestes sur la carte.
setCamera	Déplacer ou animer la caméra de la carte.
getMapType / setMapType	Lire ou définir le type de carte (Normal, Hybrid, Satellite, Terrain, None).
fitBounds	Ajuster la vue aux limites de latitude et de longitude avec un padding optionnel.
getMapBounds	Lire les limites visibles actuelles.
setPadding	Définir un padding sur la région visible de la carte.
addMarker / addMarkers	Ajoutez un ou plusieurs marqueurs ; renvoie les ids des marqueurs.
removeMarker / removeMarkers	Supprimer des marqueurs par ID.
addPolygons / removePolygons	Ajouter ou supprimer des overlays de polygones.
addPolylines / removePolylines	Ajouter ou supprimer des polylignes.
addCircles / removeCircles	Ajouter ou supprimer des cercles.
addTileOverlay / removeTileOverlay	Couches de tuiles personnalisées (Android et web ; iOS rejette avec UNAVAILABLE).
enableClustering / disableClustering	Clustering de marqueurs avec taille minimale de cluster optionnelle.
enableCurrentLocation	Show the user location dot when permission allows.
enableIndoorMaps / enableTrafficLayer	Activer les cartes intérieures et le trafic (selon la plateforme).
setOnMapClickListener	Écouter les clics sur la surface de la carte.
setOnMarkerClickListener	Écouter les clics sur les marqueurs.
setOnCameraIdleListener / setOnCameraMoveStartedListener	Événements de déplacement de la caméra.
setOnClusterClickListener	Événements de clic sur un cluster.
setOnPolygonClickListener / setOnCircleClickListener / setOnPolylineClickListener	Événements de clic sur une forme.
setOnMarkerDragStartListener / setOnMarkerDragListener / setOnMarkerDragEndListener	Événements de drag des marqueurs.

Source de vérité

Cette référence API est générée à partir du plugin src/definitions.ts dans l' capacitor-native-map du dépôt.

Continuez avec @capgo/capacitor-native-map

Si vous utilisez @capgo/capacitor-native-map dans votre application Capacitor, connectez-l’avec Utiliser @capgo/capacitor-native-map pour le tutoriel SEO et la documentation associée du plugin Capgo.