O roteamento de veículos grandes é um conjunto de propriedades que permite otimizar rotas de frotas para veículos grandes, especificando dimensões físicas, peso e número de reboques. A API usa esses atributos para calcular caminhos viáveis que evitam estradas restritas, pontes baixas ou rotas com limite de peso.
Com o roteamento de veículos grandes, é possível resolver desafios de logística de frotas para veículos pesados e grandes, por exemplo:
- Evitar riscos na estrada:gere planos de rota que afastam os veículos de folgas baixas, estradas com restrição de peso e outros riscos físicos.
- Especificar informações detalhadas do veículo:incorpore dimensões precisas, peso total, número de eixos e configurações de reboque em planos de rota para toda a frota.
- Melhorar o planejamento de toda a frota:crie planos de rota eficientes para toda a frota de caminhões, garantindo que todas as atribuições estejam em conformidade com as restrições físicas da estrada.
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 apenas nos 48 estados contíguos dos Estados Unidos.
- Avisos e segurança do motorista: os motoristas não devem confiar apenas nas rotas retornadas por essa API para serem seguras ou legais. Não há garantia de que as rotas sejam adequadas para o veículo, e segui-las pode expor os motoristas a riscos, como pontes baixas ou estradas em que veículos grandes são proibidos.
- Rotas de melhor esforço: em alguns casos, a API não consegue encontrar uma rota que esteja totalmente em conformidade com as restrições de viagem. Em vez disso, ela retorna uma rota de "melhor esforço" que ainda pode atravessar áreas restritas.
- Recursos não compatíveis: o roteamento de veículos grandes não oferece suporte a:
- Preços de pedágio de caminhão
- Limites de velocidade
- Roteamento de materiais perigosos radioativos
- Faturamento: o Google fatura todas as solicitações
optimizeToursde maneira uniforme, independentemente de as solicitações configurarem propriedades de roteamento de veículos grandes. - Rotas de longa distância:as rotas de caminhão de longa distância que abrangem 500 quilômetros ou mais exigem mais tempo de computação do que as rotas mais curtas e podem retornar dados de rota de qualidade inferior. Para manter a qualidade da rota, limite as distâncias entre os envios, os locais de partida e de destino do veículo. Se você precisar de rotas longas, aumente os prazos da solicitação para reduzir a probabilidade de erros
DEADLINE_EXCEEDED.
Propriedades
Para usar propriedades de roteamento de veículos grandes, é necessário configurar um veículo com as dimensões físicas e definir o modo de roteamento como caminhão.
A tabela a seguir lista as propriedades de nível superior para configurar o roteamento de veículos grandes:
| Propriedade | Tipo | Requisito | Descrição |
|---|---|---|---|
travelMode |
string | Obrigatório | Especifica o modo de viagem do veículo. Para ativar as propriedades de roteamento de veículos grandes, defina esse valor como TRUCK. |
routeModifiers |
objeto | Obrigatório | Contém configurações específicas da rota, incluindo vehicleInfo. |
vehicleInfo
O vehicleInfo objeto contém as especificações físicas do
veículo. Defina esse objeto na propriedade routeModifiers.
É necessário fornecer o objeto vehicleInfo se você definir
travelMode como TRUCK.
A tabela a seguir lista as propriedades disponíveis no vehicleInfo
objeto:
| Propriedade | Tipo | Requisito | Descrição |
|---|---|---|---|
totalHeightMm |
número inteiro | Obrigatório | Especifica a altura total do veículo em milímetros. O valor precisa ser um número inteiro positivo. |
totalWidthMm |
número inteiro | Obrigatório | Especifica a largura total do veículo em milímetros. O valor precisa ser um número inteiro positivo. |
totalWeightKg |
número inteiro | Obrigatório | Especifica o peso total do veículo em quilogramas. O valor precisa ser um número inteiro positivo. |
totalLengthMm |
número inteiro | Obrigatório | Especifica o comprimento total do veículo em milímetros. O valor precisa ser um número inteiro positivo. |
trailerInfo |
matriz | Opcional | Contém uma matriz de especificações de reboque, que inclui a propriedade lengthMm para especificar o comprimento de cada reboque individual em milímetros. |
totalAxleCount |
número inteiro | Obrigatório | Especifica o número total de eixos no veículo. O valor precisa ser um número inteiro maior ou igual a 2. |
Exemplos
Esta seção aborda dois tipos de exemplos:
- Exemplo de código que ilustra a estrutura do roteamento de veículos grandes.
- Um exemplo de solicitação que inclui o recurso.
Exemplo de código
O exemplo a seguir mostra a estrutura das propriedades usadas para o roteamento de veículos grandes:
"vehicles": [ { "travelMode": "TRUCK", "routeModifiers": { "vehicleInfo": { "totalHeightMm": TOTAL_HEIGHT_MM, "totalWidthMm": TOTAL_WIDTH_MM, "totalWeightKg": TOTAL_WEIGHT_KG, "totalLengthMm": TOTAL_LENGTH_MM, "trailerInfo": [ { "lengthMm": TRAILER_LENGTH_MM } ], "totalAxleCount": TOTAL_AXLE_COUNT } } } ]
Exemplo de solicitação
O exemplo a seguir mostra a estrutura de uma solicitação básica optimizeTours
que incorpora o roteamento de veículos grandes:
{ "model": { "shipments": [ { "pickups": [ { "arrivalLocation": { "latitude": 40.953523, "longitude": -72.2277846 } } ], "deliveries": [ { "arrivalLocation": { "latitude": 40.9546673, "longitude": -72.2580151 } } ] } ], "vehicles": [ { "travelMode": "TRUCK", "routeModifiers": { "vehicleInfo": { "totalHeightMm": 4000, "totalWidthMm": 2500, "totalWeightKg": 9000, "totalLengthMm": 20000, "trailerInfo": [ { "lengthMm": 15000 } ], "totalAxleCount": 5 } }, "costPerKilometer": 1.0 } ] } }