Maps Datasets API saat ini berada dalam Pratinjau (pra-GA). Produk dan fitur pra-GA mungkin memiliki dukungan terbatas, dan perubahan pada produk serta fitur pra-GA mungkin tidak kompatibel dengan versi pra-GA lainnya. Penawaran Pra-GA tercakup dalam Persyaratan Khusus Layanan Google Maps Platform. Untuk informasi selengkapnya, lihat deskripsi tahap peluncuran.

Halaman ini diterjemahkan oleh Cloud Translation API.

Parameter permintaan yang diperlukan

Untuk membuat permintaan ke Maps Datasets API, Anda harus menyertakan:

Nomor atau ID project Google Cloud Anda di X-Goog-User-Project header permintaan. Nilai ini menentukan project yang digunakan untuk penghitungan kuota penggunaan dan penagihan.

Catatan: Jika menggunakan akun layanan untuk autentikasi, Anda dapat menghilangkan header X-Goog-User-Project. Untuk mengetahui informasi selengkapnya tentang akun layanan, lihat Authentication di Google.
Token OAuth di header Authorization permintaan. Untuk selengkapnya informasi tentang cara menggunakan OAuth dengan Maps Datasets API, lihat Gunakan OAuth.
Nomor atau ID project Google Cloud di URL permintaan. Nilai ini menentukan project yang berisi set data. Meskipun proyek ini biasanya sama dengan project yang ditentukan dalam header X-Goog-User-Project, tidak harus sama.
ID set data di URL permintaan. Setiap kali Anda melakukan tindakan pada {i>dataset<i} tertentu, Anda meneruskan ID {i>dataset<i} sebagai bagian dari URL permintaan.

Misalnya, untuk menghapus set data:

curl -X DELETE \
-H 'X-Goog-User-Project: PROJECT_NUMBER_OR_ID' \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/DATASET_ID

Mendapatkan nomor project

Untuk mendapatkan PROJECT_NUMBER_OR_ID project Google Cloud Anda:

Buka dokumen Halaman Ringkasan di Konsol Cloud.
Jika diminta, pilih project Anda.
Project number dan Project ID muncul di Project info layar ringkasan.

Mendapatkan token OAuth

Untuk autentikasi, permintaan API Anda harus berisi token OAuth di bagian Header Authorization. Untuk mengetahui informasi selengkapnya, lihat Menggunakan OAuth.

Misalnya, gunakan perintah gcloud berikut untuk membuat token:

gcloud auth application-default print-access-token

Anda dapat menyertakan perintah gcloud langsung di header Authorization dalam Perintah cURL untuk menghasilkan token baru di setiap permintaan, seperti yang ditunjukkan pada contoh di atas.

Atau, Anda dapat menetapkan variabel lingkungan yang berisi token, lalu teruskan variabel lingkungan sebagai bagian dari permintaan:

export TOKEN=$(gcloud auth application-default print-access-token)
curl -X DELETE \
-H 'X-Goog-User-Project: PROJECT_NUMBER_OR_ID' \
-H "Authorization: Bearer $TOKEN" \
https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/DATASET_ID