Wegpunkte verwalten

In diesem Dokument wird beschrieben, wie Sie Wegpunkt-Einstellungen für Ihre App mit zwei Funktionen verwalten können:

  • Einstellungen für die Straßenseite
  • Zwischenstopp

Einstellungen für die Straßenseite festlegen

Standardmäßig wird mit dem Navigation SDK für iOS die schnellste Route zu einem Wegpunkt ermittelt. Das bedeutet jedoch nicht, dass der Nutzer auf der gewünschten Straßenseite ankommt, z. B. auf der Straßenseite, auf der der Kunde eines Fahrdienstes wartet. Mit der Funktion Routing-Präferenz für Straßenseite können Sie dafür sorgen, dass das Fahrzeug auf der richtigen Straßenseite ankommt.

Funktionsweise

Sie legen die Einstellung für die Ankunft auf einer bestimmten Straßenseite fest, wenn Sie den Wegpunkt für diesen Stopp erstellen. Sie haben zwei Möglichkeiten, die Einstellung anzugeben.

Ich bevorzuge die gleiche Straßenseite

Sie geben die geografischen Koordinaten des Wegpunkts an und legen dann ein Flag preferSameSideOfRoad fest, das angibt, dass Sie lieber auf derselben Straßenseite wie der Wegpunkt ankommen möchten – ausgerichtet auf den nächstgelegenen Bürgersteig.

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

Ankunftsrichtung festlegen

Sie geben die geografischen Koordinaten des Wegpunkts und dann eine AnkunftsrichtungpreferredSegmentHeading an, die der Richtung des Verkehrsflusses auf derselben Straßenseite wie das Ziel entspricht.

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

Das Navigation SDK wählt das Straßensegment aus, das dem Wegpunkt am nächsten ist und dessen Fahrbahnrichtung (innerhalb von +/- 55 Grad) mit der Straßenseite übereinstimmt, auf der sich der Wegpunkt befindet.

Zwischenstopp-Einstellung festlegen

An bestimmten Orten ist es für Nutzer nicht möglich, sicher anzuhalten, z. B. auf erhöhten Flächen, auf Fähren, an unterirdischen Orten und an anderen Orten mit eingeschränktem Zugang. Mit der Funktion Zwischenstopp wird der Wegpunkt an einen Ort in der Nähe verschoben, wenn sein Standort für einen Zwischenstopp nicht geeignet ist. Wenn Sie vehicleStopover auf YES festlegen, wird der Wegpunkt automatisch verschoben, wenn die Route berechnet wird und ein alternativer Ort verfügbar ist.

Funktionsweise

Sie legen die Einstellung für einen Zwischenstopp fest, wenn Sie den Wegpunkt für diesen Stopp erstellen. Dazu legen Sie die Einstellung für einen Zwischenstopp in einem GMSNavigationMutableWaypoint fest, wie im folgenden Beispiel gezeigt:

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