Navigation Connect API – Übersicht

Entwickler im Europäischen Wirtschaftsraum (EWR)

Die Navigation Connect API ist ein Dienst, der die Nutzung von Google Maps und Waze durch Ihre Fahrer mit Ihren Unternehmenssystemen verbindet. Dabei werden Autorisierungstokens für Fahrten zusammen mit einem Deeplink in Ihrer App verwendet, sodass der Fahrer auf einen Link oder eine Schaltfläche tippen kann, um die Navigation in der von ihm ausgewählten Verbraucher-App zu starten. Während der Fahrer die Route abfährt, können Sie laufend Echtzeit-Standortdaten wie Live-Standorte, hochpräzise voraussichtliche Ankunftszeiten und Status des Fahrtenlebenszyklus erhalten.

Die Navigation Connect API bietet eine einfache Alternative zum Navigation SDK. Sie verwendet die eigenständigen Google Maps- und Waze-Apps für die Routenplanung, sodass Sie keine benutzerdefinierte Navigationsoberfläche in Ihre App einbetten müssen. Die Sitzung des Fahrers wird sicher mit Ihrem Backend verknüpft. Wenn ein Fahrer eine Fahrt beginnt, wird ihm die gewohnte Navigationsschnittstelle angezeigt. Es gibt jedoch zwei Neuerungen: eine Aufforderung zur Einwilligung in die Weitergabe von Fahrtendaten (alle 12 Monate erforderlich) und eine Markenschaltfläche zum Zurückkehren zu Ihrer App.

Gründe für die Verwendung der Navigation Connect API

Mit der Navigation Connect API können Sie Echtzeit-Updates zu Standort und voraussichtlicher Ankunftszeit aus Google Maps oder Waze direkt in Ihre Backend-Prozesse einbinden. So können Sie wichtige Geschäftsentscheidungen treffen und genaue Updates mit Ihren Kunden teilen, während die Fahrer ihre bevorzugte Navigations-App, Google Maps oder Waze, verwenden.

Beispielanwendungsfälle:

  • Fahrdienste transparenter gestalten:Geben Sie Kunden und Fahrgästen von Fahrdiensten genaue Echtzeitinformationen zum Standort des Fahrers und zur voraussichtlichen Ankunftszeit.
  • Lieferungen besser verfolgen:Kunden über genaue Versand- oder Essenslieferzeiten auf Grundlage von Echtzeit-Verkehrs- und Routingdaten informieren
  • Flottenmanagement und Disposition verbessern:Treffen Sie fundierte Dispositionsentscheidungen für Flotten oder mobile Mitarbeiter, die On-Demand-Dienste (z. B. Pannenhilfe, Wartung oder Transport) anbieten, indem Sie die Fahrerstandorte in Echtzeit verfolgen.

Funktionen der Navigation Connect API

