Routen für große Fahrzeuge

Hinweis:Das Routing für große Fahrzeuge ist nur für eine begrenzte Anzahl von Kunden verfügbar. Wenn Sie Interesse haben, kontaktieren Sie uns.

Für wen ist diese Anleitung gedacht? Diese Anleitung richtet sich an mobile Entwickler, die für die Entwicklung der detaillierten Navigation für Fahrer von Lkw, Bussen oder anderen großen Nutzfahrzeugen verantwortlich sind.

Inhalt dieser Anleitung:In dieser Anleitung wird erklärt, wie Sie eine lkw-spezifische Route verwenden, die von der Routes API oder der Route Optimization API generiert wurde, um eine detaillierte Routenführungssitzung mit dem Navigation SDK for iOS zu starten.

Lerninhalte

Sie erfahren, wie Sie folgende Aufgaben ausführen:

• routeToken verwenden, um die Backend-Routenplanung mit der In-App-Navigation zu verbinden.
• Das Navigation SDK konfigurieren , um eine vorab geplante Lkw-Route zu verwenden.
• Verstehen, wie lkw-spezifische Einschränkungen dem Fahrer in der Navigationsoberfläche angezeigt werden.

Vorbereitung

Bevor Sie beginnen, müssen Sie die folgenden Anforderungen erfüllen:

1. Zugriff für Ihr Projekt anfordern

Das Routing für große Fahrzeuge ist nur für eine begrenzte Anzahl von Kunden verfügbar. Wenn Sie Interesse haben und Zugriff für Ihr Google Cloud-Projekt anfordern möchten, füllen Sie das Kontaktformular aus. Ein Google-Mitarbeiter wird sich mit den nächsten Schritten bei Ihnen melden.

Sobald Google Zugriff gewährt hat, muss Ihr Google Cloud-Projekt für das Routing für große Fahrzeuge bereitgestellt werden.

Wenn Ihre Organisation separate Google Cloud-Projekte für die Backend-Routing-APIs und das mobile Navigation SDK verwendet, wenden Sie sich an Google, um jedes Projekt bereitzustellen.

2. Backend-Routengenerierung einrichten und Routentoken abrufen

Bevor die Navigation auf dem Gerät gestartet wird, muss Ihr Backend-Server eine Lkw-Route generieren und ein routeToken mit einer der folgenden APIs abrufen:

• Routes API: Empfohlen für die Berechnung einzelner Lkw-Routen zwischen Start- und Zielorten. Eine Anleitung zur Einrichtung finden Sie unter Routen und voraussichtliche Ankunftszeiten für große Fahrzeuge generieren.
• Route Optimization API: Empfohlen für die Optimierung von Routen mit mehreren Haltepunkten für eine Flotte. Weitere Informationen finden Sie in der Anleitung zum Routing für große Fahrzeuge mit der Route Optimization API.

In Ihrer Backend-Anfrage muss travelMode: TRUCK zusammen mit den physischen Attributen des Fahrzeugs (Höhe, Breite, Länge, Gewicht, Anzahl der Achsen und Gefahrgut) angegeben werden. Die Routing-API gibt in ihrer Antwort ein routeToken zurück, das Ihr Backend-Server an Ihre mobile App weiterleitet.

3. Mindestanforderungen an SDK und System erfüllen

Ihre App muss mindestens die erforderliche Version 5.4.0 des Navigation SDK verwenden.

Außerdem muss Ihr Projekt die Standardanforderungen für die Einrichtung des Navigation SDK erfüllen.

Einschränkungen und Betriebsrichtlinien

Beachten Sie vor Beginn die folgenden Einschränkungen und Betriebsrichtlinien:

