Route planen

Hinweis: Die Änderungen an der Art und Weise, wie das Navigation SDK geplanten Routen folgt, einschließlich des neuen Felds betterRouteTimeTolerance, werden nach und nach eingeführt und sind bis zum 22. Oktober 2026 für alle Projekte verfügbar. Bis dahin werden Anfragen, die betterRouteTimeTolerance enthalten, von der Routes API möglicherweise abgelehnt.

Manchmal möchten Sie vielleicht die Route planen, die Ihre App den Nutzern vorschlägt. Mit einem Routentoken aus der Routes API, der Routes Preferred API oder der Route Optimization API können Sie zwei Dinge für Ihre geplante Route angeben:

• Eine Polylinie für die Route

• Ihre Routenziele

Hier sind einige Beispiele für Routingziele:

• Lieferzeit minimieren: Ein Unternehmen, das Lebensmittel liefert, möchte möglicherweise die Lieferzeit minimieren.

• Reisedauer oder Kraftstoffverbrauch minimieren: Ein Logistikunternehmen möchte die Effizienz seiner Fahrer verbessern und die Kraftstoffkosten senken.

• Zeit bis zum Ziel minimieren: Bei einem Service-Dispatch-Vorgang soll die Zeit minimiert werden, die Operatoren benötigen, um zu einem Auftrag zu gelangen.

• Kosten senken und Sicherheit verbessern: Ein Fahrdienstanbieter möchte möglicherweise eine Route finden, die für die Fahrgäste günstiger ist und aus Sicherheitsgründen bestimmte Bereiche meidet.

Wichtig :Die Route, die Fahrer nehmen, kann von der geplanten Route abweichen. Die Route kann sich während der Fahrt ändern, wenn sich die Verkehrs- oder Straßenverhältnisse ändern, das Fahrzeug die geplante Route verlässt oder zu einer schnelleren Route gewechselt wird. Wenn das Navigation SDK eine neue Route berechnet, werden die im Routentoken festgelegten Routingoptionen verwendet, z. B. das Vermeiden von Mautgebühren.

Weitere Informationen zum Planen einer Route mit einem Routentoken finden Sie unter Routentoken abrufen in der Routes API und unter Übergangspolylinien und Routentokens in der Route Optimization API.

Vorteile von Routentokens für Routenziele

Mit einem Routentoken aus der Routes API, der Routes Preferred API oder der Route Optimization API haben Sie mehr Kontrolle über die bereitgestellte Route:

• Planen Sie im Voraus eine Route, die im Navigation SDK verwendet werden soll.

• Wählen Sie die beste Route für das Navigation SDK aus. Wenn Sie beim Generieren von Routen in der Routes API Routen-Tokens anfordern, erhalten Sie für jede generierte Route ein Routen-Token. Sie können dann das Token für die Route auswählen, die Sie verwenden möchten, wenn Sie es an das Navigation SDK übergeben.

• Schätzen Sie den Preis im Voraus, einschließlich Schätzungen für die voraussichtliche Ankunftszeit und die Entfernung. Die tatsächlichen Kosten und die Zeit können zwar variieren, aber diese Schätzung verringert die Differenz zwischen den erwarteten und den tatsächlichen Routenkosten.

• Erweiterte Routenziele angeben, z. B. verbrauchsarme Routen oder die kürzeste Route.

Tipp: Ein Routentoken gilt für einen bestimmten Start- und Zielort und zu einer bestimmten Zeit. Sie müssen eine neue Routes API-, Routes Preferred API- oder Route Optimization API-Anfrage für ein neues Routentoken stellen.

Funktionsweise von Routentokens

Sie können die Routes API, die Routes Preferred API oder die Route Optimization API verwenden, um eine Route anhand von Routenzielen zu planen. Sie können ein von einer dieser APIs zurückgegebenes Routentoken an das Navigation SDK übergeben, um die Routenführung für Ihr Fahrzeug zu steuern.

Das passiert, wenn Sie ein Routentoken anfordern und verwenden:

