Menyiapkan Navigation Connect

Developer Wilayah Ekonomi Eropa (EEA)

Jika alamat penagihan Anda berada di Wilayah Ekonomi Eropa, mulai 8 Juli 2025, Persyaratan Layanan Google Maps Platform EEA akan berlaku untuk penggunaan Layanan oleh Anda. Fungsi bervariasi menurut wilayah. Pelajari lebih lanjut.

Dokumen ini menjelaskan langkah-langkah yang diperlukan untuk mulai menggunakan Navigation Connect.

1. Akun dan penagihan Pastikan Anda memenuhi prasyarat.

2. Aktifkan API Aktifkan API di project Google Cloud Anda.

3. Membuat permintaan pertama Anda Konfigurasi OAuth untuk membuat permintaan API yang terautentikasi.

Produk Google Maps Platform dilindungi dari penggunaan yang tidak sah dengan mewajibkan panggilan API menyertakan token OAuth.

Membuat token OAuth

Navigation Connect mendukung penggunaan 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 petunjuk tentang cara menggunakan OAuth di lingkungan produksi, lihat Metode autentikasi di Google.

Catatan:

Meskipun Anda dapat menggunakan Google Maps API secara langsung dengan membuat permintaan API ke server, library klien memberikan penyederhanaan yang secara signifikan mengurangi jumlah kode yang perlu Anda tulis. Google Maps menyediakan library klien untuk banyak bahasa pemrograman, termasuk Go, Java, Node.js, dan Python.

Lihat Navigation Connect Client Libraries untuk dokumentasi dan contoh.

Tentang OAuth

Ada banyak cara untuk membuat dan mengelola token akses dengan OAuth berdasarkan lingkungan deployment Anda.

Misalnya, sistem OAuth 2.0 Google mendukung interaksi server-ke-server, seperti interaksi antara aplikasi Anda dan layanan Google. Untuk skenario ini, Anda memerlukan akun layanan, yaitu akun milik aplikasi Anda, bukan milik pengguna akhir individu. Aplikasi Anda memanggil Google API atas nama akun layanan, sehingga pengguna tidak terlibat secara langsung. Untuk mengetahui informasi selengkapnya tentang metode autentikasi, lihat Metode autentikasi di Google.

Atau, Anda dapat menggunakan Navigation Connect sebagai bagian dari aplikasi seluler Android atau iOS. Untuk informasi umum tentang penggunaan OAuth dengan Navigation Connect, termasuk informasi tentang pengelolaan token akses untuk lingkungan deployment yang berbeda, lihat Menggunakan OAuth 2.0 untuk Mengakses Google API.

Tentang cakupan OAuth

Untuk menggunakan OAuth dengan Navigation Connect, token OAuth harus diberi cakupan:

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

Contoh: Mencoba panggilan REST API di lingkungan pengembangan lokal Anda

Jika ingin mencoba Navigation Connect menggunakan token OAuth, tetapi tidak memiliki penyiapan lingkungan untuk membuat token, Anda dapat menggunakan prosedur di bagian ini untuk melakukan panggilan.

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

Catatan: Prosedur di bawah untuk melakukan panggilan REST tidak dimaksudkan untuk digunakan di lingkungan produksi. Gunakan prosedur ini hanya untuk lingkungan pengembangan atau pengujian.

Prasyarat

Sebelum Anda dapat membuat permintaan REST menggunakan ADC, gunakan Google Cloud CLI untuk memberikan kredensial ke ADC:

1. Instal dan lakukan inisialisasi gcloud CLI.

2. Jalankan perintah gcloud berikut di komputer lokal Anda untuk membuat file kredensial:

   gcloud auth application-default login

3. Layar login akan ditampilkan. Setelah Anda login, kredensial Anda akan disimpan dalam 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.

Contoh berikut melakukan panggilan ke Navigation Connect menggunakan token OAuth.

1. Edit kolom PROJECT_ID untuk meneruskan ID project Google Cloud Anda.

   Edit juga hal berikut, jika berlaku:

   • ANDROID_APP_ID: Nama paket Android aplikasi Anda.
   • IOS_APP_ID: ID Paket iOS aplikasi Anda.

   #!/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. Klik ikon salin di contoh kode, , untuk menyalin perintah curl.
3. Tempel perintah di jendela terminal, lalu jalankan perintah.

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 yang dibuat oleh backend Anda dalam format UUIDv4.
• BASE64_ENCODED_TRIP_TOKEN: Token terautentikasi yang ditampilkan oleh metode createTrip. Teruskan token ini ke aplikasi seluler Anda untuk memulai navigasi belokan demi belokan yang dilacak di Google Maps atau Waze.

Pemecahan masalah

Jika permintaan Anda menampilkan pesan error tentang kredensial pengguna akhir yang tidak didukung oleh API ini, lihat Memecahkan masalah penyiapan ADC.

Langkah berikutnya

Langkah berikutnya untuk menyiapkan Navigation Connect API adalah menyiapkan akun layanan Anda untuk mengaktifkan komunikasi server-ke-server yang aman antara infrastruktur backend Anda dan Google Maps serta Waze.

Menyiapkan akun layanan Anda