L'API Geocoding est un service qui accepte un lieu sous forme d'adresse, de coordonnées de latitude et de longitude, ou d'ID de lieu. Il convertit l'adresse en coordonnées de latitude et de longitude et en ID de lieu, ou convertit les coordonnées de latitude et de longitude ou un ID de lieu en adresse.
L'API Geocoding v4 fournit à la fois des informations hyperlocales sur la destination et l'arrivée et une résolution de base des coordonnées en adresses. Que vous développiez une expérience de livraison du dernier kilomètre, de covoiturage ou de navigation détaillée, ou que vous normalisiez des adresses postales en coordonnées, la v4 propose des points de terminaison dédiés adaptés à votre cas d'utilisation.
Vous ne savez pas quel point de terminaison convient à votre application ? Consultez Choisir une méthode de géocodage.
Ce que vous pouvez faire avec l'API Geocoding
L'API Geocoding v4 inclut les fonctionnalités et points de terminaison suivants :
- Rechercher des destinations : récupérez des informations d'arrivée hyperlocales pour une destination à partir d'une adresse, d'un ID de lieu ou de coordonnées, y compris les entrées de bâtiments, les jetons de point de navigation routables, les contours des bâtiments et des terrains, les sous-destinations et les points de repère à proximité.
- Géocoder une adresse : convertissez des adresses postales en coordonnées géographiques et en ID de lieu (geocoding).
- Géocoder un lieu : convertissez des coordonnées de latitude et de longitude en adresses postales ou régions administratives lisibles par l'humain (géocodage inversé).
- Géocoder un lieu : récupérez les coordonnées et les détails d'une adresse mise en forme pour un ID de lieu Google Maps connu.
Vous pouvez contrôler l'emplacement des résultats et les limiter à une région, un département ou un code postal spécifiques.
Essayer la démo
Fonctionnement de l'API Geocoding
L'API Geocoding v4 est compatible avec la recherche de destination en plus du géocodage de base :
- Recherche de destination (
SearchDestinations) : résout une adresse, un ID de lieu ou une paire de coordonnées en un objetDestinationenrichi. Utilisez cette méthode lorsque l'arrivée physique est importante, par exemple pour identifier les entrées de bâtiment préférées, diriger les conducteurs vers des points de prise en charge ou de dépose désignés à l'aide de jetons de point de navigation, afficher l'empreinte des bâtiments sur une carte ou naviguer dans des complexes de plusieurs bâtiments. - Geocoding de base : convertit des adresses, des coordonnées et des ID de lieu :
- Geocoding : convertit des adresses postales telles que "1600 Amphitheatre Parkway, Mountain View, CA" en coordonnées de latitude et de longitude ou en ID de lieu pour placer des repères sur la carte ou centrer le cadre de la vue de la carte.
- Geocoding inversé : convertit des coordonnées de latitude et de longitude ou des ID de lieu en adresses postales lisibles par l'humain pour les repères placés par l'utilisateur sur la carte, les sélecteurs de lieu ou l'affichage de l'UI.
- Géocodage de lieu : récupère les détails de l'adresse et les coordonnées d'un ID de lieu Google Maps connu.
Le tableau suivant récapitule les ressources disponibles via l'API Geocoding v4, ainsi que les données renvoyées par chaque méthode :
| Ressources de données | Données renvoyées | Format de retour |
|---|---|---|
| Rechercher des destinations ( POST /v4/geocode/destinations)
|
Renvoie des informations d'arrivée hyperlocales : polygones de bâtiments et de terrains (displayPolygon), entrances physiques, navigationPoints routables (avec jetons), containingPlaces et subDestinations hiérarchiques, landmarks relationnels et détails du lieu principal. Consultez Rechercher des destinations.
|
|
| Géocoder une adresse ( GET /v4/geocode/address)
|
Renvoie l'adresse, les composants d'adresse et les types d'adresse. Consultez Réponse de géocodage. | |
| Géocoder un emplacement ( GET /v4/geocode/location)
|
Renvoie l'adresse, les composants d'adresse et les types d'adresse. Consultez Réponse de geocoding inversé. | |
| Géocoder un lieu ( GET /v4/geocode/places)
|
Renvoie l'adresse, les composants d'adresse et les types d'adresse. Consultez Réponse de géocodage de lieu. |
Canaux d'étapes de lancement
La version 4 de l'API Geocoding dispose de canaux distincts pour les fonctionnalités en disponibilité générale, en preview et expérimentales. Si vous souhaitez utiliser des fonctionnalités en version Preview ou expérimentale, veillez à spécifier le canal approprié dans votre requête. Par exemple, pour accéder aux fonctionnalités du point de terminaison Destinations dans la version expérimentale, utilisez cette requête HTTP : https://geocode.googleapis.com/v4alpha/geocode/destinations.
| Étape de lancement | Nom de la chaîne |
|---|---|
| DG | /v4/ |
| Aperçu | /v4beta/ |
| Expérimentation | /v4alpha/ |
- Consultez la documentation de référence sur REST pour obtenir la liste et la description de toutes les ressources REST disponibles.
- Pour en savoir plus sur chaque étape, consultez Étapes de lancement.
Fonctionnalités de l'API Geocoding v4
La version 4 de l'API Geocoding propose ces nouvelles fonctionnalités.
Méthode de recherche de destination
La v4 introduit une méthode de recherche de destination qui vous permet de récupérer des informations détaillées sur différentes destinations en fonction de différents critères d'entrée, tels qu'une adresse, un ID de lieu ou des coordonnées de latitude et de longitude. La réponse inclut des résumés optimisés par l'IA et des jetons de point de navigation contenant des informations contextuelles qui peuvent être transmises au SDK Navigation pour un itinéraire précis.
Implémenté sur la plate-forme Google Cloud standard
L'API Geocoding v4 est implémentée sur l'infrastructure de service sur Google Cloud. Cette implémentation s'accompagne d'une plate-forme plus sécurisée et fiable, avec des options de sécurité améliorées telles que OAuth. Cette conception d'API standard apporte un niveau de cohérence entre les API qui améliore l'efficacité du développement avec l'API Geocoding v4.
Ajout de la compatibilité avec OAuth
L'API Geocoding v4 est compatible avec l'utilisation d'OAuth 2.0 pour l'authentification. Google est compatible avec les scénarios OAuth 2.0 courants, tels que ceux d'un serveur Web.
Ajout de la compatibilité avec les masques de champ
Utilisez des masques de champ pour spécifier les informations que la réponse doit renvoyer. Pour les méthodes Geocode an address, Geocode a location et Place geocoding, tous les champs de l'objet de réponse sont renvoyés par défaut. Pour la méthode Rechercher des destinations, vous devez spécifier un masque de champ dans la requête API.
Sécurité des API
L'API Geocoding v4 est conçue comme une API de serveur à serveur. Les appels directs côté client depuis un navigateur exposent les clés API à un risque important de vol et d'utilisation abusive, car les restrictions de référents HTTP ne protègent pas suffisamment les points de terminaison de service Web.
Nous vous recommandons vivement d'appeler l'API Geocoding v4 depuis votre propre serveur backend. Pour en savoir plus sur les modèles de mise en œuvre sécurisés et les alternatives pour les besoins côté client, consultez Considérations de sécurité.