1. Die Routes API, die Routes Preferred API oder die Route Optimization API gibt ein verschlüsseltes Routentoken zurück, das die Routenpolylinie und die Routenziele enthält.

2. Sie übergeben das Routentoken an das Navigation SDK.

3. Das Navigation SDK startet die Navigation auf der geplanten Route, auch wenn eine schnellere Route verfügbar ist.

4. Wenn sich während der Fahrt die Verkehrs- oder Straßenverhältnisse ändern oder das Fahrzeug die geplante Route verlässt, berechnet das Navigation SDK eine neue Route, die den Routenzielen und Routingoptionen in Ihrem Routentoken entspricht.

So wird die tatsächliche Route möglichst nah an der geplanten Route gehalten.

Warum eine geplante Route möglicherweise nicht genau eingehalten wird

Die Navigation beginnt auf der geplanten Route, die tatsächliche Route kann jedoch in folgenden Situationen davon abweichen:

• Das Fahrzeug startet nicht am geplanten Startpunkt.
• Die Verkehrs- oder Straßenverhältnisse ändern sich während der Fahrt.
• Das Fahrzeug verlässt die geplante Route.

Diese Unterschiede können sich auf die Entfernung, die voraussichtliche Ankunftszeit und andere wichtige Merkmale der Fahrt auswirken, die Sie geplant haben.

Tipp: Als Best Practice sollten Sie immer ein neues Routentoken anfordern, wenn Sie das Ziel im Navigation SDK festlegen. Planen Sie außerdem eine gewisse Abweichung ein, um Auswirkungen auf Ihr Unternehmen zu vermeiden.

Route mit einem Routentoken planen

Sie können eine Route planen, indem Sie ein Routentoken erstellen und es dann an das Navigation SDK übergeben. Gehen Sie dazu so vor:

Schritt 1: Routentoken mit der Routes API, Routes Preferred API oder Route Optimization API erstellen

1. Fordern Sie ein Routentoken an. Dazu haben Sie folgende Möglichkeiten:

   • Routes API: computeRoutes. Weitere Informationen zum Anfordern eines Routentokens in der Routes API finden Sie unter Route berechnen und Routentoken abrufen.

   • Routes Preferred API: computeCustomRoutes. Weitere Informationen zum Anfordern eines Routentokens in der Routes Preferred API finden Sie unter Route planen.

   • Route Optimization API: optimizeTours oder batchOptimizeTours. Weitere Informationen zum Anfordern eines Routentokens in der Route Optimization API finden Sie unter Übergangspolylinien und Routentokens.

2. Richten Sie Ihre Routes API- oder Routes Preferred API-Anfrage so ein, dass die Anforderungen für die Verwendung eines Routentokens erfüllt werden:

   • Legen Sie travelMode auf DRIVE oder TWO_WHEELER fest.
   • Legen Sie routingPreference auf TRAFFIC_AWARE oder TRAFFIC_AWARE_OPTIMAL fest.
   • Verwenden Sie keine Via-Wegpunkte.

Hinweis: Sie können in Ihrem Routentoken genaue Start- und Zielwerte wie Eingänge, Laderampen oder ausgewiesene Abholbereiche angeben, indem Sie ein Navigationspunkt-Token verwenden.

Schritt 2: Routentoken an das Navigation SDK übergeben

1. Routentoken speichern: Richten Sie im Navigation SDK einen String ein, um das Routentoken zu speichern. Beispiel:

   let routeToken = "route token returned by Routes API"
   

   Beispiel für ein zurückgegebenes Routentoken:

   {
   // Other fields
   "routeToken": "CqMBCjoKCJQOor5DHcwiEhBon3XpHXFnVvDeWMwd9PpAGgz6wtnFDKIBrAHTARpCApUDSggAAAAACjcrP3gBEAQaTApKChgKDQoCCAERAAAAAACAZkAR3SQGgZUXdUASEggAEAMQBhATEBIYAkIEGgIIBSIYChZ2VEJiWlBPSkk1aU5wUVRzNTV5d0FRKAEiFQBcJuds-Efh-2QZhOMTtUCCxEVL_g",
   }
   

