Dokumen ini menjelaskan langkah-langkah yang Anda perlukan untuk mulai menggunakan Navigation Connect.
Prasyarat
Panduan ini menunjukkan cara menyiapkan Akun Google Cloud dan project Google Cloud dengan penagihan yang diaktifkan. Anda juga harus memahami cara penagihan untuk penggunaan Navigation Connect API.
- Tinjau penagihan dan biaya penggunaan di Penggunaan dan Penagihan Navigation Connect.
-
Pastikan bahwa Anda memiliki Akun Google Cloud.
Login ke Konsol Google Cloud -
Pastikan Anda memiliki project Google Cloud dengan penagihan yang diaktifkan.
Buka halaman Penagihan- Pilih project Anda untuk membuka halaman Billing.
-
Di halaman Penagihan:
- Jika penagihan telah diaktifkan untuk project yang dipilih, dan Anda hanya memiliki satu akun penagihan, halaman Billing akan terbuka.
- Jika Anda memiliki beberapa akun penagihan, pilih Go to linked billing account untuk melihat detail tentang akun penagihan yang terkait dengan project.
- Jika sudah memiliki akun penagihan, tetapi belum dikaitkan dengan project, Anda akan diminta untuk menautkan akun penagihan dengan project.
- Jika belum memiliki akun penagihan, atau Anda ingin membuat akun penagihan baru, pilih Manage Billing Accounts untuk membuat akun penagihan baru. Untuk mengetahui informasi selengkapnya, lihat Membuat akun Penagihan Cloud layanan mandiri baru.
Mengaktifkan API dan memverifikasi aplikasi Anda
Panduan ini menjelaskan proses untuk mengaktifkan Navigation Connect API dan memverifikasi aplikasi Anda di Konsol Google Cloud, yang memungkinkan aplikasi Anda berinteraksi dengan aman dengan Google Maps dan Waze. Anda harus menyelesaikan proses ini untuk menggunakan Navigation Connect API.
1. Mengaktifkan Navigation Connect API
Gunakan Konsol Google Cloud atau perintah gcloud untuk mengaktifkan Navigation Connect API di project cloud Google Anda.
Untuk mengaktifkan API, lakukan langkah-langkah berikut:
Konsol
Buka halaman produk di Konsol Google Cloud:
Mengaktifkan Navigation Connect APIKlik tombol Enable.
gcloud
gcloud services enable \ --project "PROJECT" \ "navigationconnect.googleapis.com"
Baca selengkapnya tentang Google Cloud SDK, Penginstalan Cloud SDK, dan perintah berikut:
2. Memulai proses verifikasi aplikasi
Setelah mengaktifkan API, Anda harus memverifikasi aplikasi untuk mengaktifkan Navigation Connect API. Mengaktifkan API saja tidak akan memberikan akses; Anda harus memberikan detail bisnis dan aplikasi untuk ditinjau sebelum dapat menggunakan Navigation Connect API.
Untuk memulai proses verifikasi, gunakan salah satu metode berikut:
-
API Marketplace:
- Di API Marketplace, temukan kartu Navigation Connect API.
- Klik ikon Verifikasi diperlukan berwarna biru untuk memulai alur verifikasi.
-
Kunci & Kredensial di Konsol Google Cloud:
- Di Konsol Google Cloud, buka halaman Keys & Credentials.
- Klik Navigation Connect Keys and Credentials.
- Di banner, klik Mulai verifikasi.
3. Memberikan detail aplikasi, pengumpulan data, dan privasi
Tabel berikut menjelaskan detail yang harus Anda berikan untuk verifikasi aplikasi:
| Kolom | Deskripsi |
|---|---|
| Detail aplikasi Berikan detail berikut untuk memastikan aplikasi Anda ditampilkan dengan benar di Google Maps dan Waze. |
|
| Nama bisnis atau aplikasi | Masukkan nama yang akan ditampilkan kepada pengguna di Google Maps dan Waze. |
| ID aplikasi | Berikan Nama Paket Android atau ID Paket iOS Anda. |
| Link universal iOS | Berikan link universal iOS yang memungkinkan pengguna kembali ke aplikasi Anda (hanya tersedia di Waze). |
| Logo aplikasi (khusus Waze) | (Opsional) Upload logo PNG atau JPG (32x32 hingga 128x128 piksel) untuk menampilkan logo aplikasi Anda di Waze selama sesi navigasi. |
| Detail pengumpulan data dan privasi Masukkan detail berikut untuk memastikan transparansi, kepercayaan pengemudi, dan keamanan data. |
|
| Link kebijakan privasi | Berikan URL kebijakan privasi aplikasi Anda. Link ini muncul di layar izin. |
| Pengontrol data tambahan (Opsional) | Berikan nama dagang dan link kebijakan privasi untuk pengelola data pihak ketiga, seperti ISV. Detail ini akan muncul di layar izin. |
| Kepatuhan data | Jika aplikasi Anda beroperasi di Amerika Serikat, centang kotak This app will be used for trips occurring in the United States untuk memastikan kepatuhan terhadap peraturan setempat. |
4. Tinjau dan kirim
Tinjau ringkasan informasi yang Anda berikan sebelum mengirimkan aplikasi untuk verifikasi.
-
Tinjau dengan cermat nama, platform, ID, dan link aplikasi Anda.
- Centang kotak Semua informasi sudah akurat.
- Klik Kirim.
Setelah Anda mengirimkan aplikasi untuk verifikasi, fase peninjauan akan dimulai.
- Linimasa: Verifikasi biasanya memerlukan waktu 1-3 hari kerja.
- Notifikasi: Anda akan menerima email saat status verifikasi berubah. Anda juga akan menerima email yang meminta ID profil pembayaran atau ID developer Android Anda. Jika Anda memerlukan ID developer Android, lihat Membuat akun developer.
- Pelacakan status: Pantau progres Anda di halaman Kunci dan Kredensial di Konsol Google Cloud.
- Dukungan: Untuk memperbarui konfigurasi setelah persetujuan tanpa memengaruhi produksi, buat tiket dukungan.
Setelah diverifikasi, aplikasi Anda akan diizinkan menggunakan Navigation Connect API untuk membuat token perjalanan yang mengizinkan akses ke sesi navigasi dan memungkinkan Anda menerima detail perjalanan dari Google Maps dan Waze.
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 penggunaan 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 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 informasi selengkapnya tentang penggunaan OAuth dan pengelolaan token akses untuk berbagai lingkungan deployment, 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 Melakukan autentikasi menggunakan library klien.
Gunakan prosedur REST berikut hanya untuk pengembangan atau pengujian, bukan untuk produksi.
Prasyarat
Sebelum membuat permintaan REST menggunakan ADC, gunakan gcloud CLI untuk memberikan kredensial ke ADC:
Menginstal dan melakukan inisialisasi
gcloudCLI. Untuk mengetahui informasi selengkapnya, lihat Menginstal gcloud CLI.Lakukan autentikasi dengan
gcloudCLI:gcloud auth application-default login
Selesaikan proses login untuk menyimpan kredensial Anda 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
Authorizationmenggunakan perintah berikut untuk membuat token:gcloud auth application-default print-access-tokenToken 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:
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 ada
- IOS_APP_ID: ID paket iOS aplikasi Anda, jika ada
#!/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", }'
Untuk menyalin perintah
curl, klik Copy di contoh kode.Tempel perintah di jendela terminal, lalu jalankan.
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 yang unik untuk project
- TRIP_ID: ID perjalanan UUIDv4 yang dihasilkan backend Anda
- BASE64_ENCODED_TRIP_TOKEN: token yang diautentikasi yang ditampilkan oleh metode
createTripuntuk 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, konfigurasikan akun layanan Anda untuk Navigation Connect API guna mendukung komunikasi server-ke-server yang aman antara infrastruktur backend, Google Maps, dan Waze.