Gerenciar waypoints

Por padrão, o SDK de navegação para Android encontra a rota mais rápida até um ponto de passagem. No entanto, isso não garante que o veículo chegue do lado da estrada em que o consumidor está esperando ou que o local de chegada seja seguro para o motorista parar. Este guia descreve dois recursos que você pode usar para essas situações:

  • Preferência de rota do lado da estrada
  • Recurso de escala

Lado da preferência de roteamento

Com esse recurso, você garante que o veículo chegue ao lado correto da estrada. Você define a preferência para chegar em um lado específico da estrada ao criar o ponto de passagem para essa parada. É possível especificar a preferência de duas maneiras: preferir o mesmo lado da estrada ou fornecer uma direção de chegada.

Preferir o mesmo lado da via

Você fornece as coordenadas geográficas do ponto de passagem e define uma flag (setPreferSameSideOfRoad) que indica que você prefere chegar no mesmo lado da estrada que o ponto de passagem, fixado na calçada mais próxima.

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

Definir um título de chegada

Você fornece as coordenadas geográficas do ponto de passagem e, em seguida, um cabeçalho de chegada (setPreferredHeading) que corresponde à direção do fluxo de tráfego no mesmo lado da via do consumidor que está esperando.

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

O SDK de navegação escolhe o segmento de estrada mais próximo ao ponto de referência, que tem uma direção de faixa alinhada (dentro de +/- 55 graus) com o lado da estrada em que o ponto de referência está.

Definir a preferência de escala

Em alguns lugares, não é possível parar com segurança (por exemplo, áreas elevadas, balsas, locais subterrâneos e outras áreas de acesso limitado). O recurso Parada realoca o ponto de passagem para um lugar próximo se o local não for adequado para um veículo fazer uma parada. Quando você define setVehicleStopover como true, o ponto de passagem é realocado automaticamente quando a rota é calculada, se um local alternativo estiver disponível.

Como funciona

Você define a preferência para uma escala ao criar o ponto de passagem 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()