Parameter permintaan yang diperlukan

Untuk membuat permintaan ke Map Management API, Anda harus menyertakan hal berikut di header dan URL:

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

  • Header Otorisasi: Token OAuth 2.0 di header Authorization. Untuk mengetahui informasi selengkapnya, lihat Menggunakan OAuth.

  • Nama Resource: Nomor atau ID project Google Cloud di URL permintaan, beserta ID resource tertentu (seperti mapConfigId atau styleConfigId).

Contoh: Membuat MapConfig

Contoh berikut menunjukkan cara membuat objek MapConfig menggunakan curl. Saat Anda mengirim permintaan ini, Anda akan menerima objek yang baru dibuat sebagai respons jika pembuatan MapConfig berhasil diselesaikan.

curl -X POST \
-H 'X-Goog-User-Project: YOUR_PROJECT_NUMBER' \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
https://mapmanagement.googleapis.com/v2beta/projects/YOUR_PROJECT_NUMBER/mapConfigs -d '{
  "displayName": "My New York Map",
  "description": "A Map for New York City",
  "mapType" : "VECTOR",
  "mapFeatures": {
    "simpleFeatures": ["FLATTEN_BUILDINGS", "ICONIC_ICONS"],
    "poiBoostLevel": 1
  }
}'

Jika permintaan berhasil, Anda akan menerima objek Konfigurasi Peta yang baru dibuat: 

{
  "name": "projects/YOUR_PROJECT_NUMBER/mapConfigs/YOUR_MAP_CONFIG_ID",
  "displayName": "Testing No Type",
  "description": "Testing",
  "mapId": "YOUR_MAP_CONFIG_ID",
  "mapFeatures": {
    "simpleFeatures": [
      "FLATTEN_BUILDINGS",
      "ICONIC_ICONS"
    ],
    "poiBoostLevel": 1
  },
  "createTime": "2026-02-07T20:04:11.467243390Z",
  "updateTime": "2026-02-07T20:04:11.467243542Z",
  "mapType": "VECTOR"
}

Contoh: Menghapus MapConfig

Contoh berikut menunjukkan cara menghapus objek MapConfig menggunakan curl. Saat Anda mengirim permintaan ini, Anda akan menerima objek JSON kosong {} sebagai respons jika MapConfig ditemukan dan berhasil dihapus.

curl -X DELETE \
-H 'X-Goog-User-Project: YOUR_PROJECT_NUMBER' \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
https://mapmanagement.googleapis.com/v2beta/projects/YOUR_PROJECT_NUMBER/mapConfigs/YOUR_MAP_CONFIG_ID

Jika permintaan berhasil, Anda akan menerima objek respons kosong: 

{}

Mendapatkan nomor project

Untuk mendapatkan nomor atau ID project Google Cloud Anda:

  1. Buka halaman Ringkasan project di Konsol cloud.
  2. Nomor project dan ID project akan muncul di area Info project.

Mendapatkan token OAuth

Untuk pengembangan atau pengujian, Anda dapat menggunakan gcloud CLI untuk membuat token OAuth sementara:

gcloud auth application-default print-access-token

Anda dapat menyertakan perintah gcloud langsung di header Authorization permintaan curl seperti yang ditunjukkan dalam contoh sebelumnya. Atau, tetapkan variabel lingkungan:

export TOKEN=$(gcloud auth application-default print-access-token)
curl -X GET \
-H 'X-Goog-User-Project: YOUR_PROJECT_NUMBER' \
-H "Authorization: Bearer $TOKEN" \
https://mapmanagement.googleapis.com/v2beta/projects/YOUR_PROJECT_NUMBER/mapConfigs