2. Übergeben Sie das Routentoken mit mapView.navigator.setDestinations an das Navigation SDK. Geben Sie dieselben Zielwegpunkte an, die Sie beim Erstellen des Routentokens verwendet haben:

   mapView.navigator?.setDestinations([waypoint1, waypoint2], routeToken: routeToken, callback: {...})
   

   Hinweis: Wenn Sie dieselbe Route noch einmal fahren müssen, fordern Sie ein neues Routentoken an.

   Die Methode setDestinations übergibt den Status der Anfrage an ihren Callback. Wenn eine Route vom Standort des Nutzers zum angegebenen Ziel gefunden wird, lautet der Status .OK (GMSRouteStatusOK).

Szenarien mit mehreren Zwischenstopps

Sie können maximal 25 Wegpunkte konfigurieren.

Die Methode setDestinations unterstützt keine Fahrten mit mehreren Zwischenstopps. Verwenden Sie continueToNextDestinationWithCompletion(), um den Wegpunkt zum nächsten Abschnitt der Fahrt zu verschieben.

Achtung :Der Aufruf der Methode continueToNextDestinationWithCompletion() kann manchmal zu einem falschen Ankunftsereignis führen, bei dem das gerade erreichte Ziel noch einmal ausgewählt wird.

Beispiel

Die folgenden Codebeispiele zeigen, wie Sie eine geplante Route abrufen.

Swift

let location = CLLocationCoordinate2D(latitude: 47.67, longitude: -122.20)
let waypoint1 = GMSNavigationWaypoint(location: location, title: "waypoint from location")!
let waypoint2 = GMSNavigationWaypoint(placeID: "samplePlaceID", title: "waypoint from Place ID")!

let routeToken = "route token returned by Routes API"
mapView.navigator?.setDestinations([waypoint1, waypoint2], routeToken: routeToken, callback: {...})

Objective-C

CLLocationCoordinate2D location = CLLocationCoordinate2DMake(47.67, -122.20);
GMSNavigationWaypoint *waypoint1 = [[GMSNavigationWaypoint alloc] initWithLocation:location title:@"waypoint from location"];
GMSNavigationWaypoint *waypoint2 = [[GMSNavigationWaypoint alloc] initWithPlaceID:@"samplePlaceID"
                                                                            title:@"waypoint from Place ID"];
NSString *routeToken = @"route token returned by Routes API";

[mapView.navigator setDestinations:@[waypoint1, waypoint2]
                        routeToken:routeToken
                          callback:^(GMSRouteStatus routeStatus){...}];

Interaktion von Routentokens und dem Navigation SDK

So verarbeitet das Navigation SDK Ihre geplante Route:

• Überschreibt alle zuvor festgelegten Ziele.

• Verwendet den Startort des Fahrzeugs.

• Passt sich an die Straßen- und Verkehrslage an. Weitere Informationen finden Sie unter Warum eine geplante Route möglicherweise nicht genau eingehalten wird.

• Verwendet die in Ihrem Routentoken festgelegten Routingoptionen anstelle der folgenden Einstellungen in Ihrer App, auch wenn während der Fahrt eine neue Route berechnet wird:

  • avoidsHighways
  • avoidsTolls
  • avoidsFerries
  • licensePlateRestriction
  • Die in Ihrer App festgelegte Mobilitätsform

• Folgt diesen Einstellungen, wenn die Route berechnet oder angepasst wird:

  • Routenziele aus Ihrem Routentoken, z. B. die umweltfreundlichste oder die kürzeste Route. Wenn das Navigation SDK die Route anpassen muss, werden die Routenziele verwendet, die Sie beim Anfordern des Routentokens angegeben haben.

  • Wegpunktbezogene Optionen aus Ihrer App, z. B. die bevorzugte Straßenseite. Verwenden Sie dieselben Wegpunktoptionen, die Sie beim Anfordern des Routentokens angegeben haben.