• Geografische Verfügbarkeit: Das Routing für große Fahrzeuge ist in den zusammenhängenden 48 US-Bundesstaaten (allgemein verfügbar) und Japan (Testphase) verfügbar. In Alaska, Hawaii und US-Territorien ist es nicht verfügbar.
• Fahrerhinweise und Sicherheit: Fahrer dürfen sich nicht ausschließlich auf Routen verlassen, die vom Navigation SDK zurückgegeben werden, um sicher oder legal zu sein. Routen sind möglicherweise nicht für das Fahrzeug unter allen Straßenbedingungen geeignet und können Fahrer Gefahren aussetzen, z. B. niedrigen Durchfahrthöhen oder Straßen mit Gewichtsbeschränkungen. Fahrer müssen immer aufmerksam sein und die Verkehrsschilder und lokalen Vorschriften beachten.
• Best-Effort-Routen: Wenn die Routing-API keine Route findet, die vollständig den Fahrzeugbeschränkungen entspricht, wird eine „Best-Effort“-Route zurückgegeben, die möglicherweise trotzdem eingeschränkte Abschnitte durchläuft. Die Routes API legt beispielsweise das Flag routeRestrictionsPartiallyIgnored in ihrer Antwort fest. Bei der Navigation auf diesen Routen werden im Navigation SDK Routen-Callouts angezeigt, um auf die relevanten Einschränkungen hinzuweisen. Planen Sie Routen in diesen Fällen sorgfältig und verwenden Sie keine gekennzeichnete Route als einzige Informationsquelle für die Planung oder Navigation.
• Nicht unterstützte Funktionen: Das Routing für große Fahrzeuge unterstützt die folgenden Funktionen nicht:
  • Mautpreise für Lkw
  • Geschwindigkeitsbegrenzungen für Lkw oder schwere Fahrzeuge
  • Routing für radioaktive Gefahrstoffe
• Nutzungslimits: Für Anfragen an das Navigation SDK gelten die Standardnutzungs- und Kontingentlimits. Weitere Informationen finden Sie unter Nutzung und Abrechnung.

Lkw-spezifische Benutzeroberfläche anzeigen (Routen-Callouts)

Das Navigation SDK zeigt automatisch visuelle Warnungen auf der Karte an, sogenannte Routen-Callouts, um Fahrer auf bevorstehende Lkw Beschränkungen aufmerksam zu machen. Callouts werden für Einschränkungen angezeigt, die auf der geplanten Route auftreten, aber nicht auf anderen Straßen in der Nähe.

Das Navigation SDK enthält Callouts für die folgenden Einschränkungen:

Einschränkung	Callout-Symbol und ‑Text	Bedingungen für die Anzeige
Höhe	Gelb = Warnung, Ihr Fahrzeug ist nahe der zulässigen Höchsthöhe Rot = Ihr Fahrzeug ist höher als die zulässige Höchsthöhe	Ein gelbes Callout wird angezeigt, wenn die Höhe des Fahrzeugs nahe der Einschränkung liegt. Ein rotes Callout wird angezeigt, wenn die Route nicht konform ist und eine Höhenbeschränkung verletzt.
Gewicht		Ein rotes Callout wird angezeigt, wenn das Gewicht des Fahrzeugs das Limit der Straße überschreitet.
Lkw-Verbot		Ein rotes Callout wird angezeigt, wenn Sie auf einem Straßenabschnitt mit einer Beschränkung für Nutzfahrzeuge unterwegs sind.
Gefahrgut		Ein rotes Callout wird angezeigt, wenn die Gefahrgutladung des Fahrzeugs auf einem Straßenabschnitt verboten ist.

Funktionsweise von Routentokens

Ein routeToken ist ein verschlüsselter Snapshot einer Route, die vom Routing-Backend von Google erstellt wurde. Es enthält die geplante Routengeometrie sowie die physischen Abmessungen und das Einschränkungsprofil des Fahrzeugs.

Der Workflow umfasst die folgenden Schritte:

1. Route anfordern: Ihr Backend-Server fordert eine Lkw-Route von der Routes API (oder Route Optimization API) an.
2. Token erhalten: Die Routing-API berechnet die konforme Route und gibt ein routeToken an Ihren Backend-Server zurück.
3. Token weiterleiten: Ihr Backend-Server übergibt das routeToken und Zielkoordinaten an Ihre mobile App.
4. An SDK übergeben: Die mobile App übergibt das routeToken an das Navigation SDK.
5. Navigation starten: Das Navigation SDK verarbeitet alle Aspekte der detaillierten Routenführung, einschließlich der Darstellung von Routen-Callouts und der Handhabung der dynamischen Routenänderung entsprechend den Einschränkungen des Fahrzeugs.

Dynamische Neuberechnungen und Routenänderungen

Während der aktiven Navigation können die Verkehrslage, Straßensperrungen oder verpasste Abzweigungen dazu führen, dass das Fahrzeug von der geplanten Route abweicht.

