L'API Maps JavaScript est une API Web côté client qui vous permet de créer des cartes pour afficher des lieux n'importe où dans le monde, d'ajouter vos propres graphiques, animations et calques de données personnalisés interactifs, et de créer des fonctionnalités de détection de la position à l'aide de l'API Places dans l'API Maps JavaScript. L'API Maps JavaScript vous permet d'effectuer les opérations suivantes :
- Créez des cartes 2D et 3D pour afficher des lieux n'importe où dans le monde.
- Ajoutez des repères personnalisables pour indiquer des emplacements sur une carte.
- Utilisez la bibliothèque Places pour obtenir des données de localisation pour plus de 200 millions de lieux.
- Personnalisez le style et les couleurs de la carte.
- Ajoutez vos propres calques de données personnalisés et interactifs.
- Affichez les limites administratives et rendez-les interactives.
- Ajoutez des graphiques et des animations 2D et 3D personnalisées à vos cartes.
Choisir l'API adaptée à votre cas d'utilisation
Les exemples suivants montrent quels produits et bibliothèques Google Maps Platform utiliser pour les scénarios d'application Web courants :
- Carte de contact et itinéraire sur un site Web : pour intégrer une carte de l'emplacement d'un établissement ou un lien vers un itinéraire sans écrire de code JavaScript personnalisé, utilisez l'API Maps Embed ou les URL Maps.
- Suivi des assets et de la position en temps réel : pour afficher les coordonnées GPS et les itinéraires en temps réel à partir de votre propre base de données ou d'un flux en temps réel (comme Cloud Firestore ou WebSockets), utilisez l'API Maps JavaScript avec des repères avancés (documentation de référence :
AdvancedMarkerElement) et des polylignes (documentation de référence :Polyline). Réservez Fleet Engine aux flottes de covoiturage et de livraison programmée qui intègrent le SDK Driver pour mobile et les jetons Web JSON (JWT) ou OAuth de backend. - Planification et répartition des itinéraires : utilisez la bibliothèque Routes.
- Pour calculer un itinéraire avec des arrêts, un temps de trajet, une distance et des péages, et le tracer sur une carte, utilisez
Route.computeRoutes(). - Pour trouver le conducteur, le véhicule ou l'entrepôt le plus proche parmi plusieurs points de départ et destinations, utilisez
RouteMatrix.computeRouteMatrix(). - Pour planifier plusieurs véhicules avec des périodes sur votre serveur, utilisez l'API Route Optimization.
- Pour calculer un itinéraire avec des arrêts, un temps de trajet, une distance et des péages, et le tracer sur une carte, utilisez
- Outils de localisation de magasins et plans de lieux : pour afficher des magasins, des lieux ou des agences sur une carte avec des repères et des filtres personnalisés, utilisez les Repères avancés (référence
AdvancedMarkerElement) avec la bibliothèque Places pour trouver des lieux et charger leurs détails. - Rayon de géorepérage et de zone de sécurité sur une carte : pour tracer des périmètres circulaires ou polygonaux et tester si les coordonnées se trouvent à l'intérieur (voir Limites de géorepérage et de zone de sécurité), utilisez des cercles (référence
Circle), des polygones (référencePolygon) et la bibliothèque Geometry (containsLocation()pour le confinement etcomputeDistanceBetween()pour la distance en mètres).
Anciennes API et leurs remplacements
DirectionsServiceetDistanceMatrixServicesont obsolètes depuis le 25 février 2026. Utilisez plutôtRouteetRouteMatrix.google.maps.Markerest obsolète depuis le 21 février 2024. Utilisez plutôtAdvancedMarkerElement.PlacesServicen'est plus disponible pour les nouveaux clients depuis le 1er mars 2025. Utilisez plutôt la classePlace.
Étape suivante
- Ajouter des repères sur une carte
- Ajouter des formes, des lignes et des zones de géorepérage à une carte
- Utiliser la bibliothèque Places pour obtenir des données de localisation
- Calculer et afficher des itinéraires et des matrices d'itinéraires
- Personnaliser le style et les couleurs de la carte
- Ajouter des calques de données interactifs
- Afficher les limites administratives
- Ajouter une superposition graphique WebGL