Panduan dan Contoh Map Management API

Anda dapat menggunakan Map Management API untuk mengelola resource gaya peta berbasis cloud secara terprogram di seluruh endpoint v2alpha (Eksperimental) dan v2beta (Pratinjau).

Ringkasan operasi

Untuk memvisualisasikan peta kustom dengan Map Management API, ikuti langkah-langkah utama berikut:

  1. Buat StyleConfig: Tentukan tampilan visual peta Anda menggunakan representasi JSON dari setelan warna, visibilitas, dan kepadatan.
  2. Buat MapConfig: Buat ID Peta unik yang berfungsi sebagai penampung untuk identitas dan fitur tingkat tinggi peta Anda.
  3. Kaitkan dengan MapContextConfig: Tautkan StyleConfig (dan set data opsional) ke varian peta tertentu (seperti ROADMAP atau SATELLITE) dalam MapConfig.

Perilaku Default

Saat menggunakan endpoint v2, perhatikan perilaku default berikut:

  • Jenis Peta: Jenis rendering peta default adalah RASTER. Untuk menggunakan peta berbasis vektor, Anda harus menetapkan map_type ke VECTOR secara eksplisit di MapConfig.
  • Map Variant: Jika tidak ada map_variants yang ditentukan saat membuat MapContextConfig, konfigurasi hanya akan diterapkan ke varian ROADMAP secara default.
  • Gaya Visual Dasar: Jika json_style_sheet kosong atau tidak disediakan dalam StyleConfig, peta Dasar Google yang tidak memiliki gaya visual default akan digunakan.

Bekerja dengan StyleConfigs

StyleConfig berisi definisi gaya visual berbasis JSON.

Membuat StyleConfig

curl -X POST \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json" \
https://mapmanagement.googleapis.com/v2beta/projects/YOUR_PROJECT_ID/styleConfigs \
-d '{
  "display_name": "My Custom Style",
  "json_style_sheet": "[{\"featureType\":\"all\",\"stylers\":[{\"saturation\":-100}]}]"
}'

Mencantumkan StyleConfigs

curl -X GET \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
https://mapmanagement.googleapis.com/v2beta/projects/YOUR_PROJECT_ID/styleConfigs

Menangani MapConfig

MapConfig menentukan identitas dan jenis rendering inti peta.

Membuat MapConfig

curl -X POST \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json" \
https://mapmanagement.googleapis.com/v2beta/projects/YOUR_PROJECT_ID/mapConfigs \
-d '{
  "display_name": "My New Map",
  "map_type": "VECTOR"
}'

Menangani MapContextConfigs

MapContextConfig menautkan gaya ke MapConfig.

Membuat MapContextConfig

curl -X POST \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json" \
https://mapmanagement.googleapis.com/v2beta/projects/YOUR_PROJECT_ID/mapConfigs/YOUR_MAP_ID/mapContextConfigs \
-d '{
  "style_config": "projects/YOUR_PROJECT_ID/styleConfigs/YOUR_STYLE_ID",
  "map_variants": ["ROADMAP", "NAVIGATION"]
}'

Error

  • PERMISSION_DENIED: Permintaan tidak memiliki izin IAM yang memadai atau project tidak mengaktifkan API.
  • NOT_FOUND: Resource yang ditentukan (Project, MapConfig, atau StyleConfig) tidak ada.
  • INVALID_ARGUMENT: Isi permintaan salah format atau berisi nilai kolom yang tidak valid.