Mit der Navigation Connect API können Sie Echtzeit-Standort- und ETA-Updates direkt in Ihrem Backend von Google Maps oder Waze erhalten.

  • Fahrten unaufdringlich erfassen:Fahrten erfassen, ohne dass der Fahrer Google Maps oder Waze verwenden muss oder das Nutzererlebnis beeinträchtigt wird.
  • Auf Echtzeit-Standortdaten zugreifen:Sie können während einer Fahrt kontinuierlich die Echtzeit-Standorte der Fahrer, die verbleibenden Entfernungen und die verstrichene Zeit abrufen.
  • Fahrtlebenszyklen im Blick behalten:Konfigurieren Sie die Updatehäufigkeit für Fahrtdaten, um den genauen Status einer Fahrt zu verfolgen und sofort zu erfahren, wenn ein Fahrer unterwegs ist, angekommen ist oder eine Fahrt unterbricht.
  • Ankunftszeiten abrufen und teilen:Rufen Sie hochpräzise Ankunftszeit-Updates ab, die auf den Live-Routing-Algorithmen von Google basieren.
  • Verbleibende Route und Verkehrslage verfolgen:Sie erhalten die Polylinie der verbleibenden Route und die Echtzeit-Verkehrslage vom aktuellen Standort des Fahrers bis zum Ziel, genau wie in Google Maps oder Waze angezeigt. Diese Funktion löst die Navigation Connect Enterprise SKU aus.
    • Dynamisches Kürzen:Während sich das Fahrzeug bewegt, kürzt Navigation Connect automatisch die Polylinie der aktiven Route des Fahrers (die vollständige Route, die in der App navigiert wird), damit Sie nur die verbleibende Route (das Segment von der aktuellen Position des Fahrers bis zum Ziel) erhalten.
    • Updatehäufigkeit:Routen und Verkehrslage werden automatisch aktualisiert, wenn die Route neu berechnet wird, eine proaktive clientseitige Routenneuberechnung erfolgt oder sich die Verkehrslage ändert.
  • Routenabweichungen verfolgen (nur Waze): Sie können erkennen, wenn ein Fahrer von der Route abweicht, den genauen Ort und die genaue Zeit der Abweichung ermitteln und feststellen, ob die Abweichung vom Fahrer (z. B. falsches Abbiegen) oder vom System (z. B. Umleitung wegen Verkehrsaufkommen) initiiert wurde. Diese Funktion löst die Navigation Connect Enterprise-Version aus.
  • Daten flexibel aufnehmen:Sie können Echtzeit-Fahrtdaten über direkte REST API-Aufrufe abrufen oder Updates effizient über Google Cloud Pub/Sub-Abos streamen.

Funktionsweise der Navigation Connect API

Die Navigation Connect API akzeptiert eine CreateTrip-Anfrage, die die Kennungen Ihrer mobilen Anwendung und die Sitzungskonfiguration enthält. Der Dienst generiert eine eindeutige Fahrtinstanz und gibt ein Fahrt-Token zurück. Dieses Token wird dann an einen Google Maps- oder Waze-Deeplink angehängt. Sobald der Fahrer die Navigation startet und seine Einwilligung erteilt, verarbeitet der Dienst die Echtzeit-Navigationsdaten und gibt Telemetrie-Updates zurück, einschließlich Standort, voraussichtlicher Ankunftszeit und verbleibender Entfernung.

Ressourcen

In der folgenden Tabelle sind die über die Navigation Connect API verfügbaren Ressourcen und die zurückgegebenen Daten zusammengefasst. Weitere Informationen finden Sie in der Referenz zur Navigation Connect API.

Datenressourcen Zurückgegebene Daten

Authentifizierungs- und Mobilgeräte-App-IDs im JSON-Format.

Weitere Informationen finden Sie unter Fahrt erstellen.

Ein eindeutiges Fahrttoken, mit dem die Verbindung in Google Maps oder Waze initialisiert wird.

Weitere Informationen finden Sie unter Google Maps oder Waze starten.

Die eindeutige Fahrt-ID und eine Pull- oder Push-Methode im JSON-Format.

Weitere Informationen finden Sie unter Fahrtdaten abrufen.

Echtzeit-Telemetriedaten zur Fahrt, darunter:

  • Status und Metadaten von Fahrten
  • Aktueller Standort (Breiten-/Längengrad)
  • Voraussichtliche Ankunftszeit
  • Verbleibende Strecke und Zeit

Weitere Informationen finden Sie unter Fahrtdaten verarbeiten.

Navigation Connect API verwenden

1 Einrichten Beginnen Sie mit Google Cloud-Projekt einrichten und folgen Sie der Anleitung.
2 Reise erstellen Senden Sie einen Navigation Connect API-Aufruf, um eine Fahrt mit einer eindeutigen ID zu erstellen, und speichern Sie das Token.
3 Google Maps oder Waze starten Übergeben Sie das Reise-Token und starten Sie Google Maps oder Waze, um die Weitergabe von Fahrtdaten zu aktivieren.
4 Fahrtdaten abrufen Senden Sie einen Navigation Connect API-Aufruf, um Fahrtdaten abzurufen. Optional können Sie Updates über Google Cloud Pub/Sub abonnieren.
5 Fahrtdaten verarbeiten Fahrtstatus und andere Fahrtdaten verarbeiten