Wenn Sie Aktualisierungen zu Fahrtdaten von Google Maps oder Waze erhalten möchten, konfigurieren Sie Ihr Backend mit einer der folgenden Optionen:
- Eine Pull-Methode mit der Navigation Connect API oder
- eine ereignisgesteuerte Push-Methode mit Google Cloud Pub/Sub.
Option 1: Navigation Connect API verwenden
Wenn Sie den aktuellen Fahrtstatus manuell abrufen möchten, rufen Sie die Methode GetTrip mit der eindeutigen Fahrt-ID auf.
Das folgende Beispiel zeigt, wie Sie die API über die Befehlszeile aufrufen. Dabei werden die Standardanmeldedaten für Anwendungen (Application Default Credentials, ADC) verwendet, um die Server-zu-Server-Anfrage zu autorisieren.
#!/bin/bash
gcloud auth application-default login
access_token="$(gcloud auth application-default print-access-token)"
# Call the GetTrip method
curl -X GET "https://navigationconnect.googleapis.com/v1/projects/PROJECT_ID/trips/TRIP_ID" \
-H "Authorization: Bearer ${access_token}" \
-H "Content-Type: application/json"
Polylinienformate anpassen (nur Waze)
Wenn Sie bei der Erstellung der Fahrt die Berichterstellung für die verbleibende Route
aktiviert haben, können Sie die Darstellung der zurückgegebenen
Polylinie für die verbleibende Route anpassen, wenn Sie die Methode GetTrip aufrufen.
Wenn Sie ein Format für die Polylinie auswählen möchten, fügen Sie den Parameter routePolylineFormat in Ihre Anfrage ein. Folgende Formate werden unterstützt:
ENCODED: Ein standardmäßiger codierter Polylinienstring (5 Dezimalstellen).S2ENCODED: Eine codierte S2Polyline.GEO_JSON: Ein GeoJSON-LineString-Format.
Option 2: Google Cloud Pub/Sub verwenden
Wenn Sie regelmäßige Fahrtaktualisierungen erhalten möchten, abonnieren Sie ein Google Cloud Pub/Sub-Thema. Nachdem der Fahrer zugestimmt hat, sendet Navigation Connect Aktualisierungen direkt an Ihr Thema.
Eine Einführung in Messaging finden Sie in der Pub/Sub-Kurzanleitung.
In den folgenden Abschnitten wird beschrieben, wie Sie mit Google Cloud Pub/Sub Daten aus einer Navigationssitzung mit Google Maps oder Waze erhalten.
1. Thema erstellen
Erstellen Sie in Ihrem Google Cloud-Projekt ein Thema mit dem Namen navigation_connect_trip_notifications. Gehen Sie dazu so vor:
- Aktivieren Sie die Pub/Sub API.
- Rufen Sie in der Google Cloud Console die Seite Pub/Sub-Themen auf.
- Klicken Sie auf Thema erstellen.
Geben Sie im Feld Thema-ID den Wert
navigation_connect_trip_notificationsein.Klicken Sie auf Erstellen.
In der Console wird der vollständige Themenname als projects/project-number/topics/navigation_connect_trip_notifications angezeigt, wobei project-number Ihre eindeutige Projektnummer ist.
2. Veröffentlichungsberechtigung für das Navigation Connect-Dienstkonto gewähren
Google verwendet ein Dienstkonto, um Fahrtaktualisierungen in Google Cloud Pub/Sub-Themen zu veröffentlichen. Wenn Sie Aktualisierungen in Ihrem Thema erhalten möchten, gewähren Sie dem folgenden Dienstkonto die Berechtigung projects.topics.publish für dieses Thema: geo-navigation-connect-pubsub@system.gserviceaccount.com.
Weitere Informationen finden Sie in der Pub/Sub-Dokumentation zur Zugriffs steuerung.
3. In Ihr Backend einbinden
Um Aktualisierungen zu verarbeiten, schreiben Sie eine serverseitige Anwendung, die sich authentifiziert und Ihr Thema abonniert. Verwenden Sie die Pub/Sub-Clientbibliotheken zur Optimierung der Entwicklung. Für Tests können Sie auch die gcloud CLI und die Google Console verwenden.
4. Abo testen
Prüfen Sie Ihre Einrichtung mit der gcloud CLI oder der Google Cloud Console.
gcloud-CLI
Rufen Sie mit dem folgenden Befehl Nachrichten aus einem Abo ab (z. B. my-sub):
gcloud pubsub subscriptions pull my-sub --auto-ack
Google Cloud Console
Gehen Sie in der Google Cloud Console so vor:
- Öffnen Sie die Seite Abos.
- Wählen Sie Ihr Abo aus und klicken Sie auf den Tab Nachrichten.
- Klicken Sie auf Pull.
Nächste Schritte
Sobald Sie Fahrtdaten erhalten, parsen Sie die Daten, um sie in Ihren Systemen und Apps zu verwenden.