Gerenciar waypoints

Neste documento, descrevemos como gerenciar as preferências de pontos intermediários do seu app usando dois recursos:

  • Preferências de trajeto do lado da via
  • Escala

Definir a preferência de roteamento do lado da via

Por padrão, o SDK de navegação para iOS encontra o trajeto mais rápido até um ponto de referência, mas isso não garante que o usuário vai chegar ao lado desejado da via, por exemplo, o lado em que o cliente de um motorista de transporte por aplicativo está esperando. O recurso Preferência de trajeto 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.

Preferir o mesmo lado da via

Você fornece as coordenadas geográficas do waypoint e define uma flag preferSameSideOfRoad que indica que você prefere chegar no 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 ponto de referência e, em seguida, 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 SDK do Navigation escolhe o trecho da via mais próximo do ponto de passagem, que tem uma direção de faixa alinhada (dentro de +/- 55 graus) com o lado da via em que o ponto de passagem está.

Definir preferência de parada

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 referência para lugares por perto se o local não for adequado para uma parada. Quando você define vehicleStopover como YES, o waypoint é realocado automaticamente quando o trajeto é calculado, se houver um local alternativo disponível.

Como funciona

Defina a preferência de parada ao criar o waypoint para ela. Para fazer isso, defina a preferência de uma 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){...}];