Gerenciar waypoints

Este documento descreve como gerenciar as preferências de waypoint do seu app usando dois recursos:

  • Preferências de roteamento do lado da via
  • Parada

Definir a preferência de roteamento do lado da via

Por padrão, o Navigation SDK para iOS encontra o trajeto mais rápido para um waypoint. No entanto, isso não garante que o usuário chegue ao lado da via desejado, por exemplo, o lado da via em que o cliente de um motorista de aplicativo está esperando. O recurso Preferência de roteamento do lado da via permite garantir que o veículo chegue ao lado correto da via.

Como funciona

Você define a preferência de chegada em um lado específico da via ao criar o waypoint para essa parada. É possível especificar a preferência de duas maneiras.

Prefira o mesmo lado da via

Você fornece as coordenadas geográficas do waypoint e define um flag preferSameSideOfRoad que indica que você prefere chegar ao mesmo lado da via que o waypoint, ajustado à calçada mais próxima.

(nullable instancetype)initWithLocation:(CLLocationCoordinate2D)location
                                  title:(NSString *)title
                   preferSameSideOfRoad:(BOOL)preferSameSideOfRoad;

Definir uma direção de chegada

Você fornece as coordenadas geográficas do waypoint e uma direção de chegada preferredSegmentHeading que corresponde à direção do fluxo de tráfego no mesmo lado da via que o destino.

(nullable instancetype)initWithLocation:(CLLocationCoordinate2D)location
                                  title:(NSString *)title
                preferredSegmentHeading:(int32_t)preferredSegmentHeading;

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

Definir a preferência de parada

Em alguns lugares, não é possível que os usuários parem com segurança (por exemplo, áreas elevadas, balsas, locais subterrâneos e outras áreas de acesso limitado). O recurso Parada realoca o waypoint para um local próximo se a localização não for adequada para uma parada do usuário. Quando você define vehicleStopover como YES, o waypoint é realocado automaticamente quando o trajeto é calculado, se um local alternativo estiver disponível.

Como funciona

Você define a preferência de parada ao criar o waypoint para essa parada. Para fazer isso, defina a preferência de parada em um GMSNavigationMutableWaypoint, conforme mostrado no exemplo a seguir:

Swift

let location = CLLocationCoordinate2D(latitude: 47.67, longitude: -122.20)
let waypoint = GMSNavigationMutableWaypoint(location: location, title: "waypoint from location")!
waypoint.vehicleStopover = true
mapView.navigator?.setDestinations([waypoint], routingOptions: routingOptions, callback: {...})

Objective-C

CLLocationCoordinate2D location = CLLocationCoordinate2DMake(47.67, -122.20);
GMSNavigationMutableWaypoint *waypoint =
    [[GMSNavigationMutableWaypoint alloc] initWithLocation:location
                                                     title:@"waypoint from location"];
waypoint.vehicleStopover = YES;
[_mapView.navigator setDestinations:@[waypoint1]
                     routingOptions:routingOptions
                           callback:^(GMSRouteStatus routeStatus){...}];