Roteamento para veículos grandes

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 optimizeTours de 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

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
      }
    ]
  }
}