Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Développeurs situés dans l'Espace économique européen (EEE)
L'API Geocoding est un service qui accepte un lieu sous la forme d'une adresse, de coordonnées de latitude et de longitude ou d'un ID de lieu. Il convertit l'adresse en coordonnées de latitude et de longitude, ou en identifiant de lieu, ou convertit des coordonnées de latitude et de longitude ou un identifiant 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 géocodage dans les 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 convertir un repère sur une carte en adresse. Ce service est conçu pour géocoder des adresses statiques prédéfinies afin de placer le contenu de l'application sur une carte.
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 suivants:
Coordonnées géographiques des adresses.
Adresses pour des ensembles de coordonnées de latitude et de longitude.
Adresses des ID de lieu.
Vous pouvez contrôler les zones de diffusion des résultats et les limiter à une région, un comté ou un code postal spécifiques.
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 frame de vue.
Geocoding inversé: convertit des coordonnées de latitude/longitude ou un ID de lieu en 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 montrer comment fonctionne 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.
Renvoie l'adresse, les composants d'adresse et les types d'adresse. Consultez la section Réponses au géocodage inversé dans le guide des requêtes et réponses de géocodage inversé.
Renvoie l'adresse, les composants d'adresse et les types d'adresse. Consultez la section Réponses au géocodage inversé dans le guide des requêtes et réponses de géocodage de lieu.
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'adresses ou de composants. Pour en savoir plus, consultez la section Paramètres de géocodage.
3
Envoyer une requête de géocodage inversé
Fournissez les coordonnées de latitude/longitude ainsi que votre clé API pour obtenir les composants d'adresse de l'adresse lisible la plus proche pour cet emplacement.
Pour en savoir plus, consultez la section Demandes de géocodage 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 Geocoding.
5
Intégrez des données de géocodage à votre propre application.
Vous pouvez utiliser des données de géocodage pour obtenir des adresses à partir de repères de carte ou pour fournir des repères sur une carte en fonction d'une adresse connue.
Bibliothèques clientes disponibles
Appelez cette API dans la langue 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 sur GitHub, où vous trouverez également des instructions d'installation et un exemple de code.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/31 (UTC).
[null,null,["Dernière mise à jour le 2025/08/31 (UTC)."],[[["\u003cp\u003eThe Geocoding API converts addresses into geographic coordinates (latitude and longitude) and vice versa.\u003c/p\u003e\n"],["\u003cp\u003eThis API is ideal for placing markers on maps based on addresses and retrieving addresses from map locations for static content, not dynamic user input.\u003c/p\u003e\n"],["\u003cp\u003eYou can use the Geocoding API to find geographic coordinates for addresses, addresses for coordinates, and addresses for Place IDs.\u003c/p\u003e\n"],["\u003cp\u003eThe API supports both geocoding (address to coordinates) and reverse geocoding (coordinates to address).\u003c/p\u003e\n"],["\u003cp\u003eClient libraries are available in Java, Python, Go, and Node.js for easy integration into your applications.\u003c/p\u003e\n"]]],[],null,["**European Economic Area (EEA) developers** If your billing address is in the European Economic Area, effective on 8 July 2025, the [Google Maps Platform EEA Terms of Service](https://cloud.google.com/terms/maps-platform/eea) will apply to your use of the Services. Functionality varies by region. [Learn more](/maps/comms/eea/faq). \n\nThe Geocoding API is a service that accepts a place as an\naddress, latitude and longitude coordinates, or Place ID. It converts the\naddress into latitude and longitude coordinates and a Place ID, or converts\nlatitude and longitude coordinates or a Place ID into an address.\n| **Note** : If you only want plus codes and don't want to use an API key, you can use the [Plus codes API](https://github.com/google/open-location-code/tree/main/Documentation).\n\nWhy use the Geocoding API\n\nUse the Geocoding API for website or mobile application when you want to use\ngeocoding data within maps provided by one of the Google Maps Platform APIs.\nWith the Geocoding API, you use addresses to place markers on a map, or\nconvert a marker on a map to an address. This service is designed for geocoding\n**predefined, static addresses** for placement of application\ncontent on a map.\n| This service is **not** designed to respond directly to user\n| input. To do dynamic geocoding, for example, in a user interface, see the\n| [Maps JavaScript API\n| client geocoder](/maps/documentation/javascript/geocoding) and/or the\n| [Google Play services Location APIs](https://developer.android.com/google/play-services/location.html).\n\nWhat you can do with the Geocoding API\n\nYou can use the Geocoding API to obtain geocoding data for one or more addresses or\nplaces, including the following:\n\n- Geographic coordinates for addresses.\n- Addresses for sets of latitude and longitude coordinates.\n- Addresses for place IDs.\n\nYou can control where the results appear and constrain the results to a particular region,\ncounty, or postal code.\n\nHow the Geocoding API works\n\nThe Geocoding API does both geocoding and reverse geocoding:\n\n- [**Geocoding**](/maps/documentation/geocoding/requests-geocoding): Converts addresses such as \"1600 Amphitheatre Parkway, Mountain View, CA\" into latitude and longitude coordinates or Place IDs. You can use these coordinates to place markers on a map, or to center or reposition the map within the view frame.\n- [**Reverse geocoding**](/maps/documentation/geocoding/requests-reverse-geocoding): Converts latitude/longitude coordinates or a Place ID into a human-readable address. You can use addresses for a variety of scenarios, including deliveries or pickups.\n\nThe following demo uses the Geocoding Service through the Maps JavaScript API\nto demonstrate how the Geocoding API works. Open the map in a separate tab\nto see more options and details.\n\nResources\n\nThe following table summarizes the resources available through the\nGeocoding API along with the data each endpoint returns.\n\n| Data resources | Data returned | Return format |\n|-------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------|\n| [Geocoding](/maps/documentation/geocoding/requests-geocoding) | Returns address, address components, and address types. See [Results](/maps/documentation/geocoding/requests-geocoding#results) in the *Geocoding request and response* guide. | - JSON - XML |\n| [Reverse geocoding](/maps/documentation/geocoding/requests-reverse-geocoding) | Returns address, address components, and address types. See [Reverse geocoding responses](/maps/documentation/geocoding/requests-reverse-geocoding#reverse-response) in the Reverse geocoding request and response guide. | - JSON - XML |\n| [Place geocoding](/maps/documentation/geocoding/requests-places-geocoding) | Returns address, address components, and address types. See [Reverse geocoding responses](/maps/documentation/geocoding/requests-places-geocoding) in the Place geocoding request and response guide. | - JSON - XML |\n| - JSON - XML |\n\nHow to use the Geocoding API\n\n|---|---------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| 1 | **Get set up.** | Start with [Set up your Google Cloud project](/maps/documentation/geocoding/cloud-setup) and complete the setup instructions that follow. |\n| 2 | **Try a geocoding request** | Once you have an API key, you can start testing out the Geocoding API directly from curl or a browser. You'll need to supply the correct lookup parameters for address or component lookups. See [Geocoding parameters](/maps/documentation/geocoding/requests-geocoding#geocoding-lookup) for details. |\n| 3 | **Try a reverse geocoding request** | Supply latitude/longitude coordinates along with your API key to obtain address components for the closest human-readable address for that location. See [Reverse geocoding requests](/maps/documentation/geocoding/requests-reverse-geocoding#reverse-requests) for details. |\n| 4 | **Understand response basics** | All endpoints in the Geocoding API return the same data in either JSON or XML. See [Geocoding responses](/maps/documentation/geocoding/requests-geocoding#GeocodingResponses) for an explanation of the data, status codes, and error messages. |\n| 5 | **Incorporate geocoding data into your own app!** | You can use geocoding data to obtain addresses from map markers or to supply markers on a map based on a known address. |\n\nAvailable client libraries\n\nCall this API in the language of\nyour choice through one of the following client libraries:\n\n- [Java\n Client for Google Maps Services](https://github.com/googlemaps/google-maps-services-java)\n- [Python\n Client for Google Maps Services](https://github.com/googlemaps/google-maps-services-python)\n- [Go Client\n for Google Maps Services](https://github.com/googlemaps/google-maps-services-go)\n- [Node.js\n Client for Google Maps Services](https://github.com/googlemaps/google-maps-services-js)\n\nThe Java Client, Python Client, Go Client and Node.js Client for Google Maps\nServices are community-supported client libraries, open sourced under the\n[Apache 2.0 License](http://www.apache.org/licenses/LICENSE-2.0).\nDownload them from GitHub, where you can also find installation instructions and sample code.\n\nWhat's next\n\n- **Start using the Geocoding API** : Go to [Set up your\n Google Cloud project](/maps/documentation/geocoding/cloud-setup).\n- **Get started with sample requests and responses** : Go to [Geocoding requests and responses](/maps/documentation/geocoding/requests-geocoding)\n- **Follow best practices** : Go to [Geocoding Addresses Best\n Practices](/maps/documentation/geocoding/best-practices)."]]
