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, dan 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 skala besar atau mengintegrasikan gaya visual 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 unik (ID Peta). ID ini bertindak sebagai penampung untuk setelan dan fitur gaya visual seperti peningkatan 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 menyediakan jalur yang jelas dari fitur eksperimental hingga 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 dan pengujian awal di lingkungan pra-produksi.
  • v2 (Ketersediaan Umum): Berisi fitur yang didukung sepenuhnya dan siap produksi.

Sebagian besar fitur v2 tersedia di seluruh 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.
  • Cakupan Resource: API ini berfokus pada pengelolaan resource Gaya Visual Peta berbasis Cloud. Konfigurasi Google Maps Platform lainnya mungkin masih memerlukan Konsol Cloud.

Biaya

Tidak ada biaya untuk menggunakan Map Management API. Panggilan API akan muncul di halaman Penagihan di Konsol Cloud, tetapi biayanya akan menjadi $0. Namun, permintaan dibatasi sebagai berikut:

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

Lihat Penggunaan dan penagihan.