Por que usar a API Routes
Com a API Routes, você pode receber informações precisas sobre a viagem e trajetos usando detalhes de transporte, condições atualizadas de trânsito e vias e preferências de trajeto:
Tipo e recursos dos 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 custos 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 as rotas mais eficientes para a programação de despachos, como:
Qual é a melhor maneira de atribuir um conjunto de workers para selecionar uma série de pacotes
Determinar o melhor armazém de onde enviar pacotes para o 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 possíveis trajetos entre muitos locais de partida e chegada.
Ver rotas para um ou vários destinos
Com o método Compute Routes
da API Routes, você pode 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, condução, veículos de duas rodas, caminhada ou bicicleta.
Uma série de waypoints que podem ser otimizados para a ordem mais eficiente de deslocamento.
Várias maneiras de especificar origens, destinos e waypoints:
Strings de texto. Por exemplo: "Chicago, IL", "Darwin, NT, Australia", "1800 Amphitheatre Parkway, Mountain View, CA 94043" ou "CWF6+FWX Mountain View, Califórnia".
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 para o tipo de motor do seu veículo: a diesel, elétrico, híbrido, gasolina. Para mais informações, consulte Escolher 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 mais detalhes, consulte Especificar a direção do veículo e o lado da via.
Especifique locais de passagem em comparação com terminais e locais seguros de parada. Para mais detalhes, consulte Definir uma parada em um trajeto e Definir o ponto de passagem de um trajeto.
Solicite informações sobre pedágios, a distância do trajeto e o 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.
Conseguir 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. Você pode 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 com 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.
Você pode especificar várias origens e destinos por solicitação do lado do servidor, com até 625 o número de origens vezes o número de destinos.
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 o trajeto solicitado e retorna os campos solicitados.
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. Os campos obrigatórios, pelo menos uma
origem, dois ou mais destinos, "travelMode" e uma máscara de campo para especificar quais
campos retornar, são obrigatórios.
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 | 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.