Visão geral do roteamento de veículos grandes

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 trajeto que pode ser transmitido ao SDK do Navigation para fornecer navegação guiada.

Por que usar o trajeto 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.

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 um trajeto, tempo de viagem e distância calculados especificamente para os atributos do veículo.
• Gere rotas otimizadas para manobrabilidade, evitando automaticamente retornos e priorizando rodovias e estradas. Isso mantém os veículos grandes em rotas 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 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 guiada no SDK de navegação usando um token de trajeto 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 da sua frota de caminhões para melhorar a eficiência operacional geral, considerando a viabilidade e a segurança.

Como funciona o trajeto para veículos grandes

O recurso de roteamento de veículos grandes funciona com os seguintes serviços:

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 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 do trajeto, um HEC específico para caminhões, a distância do trajeto e um token de trajeto para uso com o SDK do Navigation, dependendo da máscara de campo especificada. A resposta também indica se não é possível encontrar uma rota totalmente compatível.

Conteúdo da solicitação e da resposta

A tabela a seguir lista os dados que você envia e recebe ao fazer uma solicitação de roteamento de veículos grandes usando o método computeRoutes da API Routes.

Limitações

Antes de começar, é preciso estar ciente das seguintes limitações e requisitos.

• Disponibilidade geográfica: o trajeto 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, no Havaí ou em territórios dos EUA.
• Avisos e segurança do motorista. Os motoristas não devem confiar apenas nas rotas retornadas por essa API para garantir a segurança ou a legalidade. 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 vias em que veículos grandes são proibidos.
• Rotas de melhor esforço. Em alguns casos, a API não consegue encontrar um trajeto que atenda totalmente às restrições de viagem. Em vez disso, ela retorna uma rota de "melhor esforço" que ainda pode atravessar á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 um trajeto sinalizado como única fonte de verdade para planejamento ou navegação.
• Recursos não compatíveis: o trajeto de 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 rotas para veículos grandes

Siga estas etapas para usar o roteamento de veículos grandes com a API Routes:

1. Configure seu projeto na nuvem: verifique se o projeto do Google Cloud foi criado e ativado para a API Routes.
2. 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.
3. Criar uma solicitação: chame o endpoint computeRoutes ou computeRouteMatrix com travelMode definido como TRUCK, defina routingPreference como TRAFFIC_AWARE_OPTIMAL e especifique os atributos do veículo usando o objeto vehicleInfo.
4. Fornecer navegação guiada (opcional): se você chamou computeRoutes, transmita o routeToken da resposta para o SDK de navegação para iniciar uma sessão de navegação.

A seguir

• Comece a usar: gere 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.