Pobieranie danych o podróży

Aby otrzymywać aktualizacje danych o podróży z Map Google lub Waze, skonfiguruj backend, korzystając z jednej z tych opcji:

  • metodę pull przy użyciu interfejsu Navigation Connect API,
  • Metoda push oparta na zdarzeniach, która korzysta z Google Cloud Pub/Sub.

Opcja 1. Użyj interfejsu Navigation Connect API

Aby ręcznie pobrać najnowszy stan przejazdu, wywołaj metodę GetTrip z unikalnym identyfikatorem przejazdu.

Z przykładu poniżej dowiesz się, jak wywołać interfejs API z wiersza poleceń za pomocą domyślnego uwierzytelniania aplikacji (ADC) w celu autoryzacji żądania między serwerami.

#!/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"

Dostosowywanie formatów linii łamanej

Jeśli podczas tworzenia podróży włączysz raportowanie pozostałej trasy, możesz dostosować reprezentację zwracanej linii łamanej pozostałej trasy podczas wywoływania metody GetTrip.

Aby wybrać format linii łamanej, dodaj do żądania parametr routePolylineFormat. Obsługiwane formaty:

  • ENCODED: standardowy ciąg zakodowanej linii łamanej (5 separatorów dziesiętnych).
  • S2ENCODED: zakodowana linia łamana S2.
  • GEO_JSON: format GeoJSON LineString.

Opcja 2. Użyj Google Cloud Pub/Sub

Aby otrzymywać regularne aktualizacje dotyczące przejazdów, zasubskrybuj temat Google Cloud Pub/Sub. Gdy kierowca wyrazi zgodę, Navigation Connect będzie wysyłać aktualizacje bezpośrednio do Twojego tematu.

Wprowadzenie do przesyłania wiadomości znajdziesz w krótkim wprowadzeniu do Pub/Sub.

W sekcjach poniżej opisujemy, jak używać Google Cloud Pub/Sub do odbierania danych z sesji nawigacji w Mapach Google lub Waze.

1. Tworzenie tematu

Utwórz temat o nazwie navigation_connect_trip_notifications w projekcie Google Cloud w ten sposób:

  1. Włącz Pub/Sub API.
  2. W konsoli Google Cloud otwórz stronę tematów Pub/Sub.
  3. Kliknij Utwórz temat.
  4. W polu Identyfikator tematu wpisz navigation_connect_trip_notifications.

  5. Kliknij Utwórz.

Konsola wyświetla pełną nazwę tematu jako projects/project-number/topics/navigation_connect_trip_notifications, gdzie project-number to unikalny numer projektu.

2. Przyznawanie uprawnień do publikowania kontu usługi Navigation Connect

Google używa konta usługi do publikowania aktualizacji przejazdów w tematach Google Cloud Pub/Sub. Aby otrzymywać aktualizacje w temacie, przyznaj uprawnienie projects.topics.publish do tego tematu temu kontu usługi: geo-navigation-connect-pubsub@system.gserviceaccount.com.

Więcej informacji znajdziesz w dokumentacji Pub/Sub dotyczącej kontroli dostępu.

3. Integracja z backendem

Aby przetwarzać aktualizacje, napisz aplikację po stronie serwera, która uwierzytelnia i subskrybuje Twój temat. Aby usprawnić proces programowania, użyj bibliotek klienta Pub/Sub. Do testowania możesz też użyć interfejsu wiersza poleceń gcloud i Google Cloud Console.

4. Testowanie subskrypcji

Sprawdź konfigurację za pomocą gcloud CLI lub konsoli Google Cloud.

interfejs wiersza poleceń gcloud

Pobierz wiadomości z subskrypcji (np. my-sub) za pomocą tego polecenia:

gcloud pubsub subscriptions pull my-sub --auto-ack

Konsola Google Cloud

W konsoli Google Cloud wykonaj te czynności:

  1. Otwórz stronę Subskrypcje.
  2. Wybierz subskrypcję i kliknij kartę Wiadomości.
  3. Kliknij Pobierz.

Co dalej?

Gdy zaczniesz otrzymywać dane o podróży, przeanalizuj je, aby używać ich w swoich systemach i aplikacjach.

Przetwarzanie danych o podróży