Visão geral da API Directions

A API Directions é um serviço que aceita uma solicitação HTTP e retorna Rotas entre locais em formato JSON ou XML.

Por que usar a API Directions

Com a Directions API, você pode obter rotas para diversos modos de transporte, como transporte público, carro, bicicleta ou a pé.

O que você pode fazer com a API Directions?

Com a API Directions, você pode calcular rotas entre locais, incluindo os seguintes detalhes:

  • Rotas para vários modos de transporte, incluindo transporte público, condução, a pé ou de bicicleta.
  • Rotas de várias partes usando uma série de waypoints.
  • Especificar origens, destinos e waypoints de várias maneiras, incluindo como strings de texto (por exemplo, "Chicago, IL" ou "Darwin, NT, Australia"), coloque ou coordenadas de latitude/longitude.

Como a API Directions funciona

A API Directions retorna os trajetos mais eficientes quando calculando direções. Os fatores de produto dos seguintes elementos de viagem ao determinar a rota mais eficiente:

  • Tempo de viagem (principal)
  • Distância
  • Número de curvas

O exemplo de solicitação a seguir retorna rotas de carro de Toronto, Ontário, para Montreal, Quebec, no formato JSON:

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Montreal
  &origin=Toronto
  &key=YOUR_API_KEY

Recursos

A tabela a seguir resume os recursos disponíveis no Directions API junto com os dados retornados.

Recursos de dados Dados retornados Formato de devolução
Directions

Informe origens e destinos na forma de IDs de lugar, endereços, coordenadas de latitude/longitude. Veja os parâmetros obrigatórios para mais detalhes.

Rotas detalhadas, divididas em trajetos, trechos e etapas. Consulte Respostas de rotas para mais detalhes.
  • JSON
  • XML

Como usar a API Directions

1 Prepare-se. Comece com a etapa Configurar seu projeto do Google Cloud e conclua a configuração as instruções a seguir.
2 Veja a demonstração Depois de criar uma chave de API e um projeto na nuvem, a demonstração do Directions sem custos financeiros. Consulte a demonstração da API Directions.
3 Criar uma solicitação Veja os exemplos de solicitações e saiba mais sobre as solicitações opções que você pode fornecer, como meios de transporte, waypoints e restrições de trajeto. Consulte os exemplos de rotas.
4 Noções básicas sobre respostas Explore as respostas de dados e se prepare para usar dados de rotas no seu app. Consulte Respostas de rotas para mais detalhes.
5 Incorpore dados de rotas ao seu app. Você pode usar esses dados para calcular o tempo e a distância do percurso.

Bibliotecas de clientes disponíveis

Chame essa API no idioma do sua escolha por meio de uma das seguintes bibliotecas de cliente:

Os clientes Java, Python, Go e Node.js para Google Maps Os serviços são bibliotecas-cliente com suporte da comunidade, com código aberto de acordo com a Licença Apache 2.0. Faça o download deles no GitHub, onde também é possível encontrar instruções de instalação e exemplos de código.

A seguir