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 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: Merepresentasikan identitas peta unik (ID Peta). Gaya peta berfungsi sebagai penampung untuk setelan gaya dan fitur seperti peningkatan POI atau perataan bangunan.
  • MapContextConfig: Mengaitkan StyleConfig (dan secara opsional satu atau beberapa Dataset) 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 dipersiapkan untuk ketersediaan umum. Saluran ini cocok untuk penggunaan awal dan pengujian di lingkungan praproduksi.
  • 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 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 muncul di halaman Penagihan di Konsol Cloud, tetapi tagihan 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.