Wenn eine Routenänderung erfolgt:

• Das Navigation SDK berechnet die Route zum Ziel automatisch neu.
• Das SDK behält die Fahrzeugattribute und ‑abmessungen bei, die im ursprünglichen routeToken codiert sind.
• Die neu berechnete Route vermeidet niedrige Durchfahrthöhen, Brücken mit Gewichtsbeschränkungen und Straßen, die für Nutzfahrzeuge verboten sind.

Implementierung: Lkw-spezifische Fahrt starten

Führen Sie die folgenden Schritte aus, um die detaillierte Routenführung mit einem Routentoken für große Fahrzeuge zu initialisieren und zu starten.

Schritt 1: Routentoken von Ihrem Backend abrufen

Ihre mobile App empfängt die routeToken-String zusammen mit den Zielkoordinaten von Ihrem Backend-Server. Weitere Informationen zum Generieren dieses Tokens auf Ihrem Server finden Sie in der Routes API-Dokumentation unter Routen und voraussichtliche Ankunftszeiten für große Fahrzeuge generieren.

Der folgende Code ist ein Beispiel für ein Routentoken:

{
  "routeToken": "CqMBCjoKCJQOor5DHcwiEhBon3XpHXFnVvDeWMwd9PpAGgz6wtnFDKIBrAHTARpCApUDSggAAAAACjcrP3gBEAQaTApKChgKDQoCCAERAAAAAACAZkAR3SQGgZUXdUASEggAEAMQBhATEBIYAkIEGgIIBSIYChZ2VEJiWlBPSkk1aU5wUVRzNTV5d0FRKAEiFQBcJuds-Efh-2QZhOMTtUCCxEVL_g"
}

Schritt 2: Token an den Navigator übergeben

Übergeben Sie das routeToken und die Zielwegpunkte an die Methode setDestinations von mapView.navigator.

Beachten Sie beim Konfigurieren von Wegpunkten und Übergeben des Routentokens Folgendes:

• Anforderung für Zielübereinstimmung: Die Zielkoordinaten, die an setDestinations übergeben werden, müssen mit den Zielkoordinaten übereinstimmen, die beim Generieren des routeToken verwendet werden. Wenn Sie ein anderes Ziel angeben, tritt ein Fehler auf.
• Routing auf der Straßenseite: Große Nutzfahrzeuge können auf engen Straßen nicht so einfach wenden. Damit sich der Lkw dem Ziel auf der richtigen Straßenseite nähert, legen Sie für Ihre Wegpunkte preferSameSideOfRoad = true fest.
• Fahrzeugstopps: Wenn Sie den Lkw zu einem geeigneten Ort zum Anhalten oder Entladen leiten möchten, legen Sie für Ihre Wegpunkte vehicleStopover = true fest.
• Navigationspunkte: Wenn Ihr Ziel einen bestimmten Fracht eingang oder eine bestimmte Laderampe hat, geben Sie diese mit einem Navigationspunkt Token an.

Schritt 3: Routenstatus verarbeiten und Navigation starten

Werten Sie den in der setDestinations-Callback zurückgegebenen GMSRouteStatus aus. Wenn der Status .OK (GMSRouteStatusOK) ist, legen Sie isGuidanceActive = true (guidanceActive = YES) fest, um die aktive detaillierte Routenführung zu starten.

Codebeispiel

Übergeben Sie das Routentoken mit der Methode setDestinations von mapView.navigator an das Navigation SDK und geben Sie dabei dieselben Zielwegpunkte an, die Sie beim Erstellen des Routentokens verwendet haben:

// Obtain the routeToken string from your backend
let routeToken = "route token returned by Routes API"

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

Anzeigen im Fahrzeug

Sie können die Navigationssitzung für große Fahrzeuge auf dem Armaturenbrett mit Navigation for CarPlay anzeigen.

Nächste Schritte

• Navigationsoberfläche ändern: Passen Sie integrierte UI-Steuerelemente und visuelle Elemente wie den Kompass, die Schaltfläche zum Zentrieren und die Kamera perspektive an.
• Auf Navigationsereignisse warten: Verarbeiten Sie Navigationsaktualisierungen und Lebenszyklusereignisse wie Routenfortschritt, Änderungen der voraussichtlichen Ankunftszeit und Routenänderungen.