Fahrtdaten abrufen

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:

  1. Aktivieren Sie die Pub/Sub API.
  2. Rufen Sie in der Google Cloud Console die Seite Pub/Sub-Themen auf.
  3. Klicken Sie auf Thema erstellen.
  4. Geben Sie navigation_connect_trip_notifications in das Feld Themen-ID ein.

  5. 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:

  1. Öffnen Sie die Seite Abos.
  2. Wählen Sie Ihr Abo aus und klicken Sie auf den Tab Nachrichten.
  3. Klicken Sie auf Pull.

Nächste Schritte

Sobald Sie Fahrtdaten erhalten, parsen Sie die Daten, um sie in Ihren Systemen und Apps zu verwenden.

Fahrtdaten verarbeiten