Visão geral da API Directions

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

Por que usar a API Directions

Com a API Directions, você pode receber rotas para vários modos de transporte, como transporte público, carro, a pé ou bicicleta.

O que você pode fazer com a API Directions?

Com a API Directions, é possível calcular rotas entre locais, incluindo os seguintes detalhes:

  • Rotas para diversos modos de transporte, incluindo transporte público, carro, a pé ou bicicleta.
  • Rotas em várias partes usando uma série de pontos de referência.
  • Especifique origens, destinos e pontos de passagem de várias maneiras, incluindo como strings de texto (por exemplo, "Chicago, IL" ou "Darwin, NT, Austrália"), IDs de lugar ou coordenadas de latitude/longitude.

Como a API Directions funciona

A API Directions retorna as rotas mais eficientes ao calcular direções. O produto considera os seguintes elementos de viagem ao determinar a rota mais eficiente:

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

O exemplo de solicitação a seguir retorna uma rota de condução 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 na API Directions e os dados que ela retorna.

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

Forneça origens e destinos em forma de IDs de local, endereços ou coordenadas de latitude/longitude. Consulte Parâmetros obrigatórios para mais detalhes.

Indicações detalhadas, divididas em rotas, etapas e trajetos. Consulte Respostas de direções para mais detalhes.
  • JSON
  • XML

Como usar a API Directions

1 Configurar. Comece com Configurar seu projeto do Google Cloud e siga as instruções de configuração.
2 Testar a demonstração Depois de ter uma chave de API e um projeto na nuvem, teste a demonstração de direções sem custo financeiro. Consulte a demonstração da API Directions.
3 Criar uma solicitação Confira os exemplos de solicitações e saiba mais sobre as opções disponíveis que você pode fornecer, como meios de transporte, pontos de passagem e restrições de rota. Consulte Exemplos de rotas.
4 Noções básicas sobre respostas Analise as respostas de dados para se preparar para usar dados de trajetos no seu app. Consulte Respostas de trajetos para saber mais.
5 Incorpore dados de direção ao seu app. Você pode usar esses dados para calcular a distância e o tempo de percurso.

Bibliotecas de clientes disponíveis

Chame essa API no idioma de sua escolha usando uma das seguintes bibliotecas de cliente:

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

A seguir