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.
Ce que vous pouvez faire avec l'API Geocoding
Vous pouvez utiliser l'API Geocoding pour obtenir des données de geocoding pour une ou plusieurs adresses ou lieux, y compris les suivants :
Cette version de l'API Geocoding v4 inclut les points de terminaison suivants :
- Géocoder une adresse : coordonnées géographiques des adresses. Également appelé géocodage direct.
- Géocoder un lieu : adresses pour des ensembles de coordonnées de latitude et de longitude. On parle également de geocoding inversé.
- Géocodage de lieu : récupérez une adresse à partir d'un ID de lieu.
- Rechercher des destinations : recherchez une destination à partir d'une adresse, d'un ID de lieu ou d'un emplacement.
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 effectue à la fois le geocoding et le geocoding inversé :
- Geocoding : convertit des 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 d'affichage.
- Geocoding inversé : convertit des coordonnées de latitude et de longitude ou un ID de lieu en adresse lisible par l'humain. Vous pouvez utiliser des adresses pour différents scénarios, y compris les livraisons ou les retraits.
Le tableau suivant récapitule les ressources disponibles via l'API Geocoding, ainsi que les données renvoyées par chaque méthode.
| 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 geocoding inversé. | |
| Géocodage de lieux | Renvoie l'adresse, les composants d'adresse et les types d'adresse. Consultez la documentation sur la réponse de géocodage de lieu. | |
| Recherche de destination | Renvoie 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. Consultez la documentation sur la recherche de destination. |
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é.