Harita Yönetimi API Kılavuzu ve Örnekleri

Map Management API'yi kullanarak hem v2alpha (Deneysel) hem de v2beta (Önizleme) uç noktalarındaki bulut tabanlı harita stilleri kaynaklarınızı programatik olarak yönetebilirsiniz.

İşlemlerin özeti

Harita Yönetimi API'si ile özel bir haritayı görselleştirmek için aşağıdaki temel adımları uygulayın:

  1. StyleConfig oluşturma: Renk, görünürlük ve yoğunluk ayarlarının JSON gösterimini kullanarak haritanızın görsel görünümünü tanımlayın.
  2. MapConfig oluşturun: Haritanızın kimliği ve üst düzey özellikleri için kapsayıcı görevi gören benzersiz bir harita kimliği oluşturun.
  3. Bunları bir MapContextConfig ile ilişkilendirin: StyleConfig (ve isteğe bağlı veri kümeleri) öğenizi MapConfig içindeki belirli harita varyantlarına (ör. ROADMAP veya SATELLITE) bağlayın.

Varsayılan Davranışlar

v2 uç noktalarını kullanırken aşağıdaki varsayılan davranışları göz önünde bulundurun:

  • Harita Türü: Varsayılan harita oluşturma türü RASTER'dır. Vektör tabanlı haritaları kullanmak için map_type öğesini MapConfig içinde açıkça VECTOR olarak ayarlamanız gerekir.
  • Varyantı Eşle: map_variants belirtilmeden MapContextConfig oluşturulursa yapılandırma varsayılan olarak yalnızca ROADMAP varyantına uygulanır.
  • Temel Stil: Bir json_style_sheet boşsa veya StyleConfig içinde sağlanmamışsa varsayılan, stil uygulanmamış Google temel haritası kullanılır.

StyleConfig'lerle çalışma

StyleConfig, JSON tabanlı stil tanımlarını içerir.

StyleConfig oluşturma

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

StyleConfig'leri listeleme

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

MapConfig'lerle çalışma

MapConfig, bir haritanın kimliğini ve temel oluşturma türünü tanımlar.

MapConfig oluşturma

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

MapContextConfigs ile çalışma

MapContextConfig, stili MapConfig ile ilişkilendirir.

MapContextConfig oluşturma

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

Hatalar

  • PERMISSION_DENIED: İstek yeterli IAM iznine sahip değil veya projede API etkinleştirilmemiş.
  • NOT_FOUND: Belirtilen kaynak (Proje, MapConfig veya StyleConfig) mevcut değil.
  • INVALID_ARGUMENT: İstek gövdesi yanlış biçimlendirilmiş veya geçersiz alan değerleri içeriyor.