Roads Selection API menggunakan Roads Selection API sebagai komponen inti yang menyediakan data jalan ke BigQuery dan Pub/Sub.
Roads Selection API 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 API Roads Selection di lingkungan pengembangan Anda. Untuk mengetahui informasi selengkapnya tentang penggunaan OAuth di lingkungan produksi, lihat Autentikasi di Google.
Sebelum memulai
Sebelum mulai menggunakan Roads Selection API, Anda harus memiliki project dengan akun penagihan dan Roads Selection API yang aktif. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan project di Konsol Cloud.
Tentang OAuth
Anda dapat membuat dan mengelola token akses dengan OAuth dalam beberapa cara, bergantung pada lingkungan deployment Anda.
Misalnya, sistem Google OAuth 2.0 mendukung interaksi server ke server, seperti interaksi antara aplikasi Anda dan layanan Google. Untuk skenario ini, Anda harus memiliki akun layanan, yaitu akun milik aplikasi Anda, bukan milik pengguna perorangan. Aplikasi Anda memanggil Google API atas nama akun layanan karena pengguna tidak terlibat secara langsung. Untuk mengetahui informasi selengkapnya tentang metode autentikasi, lihat Autentikasi di Google.
Atau, Anda dapat menggunakan Roads Selection API sebagai bagian dari aplikasi seluler Android atau iOS. Untuk informasi selengkapnya tentang penggunaan OAuth dengan Roads Selection API, termasuk informasi tentang cara mengelola token akses untuk berbagai lingkungan deployment, lihat Menggunakan OAuth 2.0 untuk Mengakses Google API.
Tentang cakupan OAuth
Untuk menggunakan OAuth dengan Roads Selection API, token OAuth harus memiliki cakupan https://www.googleapis.com/auth/cloud-platform.
Contoh: Mencoba panggilan REST API di lingkungan pengembangan lokal Anda
Jika Anda ingin mencoba Roads Selection API menggunakan token OAuth, tetapi tidak memiliki lingkungan yang disiapkan untuk membuat token, ikuti prosedur di bagian ini untuk membuat permintaan.
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.
Prasyarat
Sebelum Anda dapat membuat permintaan REST menggunakan ADC, gunakan Google Cloud CLI untuk memberikan kredensial ke ADC:
- Jika Anda belum melakukannya, buat project dan aktifkan penagihan dengan mengikuti langkah-langkah di Menyiapkan di Konsol Cloud.
- Instal dan lakukan inisialisasi gcloud CLI.
Untuk membuat file kredensial, jalankan perintah
gclouddi komputer lokal Anda:gcloud auth application-default login
- Login jika diminta. Setelah Anda login, kredensial Anda akan disimpan dalam file kredensial lokal yang digunakan oleh ADC.
Untuk mengetahui informasi selengkapnya, lihat bagian Lingkungan pengembangan lokal dalam dokumentasi Menyediakan kredensial untuk Kredensial Default Aplikasi.
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 informasi selengkapnya, lihat Menyiapkan project di Konsol Cloud.
Lakukan panggilan ke Roads Selection API menggunakan token OAuth:
curl -X GET \ -H 'X-Goog-User-Project: PROJECT_NUMBER' \ -H 'Authorization: Bearer ACCESS_TOKEN' \ https://roads.googleapis.com/selection/v1/projects/PROJECT_NUMBER/selectedRoutes/SELECTED_ROUTE_ID
Pemecahan masalah
Jika permintaan Anda menampilkan pesan error tentang kredensial pengguna akhir yang tidak didukung oleh API ini, lihat Kredensial pengguna tidak berfungsi.