Vous utilisez Python ? Vous voulez géocoder quelque chose ? Vous cherchez un itinéraire ? Peut-être des matrices de directions ? Cette bibliothèque apporte les services Web de Google Maps Platform à votre application Python.
Le client Python pour les services Google Maps est une bibliothèque client Python pour les API Google Maps suivantes :
Gardez à l’esprit que les mêmes termes et conditions s’appliquent à l’utilisation des API lorsqu’elles sont accessibles via cette bibliothèque.
Cette bibliothèque est prise en charge par la communauté. Nous sommes suffisamment à l'aise avec la stabilité et les fonctionnalités de la bibliothèque pour que nous souhaitions que vous y construisiez de véritables applications de production. Nous essaierons de prendre en charge, via Stack Overflow, la surface publique et protégée de la bibliothèque et de maintenir la rétrocompatibilité à l'avenir ; cependant, tant que la bibliothèque est en version 0.x, nous nous réservons le droit d'apporter des modifications rétrocompatibles. Si nous supprimons certaines fonctionnalités (généralement parce qu'une meilleure fonctionnalité existe ou si la fonctionnalité s'est avérée irréalisable), notre intention est de la rendre obsolète et de donner aux développeurs un an pour mettre à jour leur code.
Si vous trouvez un bug ou avez une suggestion de fonctionnalité, veuillez enregistrer un problème. Si vous souhaitez contribuer, veuillez lire contribuer.
Chaque demande de service Web Google Maps nécessite une clé API ou un identifiant client. Les clés API sont générées sur la page "Identifiants" de l'onglet "API et services" de la console Google Cloud.
Pour plus d'informations sur la prise en main de Google Maps Platform et la génération/restreinte d'une clé API, consultez la section Premiers pas avec Google Maps Platform dans nos documents.
Important : Cette clé doit rester secrète sur votre serveur.
$ pip install -U googlemaps
Notez que vous aurez besoin des requêtes 2.4.0 ou supérieures si vous souhaitez spécifier des délais d'attente de connexion/lecture.
Cet exemple utilise l'API Geocoding et l'API Directions avec une clé API :
import googlemaps
from datetime import datetime
gmaps = googlemaps . Client ( key = 'Add Your Key here' )
# Geocoding an address
geocode_result = gmaps . geocode ( '1600 Amphitheatre Parkway, Mountain View, CA' )
# Look up an address with reverse geocoding
reverse_geocode_result = gmaps . reverse_geocode (( 40.714224 , - 73.961452 ))
# Request directions via public transit
now = datetime . now ()
directions_result = gmaps . directions ( "Sydney Town Hall" ,
"Parramatta, NSW" ,
mode = "transit" ,
departure_time = now )
# Validate an address with address validation
addressvalidation_result = gmaps . addressvalidation ([ '1600 Amphitheatre Pk' ],
regionCode = 'US' ,
locality = 'Mountain View' ,
enableUspsCass = True )
# Get an Address Descriptor of a location in the reverse geocoding response
address_descriptor_result = gmaps . reverse_geocode (( 40.714224 , - 73.961452 ), enable_address_descriptor = True )
Pour plus d’exemples d’utilisation, consultez les tests.
Réessayez automatiquement en cas de pannes intermittentes. C'est-à-dire lorsque l'une des erreurs 5xx récupérables est renvoyée par l'API.
# Installing nox
$ pip install nox
# Running tests
$ nox
# Generating documentation
$ nox -e docs
# Copy docs to gh-pages
$ nox -e docs && mv docs/_build/html generated_docs && git clean -Xdi && git checkout gh-pages
Documentation pour la bibliothèque google-maps-services-python