Navigation Connect API – Übersicht

Entwickler im Europäischen Wirtschaftsraum (EWR)

Die Navigation Connect API ist ein Dienst, der die Nutzung der Google Maps- und Waze-Navigation durch Ihren Fahrer mit Ihren Unternehmenssystemen verbindet. Dabei werden Fahrtautorisierungstokens 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 gewünschten Consumer-App zu starten. Während der Fahrer navigiert, können Sie fortlaufend Echtzeit-Standortdaten wie Live-Standorte, hochgenaue voraussichtliche Ankunftszeiten und Status des Fahrtlebenszyklus erhalten.

Die Navigation Connect API ist eine schlanke Alternative zum Navigation SDK. Dabei werden die eigenständigen Google Maps- und Waze-Apps für die Routenplanung verwendet, anstatt dass Sie eine 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 startet, sieht er die gewohnte Navigationsoberfläche mit zwei Ergänzungen: einer Aufforderung zur Einwilligung in die Weitergabe von Fahrtdaten (alle 12 Monate erforderlich) und einem Button „Zurück“ mit Branding, um zu Ihrer App zurückzukehren.

Vorteile der Navigation Connect API

Mit der Navigation Connect API können Sie Echtzeit-Updates zum Fahrtstandort und zur voraussichtlichen Ankunftszeit aus Google Maps oder Waze direkt in Ihre Backend-Prozesse einbinden. So können Sie wichtige Geschäftsentscheidungen treffen und Ihren Kunden genaue Updates zur Verfügung stellen, während die Fahrer ihre bevorzugte Navigations-App verwenden: Google Maps oder Waze.

Beispiele für Anwendungsfälle:

  • Mehr Transparenz bei Mitfahrgelegenheiten:Kunden und Fahrgästen von Mitfahrgelegenheiten genaue Echtzeit-Updates zum Standort des Fahrers und zur voraussichtlichen Ankunftszeit zur Verfügung stellen.
  • Liefertracking optimieren: Kunden genaue Lieferzeiten für Sendungen oder Essenslieferungen basierend auf aktueller Verkehrslage und Routendaten mitteilen.
  • Verbessertes Flottenmanagement und Dispatching:Fundierte Entscheidungen für Flotten oder mobile Arbeitskräfte treffen, die On-Demand-Dienste anbieten (z. B. Pannenhilfe, Wartung oder Transport), indem Sie die Live-Standorte der Fahrer verfolgen.

Funktionen der Navigation Connect API

Mit der Navigation Connect API können Sie Echtzeit-Updates zum Standort und zur voraussichtlichen Ankunftszeit aus Google Maps oder Waze direkt in Ihrem Backend erhalten.

  • Unaufdringliches Tracking von Fahrten:Fahrten verfolgen, ohne die Wahl des Fahrers zwischen Google Maps und Waze zu ändern oder die Nutzererfahrung zu beeinträchtigen.
  • Zugriff auf Echtzeit-Standortdaten:Während der gesamten Fahrt kontinuierlich Echtzeit-Standorte der Fahrer, verbleibende Entfernungen und verstrichene Zeit abrufen.
  • Fahrtlebenszyklen überwachen: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.
  • Voraussichtliche Ankunftszeiten abrufen und weitergeben:Hochgenaue Updates zur voraussichtlichen Ankunftszeit abrufen, die auf den Echtzeit-Routenplanungsalgorithmen von Google basieren.
  • Verbleibende Route und Verkehrslage verfolgen (nur Waze) : Die verbleibende Routenlinie und die Echtzeit-Verkehrslage vom aktuellen Standort des Fahrers bis zum Zielort genau so erhalten, wie sie in Waze angezeigt werden.
    • Dynamisches Kürzen:Während sich das Fahrzeug bewegt, kürzt Navigation Connect automatisch die aktive Routenlinie des Fahrers (die vollständige Route, die derzeit in der App navigiert wird), damit Sie nur die verbleibende Route erhalten (das Segment vom aktuellen Standort des Fahrers bis zum Zielort).
    • Aktualisierungshäufigkeit:Routen- und Verkehrslage werden automatisch aktualisiert, wenn die Route neu berechnet wird, eine proaktive clientseitige Umleitung erfolgt oder sich die Verkehrslage ändert.
  • Daten flexibel aufnehmen:Echtzeit-Fahrtdaten über direkte REST API-Aufrufe aufnehmen 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 die Einwilligung erteilt, verarbeitet der Dienst Echtzeit-Navigationsdaten und gibt Telemetrie-Updates zurück, einschließlich Standort, voraussichtliche Ankunftszeit und verbleibende Entfernung.

Ressourcen

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

Datenressourcen Zurückgegebene Daten

Authentifizierungs- und Kennungen der mobilen App im JSON-Format.

Weitere Informationen finden Sie unter Fahrt erstellen.

Ein eindeutiges Fahrt-Token, das zum Initialisieren der Verbindung in Google Maps oder Waze verwendet 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-Fahrttelemetrie, einschließlich:

  • Fahrtstatus und Metadaten
  • Aktueller Standort (Breitengrad/Längengrad)
  • Voraussichtliche Ankunftszeit
  • Verbleibende Entfernung und Zeit

Weitere Informationen finden Sie unter Fahrtdaten verarbeiten.

Verwendung der Navigation Connect API

1 Einrichten Beginnen Sie mit Google Cloud-Projekt einrichten und folgen Sie der Anleitung.
2 Fahrt 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 Fahrt-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 Google Cloud Pub/Sub verwenden, um Updates zu abonnieren.
5 Fahrtdaten verarbeiten Informationen zum Verarbeiten des Fahrtstatus und anderer Fahrtdaten.