Usar Python? Quer geocodificar algo? Procurando instruções? Talvez matrizes de direções? Esta biblioteca traz os serviços da Web da plataforma Google Maps para seu aplicativo Python.
O cliente Python para serviços do Google Maps é uma biblioteca cliente Python para as seguintes APIs do Google Maps:
Lembre-se de que os mesmos termos e condições se aplicam ao uso das APIs quando elas são acessadas por meio desta biblioteca.
Esta biblioteca é apoiada pela comunidade. Estamos suficientemente confortáveis com a estabilidade e os recursos da biblioteca e queremos que você crie aplicativos de produção reais nela. Tentaremos apoiar, através do Stack Overflow, a superfície pública e protegida da biblioteca e manter a compatibilidade com versões anteriores no futuro; entretanto, enquanto a biblioteca estiver na versão 0.x, nos reservamos o direito de fazer alterações incompatíveis com versões anteriores. Se removermos alguma funcionalidade (normalmente porque existe uma funcionalidade melhor ou se o recurso se mostrou inviável), nossa intenção é descontinuar e dar aos desenvolvedores um ano para atualizar seu código.
Se você encontrar um bug ou tiver uma sugestão de recurso, registre um problema. Se você gostaria de contribuir, leia contribuir.
Cada solicitação do serviço Web do Google Maps requer uma chave de API ou ID de cliente. As chaves de API são geradas na página "Credenciais" da guia "APIs e serviços" do console do Google Cloud.
Para obter ainda mais informações sobre como começar a usar a Plataforma Google Maps e gerar/restringir uma chave de API, consulte Primeiros passos com a Plataforma Google Maps em nossos documentos.
Importante: Esta chave deve ser mantida em segredo no seu servidor.
$ pip install -U googlemaps
Observe que você precisará de solicitações 2.4.0 ou superior se quiser especificar tempos limite de conexão/leitura.
Este exemplo usa a API Geocoding e a API Directions com uma chave de 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 )
Para mais exemplos de uso, confira os testes.
Tente novamente automaticamente quando ocorrerem falhas intermitentes. Ou seja, quando qualquer um dos erros 5xx recuperáveis é retornado da 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
Documentação para a biblioteca google-maps-services-python