L'API Geocoding est un service qui accepte un lieu en tant qu'adresse, coordonnées de latitude et longitude, ou ID de lieu. Elle convertit l'adresse en coordonnées de latitude et longitude et en un 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
Utilisez l'API Geocoding pour un site Web ou une application mobile lorsque vous souhaitez utiliser des données de geocoding dans des cartes fournies par l'une des API Google Maps Platform. Avec l'API Geocoding, vous utilisez des adresses pour placer des repères sur une carte ou pour convertir un repère sur une carte en adresse. Ce service est conçu pour géocoder des adresses statiques prédéfinies pour placer le contenu d'une application sur une carte.
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 éléments suivants:
- Des coordonnées géographiques pour les adresses.
- Adresses pour 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 restreindre à une région, un pays ou un code postal spécifique.
Fonctionnement de l'API Geocoding
L'API Geocoding effectue à la fois un geocoding et un 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 les coordonnées de latitude/longitude ou un ID de lieu en une adresse lisible. Vous pouvez utiliser des adresses pour différents scénarios, y compris les livraisons ou les 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 autre onglet pour afficher plus d'options et d'informations.
Ressources
Le tableau suivant récapitule les ressources disponibles via l'API Geocoding et 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 Requête et réponse Geocoding. |
|
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ête et réponse de geocoding inversé. | |
Geocoding de lieu | Renvoie l'adresse, les composants d'adresse et les types d'adresse. Consultez la section Réponses au geocoding inversé du guide Demander un geocoding et placer la réponse. |
Utiliser l'API Geocoding
1 | Configuration | Commencez par configurer votre projet Google Cloud, puis suivez les instructions de configuration ci-dessous. |
2 | Essayer une requête de geocoding | Une fois que vous disposez d'une clé API, vous pouvez commencer à tester l'API Geocoding directement depuis cURL ou un navigateur. Vous devez fournir les paramètres de recherche appropriés pour les recherches d'adresse ou de composants. Pour en savoir plus, consultez Paramètres de geocoding. |
3 | Essayer une requête de geocoding inversé | Indiquez les coordonnées de latitude/longitude avec votre clé API afin d'obtenir les composants d'adresse pour l'adresse lisible la plus proche de cet établissement. Pour en savoir plus, consultez la section Demandes 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 la section Réponses au geocoding. |
5 | Intégrez des données de geocoding à votre propre application ! | Vous pouvez utiliser les 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:
- Client Java pour les services Google Maps
- Client Python pour les services Google Maps
- Client Go pour les services Google Maps
- Client Node.js pour les services Google Maps
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 sur GitHub, où vous trouverez également des instructions d'installation et un exemple de code.
Étapes suivantes
- Pour commencer à utiliser l'API Geocoding: consultez Configurer votre projet Google Cloud.
- Premiers pas avec les exemples de requêtes et de réponses: consultez la section Requêtes et réponses de geocoding.
- Suivez les bonnes pratiques: consultez les bonnes pratiques concernant le geocoding pour les adresses.