Map Management API'ye genel bakış

Map Management API, bulut tabanlı harita stilleri kaynaklarınızı programatik olarak yönetmek için kullanabileceğiniz bir RESTful API'dir. Bu API ile haritalarınızın görsel görünümünü tanımlayabilir, harita kimliklerini yönetebilir ve özel stiller ile veri kümelerini belirli harita varyantlarıyla ilişkilendirebilirsiniz. Tüm bunları Cloud Console'u kullanmadan yapabilirsiniz.

Map Management API, harita yapılandırmalarını büyük ölçekte yönetmek veya harita stilini kendi otomatik iş akışlarına ve dahili araçlarına entegre etmek isteyen geliştiriciler için tasarlanmıştır.

Önemli Kaynaklar

  • StyleConfig: Harita stilinin JSON gösterimini içerir. Bu, harita özelliklerinin renklerini, görünürlüğünü ve yoğunluğunu tanımlar.
  • MapConfig: Benzersiz bir harita kimliğini (harita kimliği) temsil eder. ÖY güçlendirme veya bina düzleştirme gibi stil ayarları ve özellikler için kapsayıcı görevi görür.
  • MapContextConfig: Bir StyleConfig'yi (ve isteğe bağlı olarak bir veya daha fazla veri kümesini) bir MapConfig içindeki belirli MapVariants ile ilişkilendirir.

API Sürümü Oluşturma Kanalları

Map Management API, deneysel özelliklerden kararlı ve genel kullanıma sunulma tarihine geçiş için net bir yol sağlamak amacıyla kanal tabanlı sürüm oluşturma yöntemini kullanır.

  • v2alpha (Deneysel): En yeni deneysel özellikleri içerir. Bu kanaldaki özellikler önceden haber verilmeksizin değiştirilebilir ve üretimde kullanılması önerilmez.
  • v2beta (Önizleme): Kararlı olan ve genel kullanıma sunulma tarihi için hazırlanan özellikleri içerir. Bu kanal, üretim öncesi ortamlarda ilk kullanıcılar ve test için uygundur.
  • v2 (Genel Kullanıma Sunulma Tarihi): Tam olarak desteklenen, üretime hazır özellikler içerir.

Sürüm 2 özelliklerinin çoğu, kullanıma sunma aşamalarında hem v2alpha hem de v2beta uç noktalarında kullanılabilir. Google, yeni kullanıcıların v2beta uç noktasıyla başlamasını önerir.

Kimlik doğrulama

Map Management API ile kimlik doğrulaması yapmak için yalnızca OAuth 2.0'ı kullanabilirsiniz. Bu API, API anahtarlarını desteklemez. Daha fazla bilgi için OAuth'u kullanma başlıklı makaleyi inceleyin.

Sınırlamalar

  • Geliştirici Rolleri: Map Management API'yi kullanmak için Google Cloud projenizdeki Google Haritalar Platformu kaynaklarını yönetmek üzere gerekli IAM izinlerine sahip olmanız gerekir.
  • Kaynak Kapsamı: Bu API, bulut tabanlı harita stili kaynaklarının yönetimine odaklanır. Diğer Google Haritalar Platformu yapılandırmaları için Cloud konsolu gerekebilir.

Maliyetler

Map Management API'nin kullanımı ücretsizdir. API çağrıları, Cloud Console'daki Faturalandırma sayfasında görünür ancak ücretler 0 ABD doları olur. Ancak istekler şu şekilde kısıtlanır:

  • 3 QPS (saniyedeki sorgu sayısı)
  • Proje için 180 QPM (dakika başına sorgu sayısı), her dakika yenilenir.
  • Bir proje için günlük 100.000 sorgu (her gün yenilenir)

Kullanım ve faturalandırma başlıklı makaleyi inceleyin.