O recurso roteamento de veículos grandes da API Routes calcula trajetos e horários de chegada estimados (HECs) para veículos grandes. Ele retorna trajetos otimizados que evitam restrições com base na altura, peso, comprimento e classificações de materiais perigosos do veículo. O serviço também gera um token de rota que pode ser transmitido ao SDK do 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 informados sobre o trânsito que permitam 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 do motorista | Oriente os motoristas em trajetos que evitem pontes baixas, estradas 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 a frota. Use o Fleet Engine para ativar a visibilidade em tempo real das atribuições e dos locais dos veículos. |
| Minimizar o treinamento e aumentar a adoção | Ofereça aos motoristas de veículos grandes ou caminhões a familiaridade da 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, você pode realizar as seguintes operações principais:
- Especifique propriedades detalhadas do veículo, incluindo altura, peso, comprimento, largura, número de eixos e classificações de mercadorias perigosas.
- Receba um trajeto, tempo de viagem e distância de viagem calculados especificamente para os atributos do veículo.
- Gere trajetos otimizados para manobrabilidade , evitando automaticamente retornos e preferindo rodovias e estradas interestaduais. Isso mantém veículos grandes em trajetos que atendem às necessidades e expectativas dos motoristas.
- Calcule um HEC mais preciso usando um modelo de HEC específico para caminhões. O modelo combina velocidades de viagem de caminhão observadas com informações de trânsito preditivas e em tempo real para fornecer estimativas mais precisas para veículos grandes.
- Ative a navegação passo a passo no SDK do Navigation usando um token de rota para transferir um trajeto seguro para caminhões da API Routes.
- Calcule matrizes de rotas para determinar tempos de viagem e 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 a eficiência operacional geral que considera a viabilidade e a segurança.
Como funciona o roteamento de veículos grandes
O recurso de roteamento de veículos grandes funciona nos 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 rota, uma lista de trechos e etapas de rota, o tempo de viagem estimado e um token de rota. |
| 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 rotas otimizado para a frota projetada para o veículo específico e tokens de rota para cada viagem. |
| SDK do Navigation (Android, iOS) | Inclua um token de rota (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 seguindo uma rota que adere às 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 tem esta aparência:
{
"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
vehicleInfo objeto 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 de rota, um HEC específico para caminhões, a distância de viagem e um token de rota para uso com o SDK do Navigation, dependendo do campo de máscara especificado. A resposta também indica se não é possível encontrar um trajeto totalmente compatível.
Conteúdo da solicitação e da 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.
| Conteúdo da solicitação | Conteúdo da resposta | Formato de retorno |
|---|---|---|
|
|
JSON |
Limitações
Antes de começar, você precisa 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 Japão (experimental). Ele não está disponível no Alasca, no Havaí ou nos territórios dos EUA.
- Avisos e segurança do motorista. Os motoristas não devem confiar apenas nos trajetos retornados por essa API para serem seguros ou legais. Não há garantia de que os trajetos sejam adequados para o veículo, e segui-los pode expor os motoristas a perigos, como pontes baixas ou estradas 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 esteja totalmente em conformidade com as restrições de viagem. Em vez disso, ele retorna um trajeto de "melhor esforço" que ainda pode atravessar áreas restritas. A resposta da API Routes sinaliza claramente esses trajetos no campo
routeRestrictionsPartiallyIgnored. Planeje seu trajeto com cuidado nesses casos, de preferência usando outros dados de origem. Não use um trajeto sinalizado como uma única fonte de verdade para planejamento ou navegação. - Recursos não compatíveis: o roteamento de veículos grandes não oferece suporte ao
seguinte:
- Preços de pedágio de caminhões
- Limites de velocidade
- Roteamento de materiais perigosos radioativos
- Limites de uso: todas as solicitações estão sujeitas a limites padrão de consultas por segundo (QPS).
Como usar o roteamento de veículos grandes
Siga estas etapas para usar o roteamento de veículos grandes com a API Routes:
- Configure seu projeto na nuvem:verifique se o projeto 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 grupo limitado de clientes. Entre em contato conosco para solicitar acesso e provisionar seu projeto para esse recurso.
- Crie uma solicitação:chame o endpoint
computeRoutesoucomputeRouteMatrixcomtravelModedefinido comoTRUCK, definaroutingPreferencecomoTRAFFIC_AWARE_OPTIMALe especifique os atributos do veículo usando o objetovehicleInfo. - Forneça navegação guiada (opcional): se você chamou
computeRoutes, transmita orouteTokenda resposta para o SDK do Navigation para iniciar uma sessão de navegação.
A seguir
- Começar: gere trajetos e HECs de caminhão com a API Routes
- Adicionar navegação: forneça navegação guiada com trajetos específicos para caminhões no SDK do Navigation para Android ou iOS