Wenn Sie Updates 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.
Im folgenden Beispiel wird gezeigt, wie Sie die API über die Befehlszeile aufrufen und die Server-zu-Server-Anfrage mit Ihren Standardanmeldedaten für Anwendungen (Application Default Credentials, ADC) 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
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. Zu den unterstützten Formaten gehören:
ENCODED: Ein standardmäßiger codierter Polylinien-String (5 Dezimalstellen).S2ENCODED: Eine codierte S2Polyline.GEO_JSON: Ein GeoJSON-LineString-Format.
Option 2: Google Cloud Pub/Sub verwenden
Wenn Sie regelmäßig Updates zu Fahrten erhalten möchten, abonnieren Sie ein Google Cloud Pub/Sub-Thema. Nachdem der Fahrer zugestimmt hat, sendet Navigation Connect Updates direkt an Ihr Thema.
Eine Einführung in das 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 empfangen.
1. Thema erstellen
Erstellen Sie in Ihrem Google Cloud-Projekt ein Thema mit dem Namen navigation_connect_trip_notifications:
- 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
navigation_connect_trip_notificationsin das Feld Themen-ID ein.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. Dem Navigation Connect-Dienstkonto die Veröffentlichungsberechtigung gewähren
Google verwendet ein Dienstkonto, um Fahrtupdates in Google Cloud Pub/Sub-Themen zu veröffentlichen. Wenn Sie Updates zu 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 Zugriffssteuerung.
3. In Ihr Backend einbinden
Wenn du Updates verarbeiten möchtest, musst du eine serverseitige Anwendung schreiben, die sich authentifiziert und dein Thema abonniert. Verwenden Sie die Pub/Sub-Clientbibliotheken für eine optimierte Entwicklung. Zum Testen können Sie auch die gcloud CLI und die Google Cloud Console verwenden.
4. Abo testen
Überprüfen Sie Ihre Einrichtung mit der gcloud CLI oder der Google Cloud Console.
gcloud-CLI
Rufen Sie Nachrichten aus einem Abo (z. B. my-sub) mit dem folgenden Befehl ab:
gcloud pubsub subscriptions pull my-sub --auto-ack
Google Cloud Console
Führen Sie in der Google Cloud Console die folgenden Schritte aus:
- Ö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.