Gerenciar waypoints

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

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

Definir o lado da preferência de roteamento de estrada

Por padrão, o Navigation SDK para iOS encontra a rota mais rápida até um ponto de passagem. No entanto, isso não garante que o usuário chegue ao lado desejado da estrada, por exemplo, o lado da estrada em que o cliente de um motorista de transporte por aplicativo está esperando. O recurso Side of the Road Routing Preference permite que você garanta que o veículo chegue ao lado correto da via.

Como funciona

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

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

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

Importante: em algumas situações, quando o ponto de passagem é fixado ao lado da via mais próxima, ela pode não ser a correta. Por exemplo, pode ser uma rua ao virar a esquina de um cliente de transporte por aplicativo que está esperando. Para evitar isso, use preferredSegmentHeading em vez de preferSameSideOfRoad (confira detalhes na próxima seção).

Título do segmento preferencial

Você fornece as coordenadas geográficas do ponto de passagem e um caminho de chegada preferredSegmentHeading que corresponde à direção do fluxo de tráfego no mesmo lado da estrada que o destino.

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

O SDK de navegação escolhe o segmento de estrada mais próximo ao waypoint, que tem uma direção de faixa alinhada (dentro de +/- 55 graus) com o lado da estrada em que o waypoint 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 a localização dele não for adequada para o usuário fazer uma parada. Quando você define vehicleStopover como YES, o ponto de referência é 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, defina a preferência para uma escala em um GMSNavigationMutableWaypoint, conforme mostrado no exemplo abaixo:

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){...}];