Gestisci tappe

Questo documento descrive come gestire le preferenze dei punti di riferimento per la tua app utilizzando due funzionalità:

  • Preferenze di routing sul lato della strada
  • Vieni a trovarci a

Imposta la preferenza di routing sul lato della strada

Per impostazione predefinita, Navigation SDK for iOS trova il percorso più rapido per un punto di riferimento, ma ciò non garantisce che l'utente arrivi sul lato della strada desiderato, ad esempio il lato della strada su cui attende il cliente di un autista di ridesharing. La funzionalità Preferenza di routing sul lato della strada ti consente di assicurarti che il veicolo arrivi sul lato corretto della strada.

Come funziona

Imposta la preferenza per l'arrivo su un determinato lato della strada quando crei il punto di riferimento per la fermata. Puoi specificare la preferenza in uno dei due modi seguenti.

Preferisci lo stesso lato della strada

Fornisci le coordinate geografiche del punto di riferimento, quindi imposta un flag preferSameSideOfRoad che indica che preferisci arrivare sullo stesso lato della strada del punto di riferimento, agganciato al marciapiede più vicino.

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

Imposta una direzione di arrivo

Fornisci le coordinate geografiche del waypoint, quindi fornisci un orientamento di arrivo preferredSegmentHeading che corrisponda alla direzione del flusso di traffico sullo stesso lato della strada della destinazione.

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

Navigation SDK sceglie il segmento stradale più vicino al punto di riferimento, che ha una direzione di corsia allineata (entro +/- 55 gradi) con il lato della strada su cui si trova il punto di riferimento.

Imposta la preferenza di sosta

In alcuni luoghi, gli utenti non possono fermarsi in sicurezza (ad esempio, aree sopraelevate, traghetti, luoghi sotterranei e altre aree ad accesso limitato). La funzionalità Vieni a trovarci a sposta il punto di riferimento in un luogo vicino se la sua posizione non è adatta a una sosta dell'utente. Se imposti vehicleStopover su YES, il punto di riferimento viene spostato automaticamente quando viene calcolato il percorso, se è disponibile una posizione alternativa.

Come funziona

Imposta la preferenza per una sosta quando crei il punto di riferimento per la fermata. Per farlo, imposta la preferenza per una sosta su un GMSNavigationMutableWaypoint come mostrato nell'esempio seguente:

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