Mengambil data perjalanan

Untuk menerima pembaruan data perjalanan dari Google Maps atau Waze, konfigurasi backend Anda menggunakan salah satu opsi berikut:

  • Metode penarikan menggunakan Navigation Connect API, atau
  • Metode push berbasis peristiwa menggunakan Google Cloud Pub/Sub.

Opsi 1: Menggunakan Navigation Connect API

Untuk mengambil status perjalanan terbaru secara manual, panggil metode GetTrip dengan ID perjalanan unik.

Contoh berikut menunjukkan cara memanggil API dari command line menggunakan Kredensial Default Aplikasi (ADC) untuk mengizinkan permintaan server-ke-server.

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

Menyesuaikan format polyline (khusus Waze)

Jika telah mengaktifkan pelaporan rute yang tersisa selama pembuatan perjalanan, Anda dapat menyesuaikan representasi polyline rute aktif yang ditampilkan saat memanggil metode GetTrip.

Untuk memilih format polyline, sertakan parameter routePolylineFormat dalam permintaan Anda. Format yang didukung mencakup:

  • ENCODED: String polyline berenkode standar (5 titik desimal).
  • S2ENCODED: S2Polyline yang dienkode.
  • GEO_JSON: Format GeoJSON LineString.

Opsi 2: Menggunakan Google Cloud Pub/Sub

Untuk menerima info terbaru perjalanan secara rutin, berlangganan topik Google Cloud Pub/Sub. Setelah pengemudi memberikan izin, Navigation Connect akan mengirimkan pembaruan langsung ke topik Anda.

Untuk pengantar tentang layanan pesan, lihat Panduan Memulai Cepat Pub/Sub.

Bagian berikut menjelaskan cara menggunakan Google Cloud Pub/Sub untuk menerima data dari sesi navigasi dengan Google Maps atau Waze.

1. Membuat topik

Buat topik yang bernama persis navigation_connect_trip_notifications di project Google Cloud Anda, sebagai berikut:

  1. Aktifkan Pub/Sub API.
  2. Buka halaman topik Pub/Sub di konsol Google Cloud.
  3. Klik Buat Topik.

  4. Masukkan navigation_connect_trip_notifications di kolom ID Topik.

  5. Klik Buat.

Konsol menampilkan nama topik lengkap sebagai projects/project-number/topics/navigation_connect_trip_notifications, dengan project-number sebagai nomor project unik Anda.

2. Memberikan izin publikasi ke akun layanan Navigation Connect

Google menggunakan akun layanan untuk memublikasikan pembaruan perjalanan ke topik Google Cloud Pub/Sub. Untuk menerima pembaruan di topik Anda, berikan izin projects.topics.publish untuk topik ini ke akun layanan berikut: geo-navigation-connect-pubsub@system.gserviceaccount.com.

Untuk mengetahui informasi selengkapnya, lihat dokumentasi Pub/Sub tentang kontrol akses.

3. Melakukan integrasi dengan backend Anda

Untuk memproses update, tulis aplikasi sisi server yang mengautentikasi dan berlangganan topik Anda. Gunakan Library Klien Pub/Sub untuk pengembangan yang disederhanakan. Untuk pengujian, Anda juga dapat menggunakan GCloud CLI dan Konsol Google.

4. Menguji langganan Anda

Verifikasi penyiapan Anda menggunakan gcloud CLI atau Konsol Google Cloud.

gcloud CLI

Tarik pesan dari langganan (misalnya, my-sub) menggunakan perintah berikut:

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

Konsol Google Cloud

Di konsol Google Cloud, lakukan langkah-langkah berikut:

  1. Buka halaman Subscription.
  2. Pilih langganan Anda, lalu klik tab Pesan.
  3. Klik Pull.

Langkah berikutnya

Setelah Anda mulai menerima data perjalanan, parsing data untuk menggunakannya di sistem dan aplikasi Anda.

Menangani data perjalanan