Wegpunkte verwalten

In diesem Dokument wird beschrieben, wie Sie Wegpunkteinstellungen für Ihre App mithilfe von zwei Funktionen verwalten können:

  • Einstellungen für die Straßenseite
  • Zwischenstopp

Straßenseite für Routenführung festlegen

Standardmäßig findet das Navigation SDK für iOS die schnellste Route zu einem Wegpunkt. Das garantiert jedoch nicht, dass der Nutzer auf der gewünschten Straßenseite ankommt, z. B. auf der Straßenseite, auf der der Kunde eines Mitfahrdienstes wartet. Mit der Funktion Routenpräferenz für die 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 Halt erstellen. Sie können die Einstellung auf zwei Arten festlegen.

Ich bevorzuge die gleiche Straßenseite

Sie geben die geografischen Koordinaten des Wegpunkts an und setzen dann das Flag preferSameSideOfRoad, um anzugeben, dass Sie auf derselben Straßenseite wie der Wegpunkt ankommen möchten, und zwar am nächstgelegenen Gehweg.

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

Ankunftskurs festlegen

Sie geben die geografischen Koordinaten des Wegpunkts und dann einen Ankunftskurs preferredSegmentHeading an, der 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 liegt und dessen Fahrspurrichtung (innerhalb von +/- 55 Grad) mit der Straßenseite übereinstimmt, auf der sich der Wegpunkt befindet.

Einstellung für Zwischenstopps festlegen

An bestimmten Orten ist es für Nutzer nicht möglich, sicher anzuhalten (z. B. auf erhöhten Bereichen, Fähren, unterirdischen Orten und anderen Bereichen mit eingeschränktem Zugang). Mit der Funktion Zwischenstopp wird der Wegpunkt an einen Ort in der Nähe verlegt, wenn der ursprüngliche Ort nicht für einen Zwischenstopp geeignet ist. Wenn Sie vehicleStopover auf YES setzen, wird der Wegpunkt bei der Routenberechnung automatisch verschoben, sofern ein alternativer Standort verfügbar ist.

Funktionsweise

Sie legen die Einstellung für einen Zwischenstopp fest, wenn Sie den Wegpunkt für diesen Zwischenstopp erstellen. Legen Sie dazu die Einstellung für einen Zwischenstopp auf einer 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){...}];