Mengambil data perjalanan

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

  • Metode pull 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) Anda 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

Jika telah mengaktifkan pelaporan rute yang tersisa selama pembuatan perjalanan, Anda dapat menyesuaikan representasi polyline rute yang tersisa 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 LineString GeoJSON.

Opsi 2: Menggunakan Google Cloud Pub/Sub

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

Untuk pengantar tentang pesan, lihat Panduan Memulai 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 dengan nama persis navigation_connect_trip_notifications di project Google Cloud Anda, seperti 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 Topic ID.

  5. Klik Buat.

Konsol akan 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 info terbaru perjalanan ke topik Google Cloud Pub/Sub. Untuk menerima update 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. Mengintegrasikan dengan backend Anda

Untuk memproses update, tulis aplikasi sisi server yang melakukan autentikasi dan berlangganan ke topik Anda. Gunakan Library Klien Pub/Sub untuk pengembangan yang lebih efisien. 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 Langganan.
  2. Pilih langganan Anda, lalu klik tab Messages.
  3. Klik Pull.

Langkah berikutnya

Setelah Anda mulai menerima data perjalanan, uraikan data tersebut untuk digunakan dalam sistem dan aplikasi Anda.

Menangani data perjalanan