Por que usar a API Directions
Com a API Directions, você pode ver rotas para vários modos de transporte, como transporte público, carro, a pé ou de bicicleta.
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, carro, a pé ou de bicicleta.
- Rotas em várias partes usando uma série de waypoints.
- Especifique origens, destinos e waypoints de várias maneiras, inclusive como strings de texto (por exemplo, "Chicago, IL" ou "Darwin, NT, Australia"), IDs de lugar ou coordenadas de latitude/longitude.
Como a API Directions funciona
A API Directions retorna os trajetos mais eficientes ao calcular as rotas. O produto considera os seguintes elementos de viagem para 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 pela API Directions e os dados retornados por ela.
Recursos de dados | Dados retornados | Formato de devolução |
---|---|---|
Directions
Informe 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. |
Rotas detalhadas, divididas em trajetos, trechos e etapas. Consulte mais detalhes em Respostas do Directions. |
|
Como usar a API Directions
1 | Prepare-se. | Comece com Configurar seu projeto do Google Cloud e conclua as instruções de configuração a seguir. |
2 | Experimente a demonstração | Depois de ter uma chave de API e um projeto na nuvem, você testa a demonstração das instruções sem custos financeiros. Consulte a demonstração da API Directions. |
3 | Criar uma solicitação | Confira os exemplos de solicitações e conheça as opções disponíveis que você pode oferecer, como modos de transporte, waypoints e restrições de trajeto. Consulte 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 no seu app. | Você pode usar esses dados para calcular a distância e o tempo do percurso. |
Bibliotecas de clientes disponíveis
Chame essa API na linguagem que preferir usando uma destas bibliotecas de cliente:
- Cliente Java para serviços do Google Maps (link em inglês)
- Cliente Python para serviços do Google Maps
- Cliente Go para serviços do Google Maps (em inglês)
- Cliente Node.js para serviços do Google Maps
Os clientes Java, Python, Go e Node.js para 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 deles no GitHub, onde também é possível encontrar instruções de instalação e exemplos de código.
A seguir
- Começar a usar a API Directions: acesse Começar.
- Começar a fazer solicitações do Directions: acesse Ver rotas.
- Siga as práticas recomendadas: acesse Práticas recomendadas para serviços da Web.