Untuk meluncurkan sesi navigasi belokan demi belokan dengan aman bagi pengemudi, backend Anda harus membuat perjalanan dan mendapatkan token perjalanan yang diautentikasi dari Navigation Connect API.
Di Navigation Connect, perjalanan mewakili sesi navigasi ke satu
tujuan. Untuk membuat perjalanan dan mendapatkan token perjalanan yang diautentikasi
(authToken) yang diperlukan untuk mengizinkan sesi, kirim pesan CreateTripRequest
ke metode CreateTrip. Teruskan token perjalanan ke aplikasi seluler Anda untuk
disertakan dalam URL peluncuran untuk Google Maps atau Waze.
Panduan ini menjelaskan cara menyelesaikan proses ini dengan membuat ID perjalanan unik dan mengirimkan permintaan API Anda.
Membuat pesan CreateTripRequest
Untuk membuat perjalanan dan mendapatkan token perjalanan, lakukan langkah-langkah berikut untuk
membuat dan mengirim pesan CreateTripRequest:
- Melakukan autentikasi: Gunakan Kredensial Default Aplikasi (ADC) untuk mendapatkan token akses guna mengizinkan permintaan Anda. Untuk mengetahui detail selengkapnya, lihat Membuat token OAuth.
- Buat ID perjalanan: Buat ID perjalanan unik (
tripId) dalam format UUIDv4 untuk mengidentifikasi perjalanan di server Anda. - Buat payload: Buat payload JSON yang menyertakan ID aplikasi dan setelan konfigurasi Anda.
- Panggil metode
CreateTrip: Kirim permintaan POST ke API dengan token akses di header dan payload di isi.
Contoh berikut menunjukkan cara membuat perjalanan dengan mengirimkan
pesan CreateTripRequest:
#!/bin/bash
# Authenticate with ADC
access_token="$(gcloud auth application-default login --impersonate-service-account=SERVICE_ACCOUNT_EMAIL)"
# Generate a unique Trip ID
trip_id="$(uuidgen)"
# Construct the payload
payload=$(cat <<EOF
{
"androidAppId": "ANDROID_APP_ID",
"iosAppId": "IOS_APP_ID",
"config": {
"enablePubsub": true
}
}
EOF
)
# Call the CreateTrip method to request a trip token
curl -X POST "https://navigationconnect.googleapis.com/v1/projects/PROJECT_ID/trips?tripId=${trip_id}" \
-H "Authorization: Bearer ${access_token}" \
-H "Content-Type: application/json" \
-d "${payload}"
Konfigurasi opsional
Anda dapat menyesuaikan data perjalanan dengan menyesuaikan setelan berikut dalam
pesan CreateTripRequest:
| Fitur | Jenis | Deskripsi |
|---|---|---|
| Pelaporan rute yang tersisa | boolean |
Untuk menerima polyline rute aktif dan kondisi lalu lintas real-time, tetapkan Pengemudi memerlukan Waze versi 5.20.0.2 atau yang lebih baru di Android, 5.20.0.1 atau yang lebih baru di iOS, atau Google Maps untuk Android versi 26.27 atau yang lebih baru. |
| Pelaporan deviasi rute (khusus Waze) | boolean |
Untuk melacak kapan pengemudi keluar dari rute, tetapkan Pengemudi memerlukan Waze versi 5.22 atau yang lebih baru. |
| Frekuensi update perjalanan | boolean |
Secara default, Navigation Connect memperbarui data perjalanan setiap 60 detik. Untuk mengaktifkan update frekuensi tinggi (setiap 5 detik), tetapkan |
| Pembuatan peristiwa Google Cloud Pub/Sub | boolean |
Untuk mengaktifkan pembuatan peristiwa perjalanan menggunakan Google Cloud Pub/Sub, tetapkan |
| Masker kolom Google Cloud Pub/Sub | FieldMask |
Untuk mengelola ukuran payload dan mengurangi beban pemrosesan backend atau biaya penggunaan Google Cloud Pub/Sub, gunakan |
Mendapatkan token perjalanan dari respons
Metode CreateTrip menampilkan respons yang berisi token perjalanan yang diautentikasi. Untuk mengizinkan sesi navigasi, ekstrak token ini dari respons
dan teruskan ke aplikasi seluler Anda untuk disertakan dalam URL peluncuran.
Contoh kode berikut menunjukkan contoh respons:
{
"name": "projects/PROJECT_NUMBER/trips/TRIP_ID",
"authToken": {
"token": "BASE64_ENCODED_TRIP_TOKEN",
"expireTime": "2026-03-06T11:09:47.476942Z"
},
"state": "NEW",
"execution": {
"traveledDistanceMeters": 0,
"stopAddedInRoute": false
},
"createTime": "2026-03-05T23:09:50.768959Z",
"updateTime": "2026-03-05T23:09:50.768959Z"
}
Respons ini mencakup nilai berikut:
- PROJECT_NUMBER: ID numerik unik untuk project Anda. Nomor ini berbeda dengan Project ID alfanumerik Anda, tetapi mewakili project Google Cloud yang sama.
- TRIP_ID: ID perjalanan yang dibuat oleh backend Anda dalam format UUIDv4.
- BASE64_ENCODED_TRIP_TOKEN: Token perjalanan yang diautentikasi
(
authToken.token) yang ditampilkan oleh metodeCreateTrip. Teruskan token ini ke aplikasi seluler Anda untuk memulai navigasi belokan demi belokan yang dilacak di Google Maps atau Waze.
Langkah berikutnya
Gunakan token perjalanan untuk meluncurkan Google Maps atau Waze.
Meluncurkan Google Maps atau Waze