Visão geral da API Directions (legada)

Desenvolvedores do Espaço Econômico Europeu (EEE)

A API Directions (legada) é um serviço que aceita uma solicitação HTTP e retorna rotas entre locais no formato JSON ou XML.

Por que usar a API Directions (legada)

Com a API Directions (legada), você pode ver rotas para vários meios de transporte, como transporte público, carro, a pé ou bicicleta.

O que você pode fazer com a API Directions (legada)?

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

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

Como a API Directions (legada) funciona

A API Directions (legada) retorna as rotas mais eficientes ao calcular trajetos. O produto considera os seguintes elementos de viagem ao determinar o trajeto 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 na API Directions (legada) e os dados que ela retorna.

Recursos de dados Dados retornados Formato de retorno
Directions

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

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

Como usar a API Directions (legada)

1 Configure o recurso. Comece com Configurar seu projeto do Google Cloud e conclua as instruções de configuração a seguir.
2 Teste a demonstração Depois de ter uma chave de API e um projeto na nuvem, você pode testar a demonstração de rotas sem custo financeiro. Consulte a demonstração da API Directions (legada).
3 Criar uma solicitação Confira os exemplos de solicitações e saiba mais sobre as opções disponíveis, como meios de transporte, waypoints e restrições de trajeto. Confira exemplos de rotas.
4 Noções básicas sobre respostas Analise as respostas de dados para se preparar para usar os 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 a distância e o tempo de viagem.

Bibliotecas de clientes disponíveis

Chame essa API na linguagem de sua escolha por meio de uma das seguintes bibliotecas de cliente:

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. Faça o download delas no GitHub, onde você também encontra instruções de instalação e exemplos de código.

A seguir