Gerenciar waypoints

Por padrão, o SDK do Navigation para Android encontra o trajeto mais rápido até um waypoint. No entanto, isso não garante que o veículo chegará no lado da via que o consumidor está esperando ou que o local de chegada é seguro para o motorista. Neste guia, descrevemos dois recursos que podem ser usados nessas situações:

  • Lado da preferência de trajeto da via
  • Recurso de parada

Lado da preferência de trajeto do trajeto

Com esse recurso, você garante que o veículo chegue no lado certo da via. Você define a preferência de chegada em um lado específico da via ao criar o waypoint dessa parada. Há duas maneiras de fazer isso: prefira o mesmo lado da via ou defina um destino de chegada.

Preferir o mesmo lado da via

Você fornece as coordenadas geográficas do waypoint e, em seguida, define uma sinalização (setPreferSameSideOfRoad) indicando que prefere chegar no mesmo lado da via que o waypoint, alinhado à calçada mais próxima.

Waypoint waypoint =
   Waypoint.builder()
           .setLatLng(latitude, longitude)
           .setTitle("Somewhere in Sydney")
           .setPreferSameSideOfRoad(true)
           .build()

Definir uma direção de chegada

Forneça as coordenadas geográficas do waypoint e uma direção de chegada (setPreferredHeading) que corresponda à direção do fluxo de trânsito no mesmo lado da via que o consumidor em espera.

Waypoint waypoint =
   Waypoint.builder()
           .setLatLng(latitude, longitude)
           .setTitle("Somewhere in Sydney")
           .setPreferredHeading(preferredHeading)
           .build()

O SDK do Navigation escolhe o trecho de via mais próximo do waypoint, que tem uma direção de faixa alinhada (dentro de +/- 55 graus) à lateral da via em que o waypoint está.

Definir preferência de escala

Em alguns lugares, os motoristas não podem parar com segurança (por exemplo, em áreas elevadas, balsas, locais subterrâneos e outras áreas de acesso limitado). O recurso Parada realoca o waypoint para um lugar próximo se o local não for adequado para que um veículo faça uma parada. Se você definir setVehicleStopover como true, o waypoint será automaticamente realocado quando o trajeto for calculado, se um local alternativo estiver disponível.

Como funciona

Você define a preferência de uma parada ao criar o ponto de referência dela. Para fazer isso, especifique a preferência setVehicleStopover, conforme mostrado no exemplo abaixo:

Waypoint waypoint =
   Waypoint.builder()
           .setLatLng(latitude, longitude)
           .setTitle("Somewhere in Sydney")
           .setVehicleStopover(true)
           .build()