Présentation de l'API Geocoding

L'API Geocoding est un service qui accepte un lieu en tant qu'adresse, coordonnées de latitude et longitude, ou 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.

Pourquoi utiliser l'API Geocoding ?

L'API Geocoding pour les sites Web ou les applications mobiles vous permet d'utiliser des données de geocoding dans des cartes fournies par l'une des API Google Maps Platform. Avec l'API Geocoding, vous pouvez utiliser des adresses pour placer des repères sur une carte ou pour les convertir en adresses. Ce service est conçu pour le geocoding d'adresses statiques prédéfinies afin de placer le contenu d'une application sur une carte.

Ce que vous pouvez faire avec l'API Geocoding

L'API Geocoding vous permet d'obtenir des données de geocoding pour un ou plusieurs lieux ou adresses, y compris les suivantes:

  • Coordonnées géographiques des adresses.
  • Adresses des ensembles de coordonnées de latitude et de longitude.
  • Adresses des ID de lieu.

Vous pouvez contrôler l'emplacement d'affichage des résultats et les limiter à une région, un comté ou un code postal en particulier.

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 de la vue.
  • Geocoding inversé: convertit des coordonnées de latitude/longitude ou un ID de lieu en adresse lisible. Vous pouvez utiliser des adresses pour diverses situations, 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 renvoyé
Geocoding Renvoie l'adresse, les composants d'adresse et les types d'adresse. Consultez la section Résultats du guide sur les requêtes et les réponses Geocoding.
  • JSON
  • XML
Geocoding inversé Renvoie l'adresse, les composants d'adresse et les types d'adresse. Consultez la section Réponses au geocoding inversé du guide Requêtes et réponses de geocoding inversé.
Geocoding de lieux Renvoie l'adresse, les composants d'adresse et les types d'adresse. Consultez la section Réponses du geocoding inversé du guide Requêtes et réponses de geocoding de lieu.

Utiliser l'API Geocoding

1 Configuration Commencez par Configurer votre projet Google Cloud, puis suivez les instructions de configuration.
2 Essayer une requête de geocoding 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 devez fournir les paramètres de recherche appropriés pour les recherches d'adresses ou de composants. Pour en savoir plus, consultez Paramètres de geocoding.
3 Essayer une requête de geocoding inversé Indiquez des coordonnées de latitude/longitude avec votre clé API afin d'obtenir les composants d'adresse de l'adresse lisible la plus proche de ce lieu. Pour en savoir plus, consultez Requêtes de geocoding 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 de geocoding.
5 Intégrez des données de geocoding dans votre propre application. Vous pouvez utiliser des données de geocoding pour obtenir des adresses à partir de repères sur la 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 via 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.

Étapes suivantes