Wegpunkte verwalten

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

  • Einstellungen für das Straßenrand-Routing
  • Zwischenstopp

Einstellung für die Straßenseite festlegen

Standardmäßig ermittelt das Navigations-SDK für iOS die schnellste Route zu einem Wegpunkt. Es kann jedoch nicht garantiert werden, dass der Nutzer auf der gewünschten Straßenseite ankommt, z. B. auf der Seite, auf der der Kunde eines Fahrdienstleisters wartet. Mit der Funktion Routing-Bevorzugung 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 an einer bestimmten Straßenseite fest, wenn Sie den Wegpunkt für diese Haltestelle erstellen. Sie haben zwei Möglichkeiten, die Einstellung festzulegen.

Bevorzugung derselben Straßenseite

Sie geben die geografischen Koordinaten des Wegpunkts an und setzen dann ein Flag preferSameSideOfRoad, das angibt, dass Sie am liebsten auf derselben Straßenseite wie der Wegpunkt ankommen möchten – angedockt am nächsten Bürgersteig.

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

Bevorzugte Segmentüberschrift

Geben Sie die geografischen Koordinaten des Wegpunkts und dann eine Ankunftsrichtung an, preferredSegmentHeading die der Verkehrsflussrichtung auf derselben Straßenseite wie das Ziel entspricht.

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

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

Einstellung für Zwischenstopp festlegen

An bestimmten Orten können Nutzer nicht sicher anhalten, z. B. auf erhöhten Flächen, auf Fähren, in U-Bahnstationen 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 bei der Routenberechnung automatisch verschoben, sofern ein alternativer Ort 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){...}];