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. Elle 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.
Fonctionnalités de l'API Geocoding
Vous pouvez utiliser l'API Geocoding pour obtenir des données de géocoding pour une ou plusieurs adresses ou lieux, y compris les éléments suivants :
Cette version de l'API Geocoding v4 inclut les points de terminaison suivants :
- (Aperçu) Géocoder une adresse : coordonnées géographiques des adresses. Également appelé géocodage direct.
- (Aperçu) Géocoder un lieu : adresses pour des ensembles de coordonnées de latitude et de longitude. Également appelé geocoding inversé.
- (Preview) Geocoding de lieux : récupérez une adresse à partir d'un ID de lieu.
- (Aperçu) Rechercher des destinations : recherchez une destination à partir d'une adresse, d'un ID de lieu ou d'un lieu.
Vous pouvez contrôler l'emplacement des résultats et les limiter à une région, un département ou un code postal spécifiques.
Fonctionnement de l'API Geocoding
L'API Geocoding permet d'effectuer à la fois le geocoding et le geocoding inversé :
- Géocodage : convertit les adresses telles que "1600 Amphitheatre Parkway, Mountain View, CA" en coordonnées de latitude et de longitude ou en ID de lieu. Vous pouvez utiliser ces coordonnées pour placer des repères sur une carte, ou pour centrer ou repositionner la carte dans le cadre de la vue.
- Geocoding inversé : convertit des coordonnées de latitude et de longitude ou un ID de lieu en adresse lisible. Vous pouvez utiliser des adresses dans différents cas, y compris pour des livraisons ou des retraits.
Le tableau suivant récapitule les ressources disponibles via l'API Geocoding, ainsi que les données renvoyées par chaque point de terminaison.
| Ressources de données | Données renvoyées | Format de retour |
|---|---|---|
| Geocoding | Renvoie l'adresse, les composants d'adresse et les types d'adresse. Consultez la documentation sur la réponse de géocodage. |
|
| Geocoding inversé | Renvoie l'adresse, les composants d'adresse et les types d'adresse. Consultez la documentation sur la réponse de géocoding inversé. | |
| Geocoding d'un lieu | Renvoie l'adresse, les composants d'adresse et les types d'adresse. Consultez la documentation sur la réponse au géocodage de lieux. | |
| Recherche de destination | Renvoie des informations détaillées sur différentes destinations en fonction de différents critères de saisie, tels qu'une adresse, un ID de lieu ou des coordonnées de latitude et de longitude. Consultez la documentation sur la recherche de destinations. |
Fonctionnalités de l'API Geocoding v4
La version 4 de l'API Geocoding propose ces nouvelles fonctionnalités.
Point de terminaison de recherche de destination
La version 4 introduit un point de terminaison Destination Search 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 points de navigation qui contiennent des informations contextuelles pouvant être transmises au SDK Navigation pour un routage précis.
Implémenté sur la plate-forme standard Google Cloud
L'API Geocoding v4 est implémentée sur l'infrastructure de service sur Google Cloud. Cette implémentation permet de bénéficier 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 certain niveau de cohérence entre les API, ce 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 accepte les scénarios courants OAuth 2.0, tels que ceux relatifs à 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 points de terminaison Géocoder une adresse, Géocoder un lieu et Géocodage de lieux, tous les champs de l'objet de réponse sont renvoyés par défaut. Pour le point de terminaison Rechercher des destinations, vous devez spécifier un masque de champ dans la requête API.
Aucuns frais d'utilisation pendant la version Preview
L'API Geocoding v4 est en phase de preview avant sa disponibilité générale. Son utilisation est sans frais pendant cette phase. Les appels d'API s'affichent sur la page "Facturation" de la console Cloud, mais les frais sont de 0 $.
Commentaires
Il s'agit d'une fonctionnalité en version Preview. Nous vous invitons à nous faire part de vos commentaires à l'adresse geocoding-feedback-channel@google.com.