Os clientes Java, Python, Go e Node.js dos serviços do Google Maps são bibliotecas de cliente apoiadas pela comunidade e que têm código aberto sob a Licença Apache 2.0. Eles estão disponíveis para download e contribuições no GitHub, onde você também encontrará instruções de instalação e exemplos de código:
- Cliente Java para serviços do Google Maps (em inglês)
- Cliente Python para serviços do Google Maps (em inglês)
- Cliente Go para serviços do Google Maps (em inglês)
- Cliente Node.js para serviços do Google Maps (em inglês)
Por que usar as bibliotecas de cliente?
Com os clientes Java, Python, Go e Node.js, você pode trabalhar com serviços da Web do Google Maps no seu servidor. Eles englobam os recursos das seguintes APIs:
- API Address Validation
- API Directions
- API Distance Matrix
- API Elevation
- API Geocoding
- API Places
- API Roads
- API Time Zone
Além dos recursos oferecidos por essas APIs, as bibliotecas de cliente facilitam algumas tarefas comuns.
- Limitação automática de taxa: por padrão, as solicitações são enviadas de acordo com a limitação de taxa esperada para cada serviço da Web. Você pode disponibilizar limites personalizados de QPS com
new GeoApiContext().setQueryRateLimit(qps). - Nova tentativa em caso de falha: as bibliotecas de cliente farão uma nova tentativa automaticamente para qualquer solicitação se a API retornar um erro
5xx. As novas tentativas usam uma retirada exponencial, o que é útil em caso de falhas intermitentes. - Autenticação fácil: com as bibliotecas de cliente, é fácil autenticar usando sua chave de API, disponibilizada sem custo financeiro. Os clientes do plano Premium da Plataforma Google Maps podem usar o ID do cliente e a chave secreta.
- POJOs: as bibliotecas Java retornam objetos nativos para cada resposta da API. As bibliotecas Python retornam a estrutura conforme ela é recebida da API.
- Assíncrono ou síncrono: todas as solicitações são compatíveis com estilos de chamada assíncronos ou síncronos.
Termos e Condições
As bibliotecas de cliente para os serviços da Web do Google Maps usam a Licença Apache 2.0.
As bibliotecas do cliente são wrappers dos serviços da Web do Google Maps. Esses serviços são regidos pelos Termos de Serviço da Plataforma Google Maps.
Importante: essas bibliotecas não são cobertas pela política padrão de suspensão de uso nem pelo contrato de suporte do Google.
Chaves de API e IDs do cliente
Cada serviço da Web do Google Maps requer uma chave de API ou um ID de cliente. Para saber quando usar uma chave de API ou um ID do cliente e como conseguir esses identificadores, consulte o guia de autenticação da API que você está usando: