Ringkasan Map Management API

Map Management API adalah RESTful API yang dapat Anda gunakan untuk mengelola resource gaya visual peta berbasis cloud secara terprogram. Dengan API ini, Anda dapat menentukan tampilan visual peta, mengelola identitas peta, serta mengaitkan gaya dan set data kustom dengan varian peta tertentu—semuanya tanpa menggunakan Konsol Cloud.

Map Management API dirancang untuk developer yang ingin melakukan pengelolaan konfigurasi peta dalam skala besar atau mengintegrasikan gaya peta ke dalam alur kerja otomatis dan alat internal mereka sendiri.

Referensi Utama

  • StyleConfig: Berisi representasi JSON dari gaya peta. Hal ini menentukan warna, visibilitas, dan kepadatan fitur peta.
  • MapConfig: Mewakili identitas peta yang unik (ID Peta). Gaya peta berfungsi sebagai penampung untuk setelan gaya dan fitur seperti penguatan POI atau perataan bangunan.
  • MapContextConfig: Mengaitkan StyleConfig (dan secara opsional satu atau beberapa Set Data) dengan MapVariants tertentu dalam MapConfig.

Saluran Pembuatan Versi API

Map Management API menggunakan pembuatan versi berbasis saluran untuk memberikan jalur yang jelas dari fitur eksperimental ke ketersediaan umum yang stabil.

  • v2alpha (Eksperimental): Berisi fitur eksperimental terbaru. Fitur di saluran ini dapat berubah tanpa pemberitahuan dan tidak direkomendasikan untuk penggunaan produksi.
  • v2beta (Pratinjau): Berisi fitur yang stabil dan sedang disiapkan untuk ketersediaan umum. Saluran ini cocok untuk adopsi awal dan pengujian di lingkungan praproduksi.
  • v2 (Ketersediaan Umum): Berisi fitur yang didukung sepenuhnya dan siap produksi.

Sebagian besar fitur v2 tersedia di endpoint v2alpha dan v2beta selama fase peluncurannya masing-masing. Untuk pengguna baru, Google merekomendasikan untuk memulai dengan endpoint v2beta.

Autentikasi

Anda hanya dapat menggunakan OAuth 2.0 untuk melakukan autentikasi dengan Map Management API, yang tidak mendukung kunci API. Untuk mengetahui informasi selengkapnya, lihat Menggunakan OAuth.

Batasan

  • Peran Developer: Untuk menggunakan Map Management API, Anda harus memiliki izin IAM yang diperlukan untuk mengelola resource Google Maps Platform dalam project Google Cloud Anda.
  • Cakupan Resource: API ini berfokus pada pengelolaan resource Gaya Visual Peta berbasis Cloud. Konfigurasi Google Maps Platform lainnya mungkin masih memerlukan Konsol Cloud.

Biaya

Penggunaan Map Management API tidak dikenai biaya. Panggilan API akan muncul di halaman Penagihan di Konsol Cloud, tetapi biayanya akan sebesar $0. Namun, permintaan dibatasi sebagai berikut:

  • 3 QPS (kueri per detik)
  • 180 QPM (kueri per menit) untuk sebuah project, diperbarui setiap menit
  • 100.000 QPD (kueri per hari) untuk satu project, diperbarui setiap hari

Lihat Penggunaan dan penagihan.