Panduan dan Contoh Map Management API

Anda dapat menggunakan Map Management API untuk mengelola resource gaya visual 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 bertindak sebagai penampung untuk identitas dan fitur tingkat tinggi peta Anda.
  3. Asosiasikan 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 menetapkan map_type secara eksplisit 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 di StyleConfig, Peta Dasar Google tanpa gaya visual default akan digunakan.

Menangani 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

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 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 salah format atau berisi nilai kolom yang tidak valid.