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:
- Aktifkan Pub/Sub API.
- Buka halaman topik Pub/Sub di Konsol Google Cloud.
- Klik Buat Topik.
Masukkan
navigation_connect_trip_notificationsdi kolom Topic ID.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:
- Buka halaman Langganan.
- Pilih langganan Anda, lalu klik tab Messages.
- Klik Pull.
Langkah berikutnya
Setelah Anda mulai menerima data perjalanan, uraikan data tersebut untuk digunakan dalam sistem dan aplikasi Anda.