O recurso de trajeto para veículos grandes da API Routes calcula rotas e horários previstos de chegada (ETAs) para veículos grandes. Ela retorna rotas otimizadas que evitam restrições com base na altura, no peso, no comprimento e nas classificações de materiais perigosos do veículo. O serviço também gera um token de rota que pode ser transmitido ao SDK Navigation para fornecer navegação guiada.
Por que usar o roteamento de veículos grandes
Use o roteamento de veículos grandes para criar aplicativos que resolvam desafios de logística para frotas de veículos grandes.
| Benefício | Descrição |
|---|---|
| Melhorar a precisão de preços e planejamento | Gere HECs específicos e com informações de trânsito que permitem cotações e janelas de entrega mais precisas para veículos grandes, como caminhões e ônibus. |
| Melhorar a segurança e a eficiência dos motoristas | Guiar os motoristas por trajetos que evitam pontes baixas, vias com restrição de peso e outros perigos. |
| Simplificar as operações em toda a frota | Use a otimização de rotas com o roteamento de veículos grandes para otimizar as atribuições de carga e a ordem de paradas de toda uma frota. Use o Fleet Engine para permitir a visibilidade em tempo real das atribuições e localizações dos veículos. |
| Minimizar o treinamento e aumentar a adoção | Ofereça aos motoristas de caminhões ou veículos grandes a experiência de navegação do Google Maps no seu próprio aplicativo. |
O que você pode fazer com o roteamento de veículos grandes
Com o roteamento de veículos grandes, é possível realizar as seguintes operações principais:
- Especifique propriedades detalhadas do veículo, incluindo altura, peso, comprimento, largura, contagem de eixos e classificações de mercadorias perigosas.
- Receba uma rota, o tempo de viagem e a distância de viagem calculados especificamente para os atributos do veículo.
- Gere trajetos otimizados para manobrabilidade evitando automaticamente retornos e preferindo rodovias estaduais e federais. Assim, os veículos grandes ficam em rotas que atendem às necessidades e expectativas dos motoristas.
- Calcular um HEC mais preciso usando um modelo específico para caminhões. O modelo combina as velocidades de viagem observadas de caminhões com dados de trânsito em tempo real e preditivos para fornecer estimativas mais precisas para veículos grandes.
- Ative a navegação curva a curva no SDK Navigation usando um token de rota para transferir um trajeto seguro para caminhões da API Routes.
- Calcule matrizes de rotas para determinar os tempos de viagem e as distâncias entre várias origens e destinos para o planejamento de toda a frota.
- Otimize o plano de rotas para sua frota de caminhões para melhorar a eficiência operacional geral, considerando a viabilidade e a segurança.
Como funciona a roteirização para veículos grandes
O recurso de rotas para veículos grandes funciona com os seguintes serviços:
| Endpoint | Operação | Saída |
|---|---|---|
| API Routes | Uma solicitação HTTPS para um endpoint de API da API Routes (computeRoutes ou computeRouteMatrix) com um corpo de solicitação que inclui sua origem e destino. O travelMode precisa ser definido como TRUCK, e o objeto routeModifiers precisa incluir o vehicleInfo.
|
Uma polilinha de trajeto, uma lista de trechos e etapas, o tempo estimado de viagem e um token de trajeto. |
| API Route Optimization | Uma solicitação HTTPS para o endpoint de API Route Optimization. O travelMode precisa ser definido como TRUCK, e o objeto routeModifiers precisa incluir o vehicleInfo.
|
Um plano de rota otimizado para a frota, projetado para o veículo específico, e tokens de rota para cada viagem. |
| SDK de navegação (Android, iOS) | Inclua um token de trajeto (gerado pela API Routes ou pela API Route Optimization com o roteamento de veículos grandes) ao definir destinos no navegador. | Experiência de navegação guiada personalizada para caminhões e que segue uma rota de acordo com as informações do veículo especificadas na solicitação de API original da API Routes ou da API Route Optimization. |
Exemplo
O exemplo a seguir se concentra no uso do roteamento de veículos grandes com a API Routes.
Por exemplo, um corpo de solicitação computeRoutes básico é assim:
{
"origin": { "location": { "latLng": { "latitude": 41.31, "longitude": -74.75 }}},
"destination": { "location": { "latLng": { "latitude": 41.30, "longitude": -74.78 }}},
"travelMode": "TRUCK",
"routeModifiers": {
"vehicleInfo": {
"totalHeightMm": 4114,
"totalLengthMm": 21945,
"totalWeightKg": 32658,
... // other vehicle attributes
}
}
}
Obrigatório: sua solicitação precisa definir o travelMode como TRUCK e preencher o objeto vehicleInfo com as dimensões e os atributos específicos do veículo.
A API Routes retorna um trajeto que considera as informações especificadas do veículo. A resposta pode incluir a polilinha da rota, uma estimativa de chegada específica para caminhões, distância de viagem e um token de rota para uso com o SDK Navigation, dependendo da máscara de campo especificada. A resposta também indica se uma rota totalmente compatível não pode ser encontrada.
Conteúdo de solicitação e resposta
A tabela a seguir lista os dados enviados e recebidos ao fazer uma solicitação de roteamento de veículos grandes usando o método computeRoutes da API Routes.
| Solicitar conteúdo | Conteúdo da resposta | Formato de retorno |
|---|---|---|
|
|
JSON |
Limitações
Antes de começar, é preciso estar ciente das seguintes limitações e requisitos.
- Disponibilidade geográfica: o roteamento de veículos grandes está disponível nos 48 estados contíguos dos Estados Unidos (disponibilidade geral) e no Japão (experimental). Ele não está disponível no Alasca, Havaí ou territórios dos EUA.
- Avisos e segurança para motoristas. Os motoristas não podem confiar apenas nas rotas retornadas por essa API para garantir a segurança ou a legalidade. As rotas não são garantidas como adequadas para o veículo, e segui-las pode expor os motoristas a perigos, como pontes baixas ou vias em que veículos grandes são proibidos.
- Trajetos de melhor esforço. Em alguns casos, a API não consegue encontrar um trajeto que
obedeça totalmente às restrições de viagem. Em vez disso, ele retorna uma rota de "melhor esforço" que ainda pode passar por áreas restritas. A resposta da API Routes sinaliza claramente essas rotas no campo
routeRestrictionsPartiallyIgnored. Nesses casos, planeje seu trajeto com cuidado, de preferência usando outros dados de origem. Não use uma rota sinalizada como única fonte de verdade para planejamento ou navegação. - Recursos não compatíveis: o trajeto para veículos grandes não é compatível com o seguinte:
- Preços de pedágio para caminhões
- Limites de velocidade
- Rotas para materiais radioativos perigosos
- Limites de uso:todas as solicitações estão sujeitas aos limites padrão de consultas por segundo (QPS).
Como usar o trajeto para veículos grandes
Siga estas etapas para usar o roteamento de veículos grandes com a API Routes:
- Configure seu projeto:verifique se o projeto na nuvem do Google Cloud foi criado e ativado para a API Routes.
- Provisionamento para roteamento de veículos grandes:o roteamento de veículos grandes está disponível para um conjunto limitado de clientes. Entre em contato conosco para solicitar acesso e provisionar seu projeto para esse recurso.
- Criar uma solicitação:chame o endpoint
computeRoutesoucomputeRouteMatrixcomtravelModedefinido comoTRUCK, definaroutingPreferencecomoTRAFFIC_AWARE_OPTIMALe especifique os atributos do veículo usando o objetovehicleInfo. - Fornecer navegação guiada (opcional): se você chamou
computeRoutes, transmita orouteTokenda resposta para o SDK de navegação para iniciar uma sessão de navegação.
A seguir
- Começar: gerar rotas de caminhão e HECs com a API Routes
- Adicionar navegação: ofereça navegação guiada com rotas específicas para caminhões no SDK do Navigation para Android ou iOS.