Présentation de l'API Geocoding

Développeurs de l'Espace économique européen (EEE)

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éocodage pour une ou plusieurs adresses ou lieux, y compris les suivantes :

  • Coordonnées géographiques des adresses.
  • Adresses correspondant à des ensembles de coordonnées de latitude et de longitude.
  • Adresses pour les ID de 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é :

  • 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 de la vue.
  • Geocoding inversé : convertit des coordonnées de latitude/longitude ou un ID de lieu en une adresse lisible. Vous pouvez utiliser des adresses dans différents cas de figure, y compris pour des livraisons ou des retraits.

La démonstration suivante utilise le service Geocoding via l'API Maps JavaScript pour illustrer le fonctionnement de l'API Geocoding. Ouvrez la carte dans un onglet distinct pour afficher plus d'options et de détails.

Ressources

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 Résultats dans le guide Requête et réponse de géocodage.
  • JSON
  • XML
Geocoding inversé Renvoie l'adresse, les composants d'adresse et les types d'adresse. Consultez Réponses de geocoding inversé dans le guide des requêtes et réponses de geocoding inversé.
Geocoding d'un lieu Renvoie l'adresse, les composants d'adresse et les types d'adresse. Consultez Réponses de géocodage inversé dans le guide sur les requêtes et réponses de géocodage de lieux.

Utiliser l'API Geocoding

1 Configurez votre appareil. Commencez par configurer votre projet Google Cloud, puis suivez les instructions de configuration.
2 Envoyer une requête de géocodage Une fois que vous disposez d'une clé API, vous pouvez commencer à tester l'API Geocoding directement à partir de curl ou d'un navigateur. Vous devrez fournir les paramètres de recherche appropriés pour les recherches d'adresses ou de composants. Pour en savoir plus, consultez Paramètres de géocodage.
3 Envoyer une requête de geocoding inversé Fournissez les coordonnées de latitude et de longitude ainsi que votre clé API pour obtenir les composants d'adresse de l'adresse la plus proche et lisible pour cet emplacement. Pour en savoir plus, consultez Requêtes de géocoding inversé.
4 Comprendre les principes de base des réponses Tous les points de terminaison de l'API Geocoding renvoient les mêmes données au format JSON ou XML. Pour en savoir plus sur les données, les codes d'état et les messages d'erreur, consultez Réponses Geocoding.
5 Intégrez des données de géocodage dans votre propre application. Vous pouvez utiliser les données de géocodage pour obtenir des adresses à partir de repères sur une carte ou pour fournir des repères sur une carte en fonction d'une adresse connue.

Bibliothèques clientes disponibles

Appelez cette API dans le langage de votre choix à l'aide de l'une des bibliothèques clientes suivantes :

Les clients Java, Python, Go et Node.js pour les services Google Maps sont des bibliothèques clientes alimentées par la communauté, disponibles en Open Source sous la licence Apache 2.0. Téléchargez-les depuis GitHub, où vous trouverez également des instructions d'installation et un exemple de code.

Étape suivante