Bibliothèques clientes pour les services Web Google Maps
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
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. Vous pouvez les télécharger et y contribuer sur GitHub, où vous trouverez également des instructions d'installation et un exemple de code :
Les clients Java, Python, Go et Node.js pour les services Google Maps vous permettent d'utiliser les services Web Google Maps sur votre serveur.
Ils englobent les fonctionnalités des API suivantes :
En plus des fonctionnalités fournies par ces API, les bibliothèques clientes simplifient certaines tâches courantes.
Limitation automatique du débit : par défaut, les requêtes sont envoyées avec la limitation de débit prévue pour chaque service Web. Vous pouvez spécifier des limites de RPS personnalisées avec new GeoApiContext().setQueryRateLimit(qps).
Nouvelle tentative en cas d'échec : les bibliothèques clientes relancent automatiquement toute requête si l'API envoie une erreur 5xx. Les nouvelles tentatives utilisent l'intervalle exponentiel entre les tentatives, qui facilite le processus en cas d'échecs intermittents.
POJO : les bibliothèques Java affichent des objets natifs pour chacune des réponses API. Les bibliothèques Python affichent la structure telle qu'elle est reçue par l'API.
Asynchrone ou synchrone : toutes les requêtes sont compatibles avec les styles d'appel synchrone ou asynchrone.
Conditions d'utilisation
Les bibliothèques clientes des services Web Google Maps sont disponibles sous la licence Apache 2.0.
Important : Ces bibliothèques ne sont pas régies par le règlement Google standard relatif aux abandons ni par le contrat d'assistance.
Clés API et ID client
Chaque service Web Google Maps nécessite une clé API ou un ID client. Pour savoir quand utiliser une clé API ou un ID client, et comment obtenir votre clé API ou votre ID client, consultez le guide sur l'authentification pour l'API utilisée :
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 2023/09/20 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2023/09/20 (UTC)."],[[["\u003cp\u003eCommunity-supported client libraries for Google Maps Services are available in Java, Python, Go, and Node.js, offering convenient access to various Google Maps APIs like Directions, Geocoding, and Places.\u003c/p\u003e\n"],["\u003cp\u003eThese open-source libraries, under the Apache 2.0 License, simplify development with features such as automatic rate limiting, retry mechanisms, and easy authentication.\u003c/p\u003e\n"],["\u003cp\u003eClient libraries provide synchronous and asynchronous calling styles while adhering to the Google Maps Platform Terms of Service.\u003c/p\u003e\n"],["\u003cp\u003eThey are not covered by Google's standard deprecation policy or support agreement and require an API key or client ID for usage, obtainable through API-specific authentication guides.\u003c/p\u003e\n"]]],["Community-supported Java, Python, Go, and Node.js client libraries for Google Maps Services are available on GitHub under the Apache 2.0 License. These clients wrap APIs like Address Validation, Directions, and Places, offering features such as automatic rate limiting, retry on failure, and easy authentication via API keys or client IDs. They facilitate server-side interaction with Google Maps web services. The libraries support both synchronous and asynchronous requests.\n"],null,["# Client Libraries for Google Maps Web Services\n\nThe Java Client, Python Client, Go Client and\nNode.js Client for Google Maps Services are community supported client libraries, open sourced under the\n[Apache 2.0 License](http://www.apache.org/licenses/LICENSE-2.0). They are\navailable for download and contributions on GitHub, where you will also find installation\ninstructions and sample code: \n\n- [Java Client for Google Maps Services](https://github.com/googlemaps/google-maps-services-java)\n- [Python Client for Google Maps Services](https://github.com/googlemaps/google-maps-services-python)\n- [Go Client for Google Maps Services](https://github.com/googlemaps/google-maps-services-go)\n- [Node.js Client for Google Maps Services](https://github.com/googlemaps/google-maps-services-js)\n\nWhy use the client libraries?\n-----------------------------\n\nThe Java Client, Python Client, Go Client\nand Node.js Client for Google Maps Services enable you to work with Google Maps web services on your server.\nThey wrap the functionality of the following APIs:\n\n- [Address Validation API](/maps/documentation/address-validation/overview)\n- [Directions API (Legacy)](/maps/documentation/directions/start)\n- [Distance Matrix API (Legacy)](/maps/documentation/distancematrix/start)\n- [Elevation API](/maps/documentation/elevation/start)\n- [Geocoding API](/maps/documentation/geocoding/start)\n- [Places API](/maps/documentation/places/web-service/overview)\n- [Roads API](/maps/documentation/roads/overview)\n- [Time Zone API](/maps/documentation/timezone/start)\n\nIn addition to the functionality provided by these APIs, the client libraries\nmake some common tasks a little easier.\n\n- **Automatic Rate Limiting** By default, requests are sent at the expected rate limit for each web service. You can provide custom QPM limits with `new GeoApiContext().setQueryRateLimit(qpm)`.\n- **Retry on Failure** The client libraries will automatically retry any request if the API sends a `5xx` error. Retries use exponential back-off, which helps in the event of intermittent failures.\n- **Easy Authentication** The client libraries make it easy to authenticate with your freely available API Key. [Google Maps Platform Premium Plan](/maps/premium) customers can use their [client ID and secret](/maps/premium/overview#client-id).\n- **POJOs** The Java libraries return native objects for each of the API responses. The Python libraries return the structure as it is received from the API.\n- **Asynchronous or synchronous** All requests support synchronous or asynchronous calling style.\n\nTerms and conditions\n--------------------\n\nThe client libraries for the Google Maps web services are licensed under the\n[Apache 2.0 License](http://www.apache.org/licenses/LICENSE-2.0).\n\nThe client libraries are wrappers for the Google Maps web services. The Google Maps\nweb services are governed by the [Google Maps Platform Terms of Service](https://cloud.google.com/maps-platform/terms).\n\n**Important** : These libraries are **not covered**\nby the standard Google deprecation policy or support agreement.\n\nAPI keys and client IDs\n-----------------------\n\nEach Google Maps web service requires an API key or client ID. For a guide on\nwhen to use an API key, when to use a client ID, and how to get hold of your\nAPI key or client ID, see the authentication guide for the API you're using:\n\n- [Address Validation API](/maps/documentation/address-validation/get-api-key)\n- [Directions API (Legacy)](/maps/documentation/directions/get-api-key)\n- [Distance Matrix API (Legacy)](/maps/documentation/distancematrix/get-api-key)\n- [Elevation API](/maps/documentation/elevation/get-api-key)\n- [Geocoding API](/maps/documentation/geocoding/get-api-key)\n- [Places API](/maps/documentation/places/web-service/get-api-key)\n- [Roads API](/maps/documentation/roads/get-api-key)\n- [Time Zone API](/maps/documentation/timezone/get-api-key)"]]
