Menyiapkan Navigation Connect

Developer Wilayah Ekonomi Eropa (EEA)

Dokumen ini menjelaskan langkah-langkah yang perlu Anda lakukan untuk mulai menggunakan Navigation Connect.

Pastikan Anda memenuhi prasyarat.

Aktifkan API di project Google Cloud Anda.

Konfigurasi OAuth untuk membuat permintaan API yang terautentikasi.

Produk Google Maps Platform memerlukan panggilan API untuk menyertakan token OAuth guna mencegah penggunaan yang tidak sah.

Membuat token OAuth

Navigation Connect mendukung OAuth 2.0 untuk autentikasi. Google mendukung skenario OAuth 2.0 umum, seperti skenario untuk server web.

Dokumen ini menjelaskan cara meneruskan token OAuth ke panggilan Navigation Connect di lingkungan pengembangan Anda. Untuk mengetahui informasi selengkapnya tentang cara menggunakan OAuth di lingkungan produksi, lihat Metode autentikasi di Google.

Anda dapat memanggil Google Maps API secara langsung dengan membuat permintaan API ke server, atau Anda dapat menggunakan library klien untuk menyederhanakan kode Anda. Google Maps menyediakan library klien untuk Go, Java, Node.js, dan Python. Untuk mengetahui informasi selengkapnya, lihat Library klien Navigation Connect.

Ringkasan OAuth

Anda dapat membuat dan mengelola token akses dengan OAuth dalam beberapa cara, bergantung pada lingkungan deployment Anda.

Anda dapat menggunakan OAuth 2.0 untuk interaksi server ke server antara aplikasi Anda dan layanan Google. Untuk skenario ini, Anda menggunakan akun layanan yang terkait dengan aplikasi Anda, bukan pengguna perorangan. Anda dapat membuat permintaan API menggunakan akun layanan tanpa melibatkan pengguna secara langsung. Untuk mengetahui informasi selengkapnya tentang metode autentikasi, lihat Metode autentikasi di Google.

Atau, Anda dapat mengintegrasikan Navigation Connect ke aplikasi seluler Android atau iOS. Untuk mengetahui informasi selengkapnya tentang penggunaan OAuth dan pengelolaan token akses untuk lingkungan deployment yang berbeda, lihat Menggunakan OAuth 2.0 untuk Mengakses Google API.

Cakupan OAuth

Untuk menggunakan OAuth dengan Navigation Connect, Anda harus menetapkan cakupan berikut ke token OAuth:

https://www.googleapis.com/auth/cloud-platform

Contoh: Mencoba panggilan REST API di lingkungan pengembangan lokal Anda

Jika Anda tidak memiliki lingkungan yang menghasilkan token dan ingin mencoba Navigation Connect dengan token OAuth, gunakan prosedur di bagian ini.

Contoh ini menjelaskan cara menggunakan token OAuth yang disediakan oleh Kredensial Default Aplikasi (ADC) untuk melakukan panggilan. Untuk mengetahui informasi selengkapnya tentang cara menggunakan ADC untuk memanggil Google API dengan library klien, lihat Mengautentikasi menggunakan library klien.

Gunakan prosedur REST berikut hanya untuk pengembangan atau pengujian, bukan untuk produksi.

Prasyarat

Sebelum membuat permintaan REST menggunakan ADC, gunakan CLI gcloud untuk memberikan kredensial ke ADC:

  1. Instal dan lakukan inisialisasi CLI gcloud. Untuk mengetahui informasi selengkapnya, lihat artikel Menginstal gcloud CLI.

  2. Lakukan autentikasi dengan CLI gcloud:

    gcloud auth application-default login

  3. Selesaikan proses login untuk menyimpan kredensial Anda di file kredensial lokal yang digunakan oleh ADC.

Untuk mengetahui informasi selengkapnya, lihat Menyiapkan ADC untuk lingkungan pengembangan lokal.

Membuat permintaan REST

Dalam contoh ini, Anda meneruskan dua header permintaan:

  • Teruskan token OAuth di header Authorization menggunakan perintah berikut untuk membuat token:

    gcloud auth application-default print-access-token

    Token yang ditampilkan memiliki cakupan https://www.googleapis.com/auth/cloud-platform.

  • Teruskan ID atau nama project Google Cloud Anda yang telah mengaktifkan penagihan di header X-Goog-User-Project.

Untuk memanggil Navigation Connect menggunakan token OAuth, selesaikan langkah-langkah berikut:

  1. Dalam contoh kode berikut, ganti placeholder dengan nilai Anda:

    • PROJECT_ID: project ID Google Cloud Anda
    • ANDROID_APP_ID: nama paket Android aplikasi Anda, jika berlaku
    • IOS_APP_ID: ID paket iOS aplikasi Anda, jika berlaku
    #!/bin/bash
trip_id="$(uuidgen)"
access_token="$(gcloud auth application-default print-access-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 '{
"androidAppId": "ANDROID_APP_ID",
"iosAppId": "IOS_APP_ID",
}'

  2. Untuk menyalin perintah curl, klik Salin di contoh kode.

  3. Tempelkan perintah di jendela terminal, lalu eksekusi.

Responsnya adalah objek JSON:

{
  "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 bilangan bulat panjang unik untuk project
  • TRIP_ID: ID perjalanan UUIDv4 yang dihasilkan backend Anda
  • BASE64_ENCODED_TRIP_TOKEN: token yang diautentikasi yang ditampilkan oleh metode createTrip untuk memulai navigasi belokan demi belokan yang dilacak di Google Maps atau Waze

Pemecahan masalah

Jika permintaan Anda menampilkan pesan error yang menyatakan bahwa API ini tidak mendukung kredensial pengguna akhir, lihat Memecahkan masalah penyiapan ADC.

Langkah berikutnya

Selanjutnya, konfigurasi akun layanan Anda untuk Navigation Connect API guna mendukung komunikasi server-ke-server yang aman antara infrastruktur backend, Google Maps, dan Waze.

Menyiapkan akun layanan Anda