Panduan dan Contoh Map Management API

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

Ringkasan operasi

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

  1. Membuat StyleConfig: Tentukan tampilan visual peta Anda menggunakan representasi JSON untuk setelan warna, visibilitas, dan kepadatan.
  2. Membuat 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 Anda.

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 secara eksplisit menetapkan map_type ke VECTOR di MapConfig.
  • Varian Peta: 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 default tanpa gaya akan digunakan.

Menggunakan StyleConfig

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 StyleConfig

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

Menggunakan 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"
}'

Menggunakan MapContextConfig

MapContextConfig menautkan gaya visual 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 memiliki format yang salah atau berisi nilai kolom yang tidak valid.