Por que usar a API Routes
Com a API Routes, você pode receber informações precisas sobre rotas e viagens usando detalhes de transporte, condições atualizadas de trânsito e vias e preferências de rota:
Tipo e recursos de diferentes meios de transporte
A direção de um veículo
Lado da via para embarques ou desembarques
Condições de trânsito e vias interditadas
Preocupações de segurança, como evitar áreas perigosas ou oferecer áreas de embarque seguras
Equilibre latência, qualidade e custo de acordo com suas necessidades de trajeto com recursos opcionais, como pedágios e metadados de viagens, como tempo e distância, e eficiência de combustível
Também é possível determinar os trajetos mais eficientes para a programação de envios, como:
Qual é a melhor maneira de atribuir um conjunto de workers para selecionar uma série de pacotes
Determinar o melhor depósito para enviar pacotes ao destino final
O que você pode fazer com a API Routes?
Com a API Routes, você recebe duas categorias principais de informações de roteamento:
Trajetos de um local para um ou vários destinos
Uma matriz de rotas possíveis entre muitos locais de início e término.
Receber rotas para um ou vários destinos
Com o método Compute Routes
da API Routes,
é possível calcular entre locais:
Veja rotas para diferentes maneiras de viajar e para um único ou vários destinos:
Modos de transporte, incluindo transporte público, direção, veículos de duas rodas, caminhada ou bicicleta.
Uma série de pontos de passagem que podem ser otimizados para a ordem mais eficiente de viagem.
Várias maneiras de especificar origens, destinos e pontos de referência:
Strings de texto. Por exemplo: "Chicago, IL", "Darwin, NT, Australia", "1800 Amphitheatre Parkway, Mountain View, CA 94043" ou "CWF6+FWX Mountain View, California"
IDs de lugares
Coordenadas de latitude e longitude, opcionalmente com a direção do veículo
Ajuste as opções de trajeto com base nas suas necessidades e metas:
Selecione trajetos econômicos ou de baixo consumo de combustível para o tipo de motor do seu veículo: Diesel, Elétrico, Híbrido, Gasolina. Para mais informações, consulte Pegar um trajeto ecológico.
Defina opções refinadas para o cálculo de tráfego, permitindo tomar decisões de compensação entre qualidade e latência. Para mais detalhes, consulte Especificar como e se incluir dados de tráfego.
Defina as informações da direção do veículo (direção da viagem) e do lado da via para waypoints, aumentando a precisão do HEC. Para saber mais, consulte Especificar a direção e o lado da estrada do veículo.
Especifique os locais de passagem e de destino e os locais de parada segura. Para mais detalhes, consulte Definir uma parada ao longo de uma rota e Definir um ponto para uma rota passar.
Solicite informações sobre pedágios, distância do trajeto e HEC. Para mais detalhes, consulte Calcular taxas de pedágio para um trajeto.
Controle a latência e a qualidade solicitando apenas os dados necessários com uma máscara de campo. Isso ajuda a evitar tempo de processamento desnecessário e taxas de faturamento de solicitações mais altas. Para mais detalhes, consulte Escolher quais informações retornar.
Acessar uma matriz de rotas possíveis
O método Compute Route Matrix
da API Routes fornece uma matriz de informações sobre trajetos recomendados entre vários pontos de partida e chegada, incluindo distância e horários de chegada estimados, para ajudar você a escolher as melhores origens e destinos de acordo com as necessidades da sua empresa. É possível solicitar estes tipos de dados de distância:
Distância de um meio de transporte selecionado
Distância em quilômetros ou milhas
Tempo estimado de viagem no trânsito
Com os dados de distância, é possível determinar a maneira mais eficiente de rotear passageiros, remessas ou trabalhadores entre várias origens e destinos possíveis.
É possível transmitir elementos da resposta antes do cálculo da matriz inteira, reduzindo a latência da resposta.
É possível especificar várias origens e destinos por solicitação do lado do servidor com o número de origens vezes o número de destinos até 625.
Como a API Routes funciona
A API Routes tem dois métodos: ComputeRoutes
e ComputeRouteMatrix
.
ComputeRoutes
O método ComputeRoutes
da API Routes aceita uma solicitação POST HTTP com
um corpo de solicitação JSON que contém os detalhes da solicitação. Obrigatórios são origem, destino, TravelMode e uma máscara de campo para especificar quais campos retornar.
Exemplo
curl -X POST -d '{ "origin": { "address": "1800 Amphitheatre Parkway, Mountain View, CA 94043" }, "destination": { "address": "Sloat Blvd &, Upper Great Hwy, San Francisco, CA 94132" }, "travelMode": "DRIVE" }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \ -H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters' \ 'https://routes.googleapis.com/directions/v2:computeRoutes'
Em seguida, o serviço calcula a rota solicitada e retorna os campos que você solicitou.
ComputeRouteMatrix
A API Routes ComputeRouteMatrix
aceita uma solicitação POST HTTP com um corpo de solicitação JSON que contém os detalhes da solicitação. Obrigatórios pelo menos uma
origem, dois ou mais destinos, "travelMode" e uma máscara de campo para especificar quais
campos retornar.
Exemplo
curl -X POST -d '{ "origins": [ { "waypoint": { "location": { "latLng": { "latitude": 37.420761, "longitude": -122.081356 } } } }, { "waypoint": { "location": { "latLng": { "latitude": 37.403184, "longitude": -122.097371 } } } } ], "destinations": [ { "waypoint": { "location": { "latLng": { "latitude": 37.420999, "longitude": -122.086894 } } } }, { "waypoint": { "location": { "latLng": { "latitude": 37.383047, "longitude": -122.044651 } } } } ], "travelMode": "DRIVE" }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \ -H 'X-Goog-FieldMask: originIndex,destinationIndex,duration,distanceMeters,status,condition' \ 'https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix'
A resposta contém os trajetos possíveis para a combinação de todos os waypoints de origem e destino.
Recursos
A tabela a seguir resume os recursos disponíveis na API Routes e os dados retornados por ela.
Recursos de dados | Dados retornados | Formato de devolução |
---|---|---|
ComputeRoutes (link em inglês) | Retorna trajetos, trechos e etapas de um trajeto com rotas alternativas, se solicitado. | JSON |
ComputeRouteMatrix | Retorna uma matriz de trajetos de um waypoint de origem para um waypoint de destino. |
Como usar a API Routes
1 | Configuração | Comece em Configurar seu projeto do Google Cloud e siga as instruções de configuração a seguir. |
2 | Calcular uma rota e analisar a resposta | Para mais informações, consulte Ver uma rota e Analisar as respostas da rota. |
3 | Calcular a matriz de rotas e analisar a resposta | Para mais informações, consulte Acessar uma matriz de rotas e Analisar a resposta da matriz de rotas. |
Bibliotecas de clientes disponíveis
Veja uma lista das bibliotecas de cliente disponíveis para a API Routes em Bibliotecas de cliente.