In diesem Dokument wird beschrieben, wie Sie die Navigation Connect API einrichten. Außerdem werden die Geräteanforderungen für Fahrer aufgeführt, die die Navigation Connect API verwenden möchten.
Einrichtung von Navigation Connect
Bevor Sie die Navigation Connect API verwenden können, müssen Sie die folgenden Einrichtungsschritte ausführen:
- Google Cloud-Projekt erstellen und konfigurieren
- Aktivieren Sie die Navigation Connect API und lassen Sie Ihre App überprüfen.
- Richten Sie OAuth ein, um OAuth-Tokens zu erstellen.
- Richten Sie Ihr Dienstkonto ein, um die Kommunikation zwischen Ihrer Backend-Infrastruktur und Google Maps oder Waze zu ermöglichen.
Mindestanforderungen an Geräte für die Verwendung von Navigation Connect
Diese Anforderungen sind erforderlich, damit auf dem Gerät des Fahrers eine Navigation Connect-Sitzung ausgeführt werden kann. In einer Sitzung werden über die Navigation Connect API Echtzeit-Fahrtdaten wie Standort und voraussichtliche Ankunftszeit an Ihren Backend-Server gesendet.
Unterstützte App-Versionen
Auf dem Gerät muss Waze oder Google Maps für Android installiert sein. In der folgenden Tabelle sind die Mindestversionen der einzelnen Apps für Navigation Connect und für Funktionen aufgeführt, die eine neuere Version erfordern.
| Anwendung | Mindestversion | Meldung der verbleibenden Route | Berichte zu Routenabweichungen |
|---|---|---|---|
| Waze für Android | 5.15.5 | 5.20.0.2 | 5.22 |
| Waze für iOS | 5.15.5 | 5.20.0.1 | 5.22 |
| Google Maps für Android | 26.14 | 26.27 | Nicht unterstützt |
Genauer Standort aktiviert
Fordern Sie den Fahrer auf, die Berechtigungen für den genauen Standort auf seinem Gerät zu aktivieren. Waze und Google Maps benötigen den genauen Standort, um die Navigation zu starten.
Einwilligung des Fahrers
Für Navigation Connect ist die Zustimmung des Fahrers zur Weitergabe von Fahrtdaten erforderlich. Sie müssen den Dialog zur Einholung von Einwilligungen nicht auslösen. Google Maps oder Waze verarbeitet diese Benutzeroberfläche automatisch.
Bei der ersten Fahrt, die über Ihre App gestartet wird, werden die Fahrer von Google Maps oder Waze aufgefordert, ihre Fahrtdaten zu teilen.
- Wenn der Fahrer auf Zulassen tippt, beginnt Navigation Connect, Echtzeitstandort- und voraussichtliche Ankunftszeitdaten mit Ihrem Backend zu teilen.
- Wenn der Fahrer auf Nicht zulassen tippt oder die Einwilligung später widerruft, bietet Google Maps oder Waze eine detaillierte Routenführung, aber Navigation Connect sendet keine Daten. Ihr Back-End erhält den Status
CLIENT_ERRORin der Nutzlast der Fahrtdaten.
Fahrer müssen diese Einwilligung alle 12 Monate bestätigen.
Nächste Schritte
Der erste Schritt beim Einrichten der Navigation Connect API besteht darin, ein Google Cloud-Projekt zu erstellen und zu konfigurieren.