Map Management API'ye genel bakış

Map Management API, bulut tabanlı harita stili kaynaklarınızı programatik olarak yönetmek için kullanabileceğiniz bir RESTful API'dir. Bu API ile, Cloud Console'u kullanmadan 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.

Harita Yönetimi API'si, harita yapılandırmalarının büyük ölçekli yönetimini gerçekleştirmek 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: Bir 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. Stil ayarları ve ÖY güçlendirme veya bina düzleştirme gibi özellikler için kapsayıcı görevi görür.
  • MapContextConfig: Bir StyleConfig (ve isteğe bağlı olarak bir veya daha fazla veri kümesi) ile bir MapConfig içindeki belirli MapVariants'leri ilişkilendirir.

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

Harita Yönetimi API'si, deneysel özelliklerden kararlı ve genel kullanıma sunulma tarihine geçiş için net bir yol sağlamak amacıyla kanala dayalı sürüm oluşturma yöntemini kullanır.

  • v2alpha (Deneysel): En yeni deneysel özellikleri içerir. Bu kanaldaki özellikler bildirimde bulunulmaksızın değiştirilebilir ve üretimde kullanılmaları önerilmez.
  • v2beta (önizleme): Kararlı olan ve genel kullanıma sunulma tarihi için hazırlanan özellikleri içerir. Bu kanal, üretim öncesi ortamlarda erken benimseme ve test için uygundur.
  • v2 (Genel Kullanıma Sunma): Tam olarak desteklenen, üretime hazır özellikler içerir.

v2 özelliklerinin çoğu, ilgili 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

API anahtarlarını desteklemeyen Harita Yönetimi API'sinde kimlik doğrulaması yapmak için yalnızca OAuth 2.0'ı kullanabilirsiniz. Daha fazla bilgi için OAuth'u kullanma başlıklı makaleyi inceleyin.

Sınırlamalar

  • Geliştirici Rolleri: Map Management API'sini kullanmak için Google Cloud projenizde Google Haritalar Platformu kaynaklarını yönetmek üzere gerekli IAM izinlerine sahip olmanız gerekir.
  • Kaynak Kapsamı: Bu API, Cloud tabanlı Harita Stili Oluşturma kaynaklarının yönetimine odaklanır. Diğer Google Haritalar Platformu yapılandırmaları için Cloud Console gerekebilir.

Maliyetler

Map Management API kullanımı için ücret alınmaz. API çağrıları Cloud Console'daki Faturalandırma sayfasında görünür ancak ücretler 0 ABD doları olur. Ancak istekler aşağıdaki gibi sınırlandırılır:

  • 3 QPS (saniyedeki sorgu sayısı)
  • Proje başına 180 QPM (dakikada sorgu sayısı). Bu değer her dakika yenilenir.
  • Proje için günlük 100.000 sorgu (QPD) kotası. Bu kota her gün yenilenir.

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