Panduan Migrasi Client ID

Ringkasan

Ikuti langkah-langkah berikut untuk memulai:

1. Memeriksa penggunaan client ID saat ini
2. Menyiapkan Kunci API
3. Meninjau setelan kuota
4. Memperbarui kode Anda
5. Memantau traffic client ID Anda
6. Menjeda client ID
7. Pengaktifan kembali sementara mandiri Client ID

Memeriksa penggunaan client ID saat ini

Sebelum memulai proses migrasi, buat daftar berikut:

• Layanan Maps Platform yang Anda gunakan dengan client ID Anda.
• Aplikasi, situs, atau sistem yang Anda gunakan dengan client ID Anda.

Google telah mengirimkan email notifikasi kepada pelanggan yang terpengaruh tentang penghentian penggunaan client ID pada Mei 2025. Anda juga dapat menemukan informasi ini di email notifikasi.

Di Konsol Cloud, Anda dapat memeriksa status terbaru penggunaan Client ID di Halaman Metrik Google Maps

Untuk daftar Layanan Maps Platform:

1. Buka halaman Metrics di Konsol Cloud.
2. Filter penggunaan Anda dengan setelan berikut:
   • Kredensial: Pilih "project_number:<numerical identifier>" saja.
3. Tetapkan filter berikut.
   • Dikelompokkan menurut: API

Untuk petunjuk aplikasi, situs, atau sistem:

Konsol Cloud tidak menampilkan detail aplikasi, situs, atau sistem Anda. Namun, Anda dapat menemukan beberapa petunjuk sumber traffic Client ID Anda. Ikuti langkah-langkah berikut:

1. Buka halaman Metrics di Konsol Cloud.
2. Pilih layanan Maps Platform dari menu drop-down.
3. Filter penggunaan Anda dengan setelan berikut:
   • Kredensial: Pilih "project_number:<numerical identifier>" saja.
4. Tetapkan filter berikut.
   • Kelompokkan menurut: Platform, atau Domain
5. Ulangi dari langkah 2 untuk setiap layanan Maps Platform yang perlu Anda periksa traffic-nya.

Menyiapkan kunci API

Semua client ID dikaitkan dengan project Google Cloud, dan menggunakan kunci API dari project tersebut akan memberi Anda akses ke fitur yang sama dengan yang sebelumnya Anda akses dengan client ID. Sebaiknya lakukan migrasi ke project terkait, untuk menghindari masalah terkait kuota atau fitur yang tidak ada.

1. Temukan Project Cloud yang ditautkan ke client ID Anda:
   • FAQ Migrasi Portal
2. Pastikan Project Cloud Anda ditautkan ke Akun Penagihan yang terbuka.
3. Buat kunci API baru untuk migrasi client ID.
   • Anda dapat menggunakan kembali kunci API yang ada di Project Cloud.
   • Anda dapat menggunakan beberapa kunci API dari Project Cloud yang sama, misalnya, untuk memisahkan traffic untuk setiap layanan Maps Platform, atau untuk memisahkan traffic dari berbagai platform (browser, aplikasi seluler, dan sebagainya). Lihat panduan keamanan untuk mengetahui praktik terbaik terkait pengelolaan kunci API.

Mengamankan kunci API Anda

Pastikan untuk mengamankan kunci API Anda guna melindungi kunci Anda dari akses yang tidak sah.

• Tetapkan pembatasan aplikasi untuk kunci API Anda (misalnya, Situs, alamat IP, aplikasi Android, atau aplikasi iOS).
• Tetapkan pembatasan API untuk kunci API Anda.

Untuk mengetahui detail selengkapnya, lihat Panduan keamanan Google Maps Platform.

Untuk Maps JavaScript API, Maps Static API, dan Street View Static API, Anda dapat memigrasikan perujuk tepercaya di client ID Anda ke pembatasan kunci API. Anda dapat menemukan daftar perujuk tepercaya di Konsol Cloud.

Meninjau setelan kuota

Pastikan Anda memiliki setelan kuota yang diharapkan di Project Cloud Anda. Anda hanya perlu melakukannya jika memanggil layanan sisi klien Maps JavaScript API dari client ID. Anda dapat memeriksa dan menyesuaikan setelan kuota di Halaman Kuota Google Maps.

Pelajari lebih lanjut laporan kuota

Penambahan kuota untuk layanan sisi klien Maps JavaScript API

Jika Anda menggunakan layanan berikut di Maps JavaScript API, Anda akan melihat peningkatan penggunaan kuota setelah migrasi kunci API.

Tinjau konfigurasi kuota saat ini, penggunaan saat ini, dan sesuaikan batas kuota Anda.

1. Periksa apakah Anda menggunakan layanan sisi klien Maps JavaScript API dengan client ID.
   • Buka halaman Metrics di Konsol Cloud.
   • Filter penggunaan Anda dengan setelan berikut:
     • Grouped by: API Method
     • Kredensial: Pilih "project_number:<numerical identifier>" saja.
   • Kemudian, Anda akan melihat daftar nama Metode beserta traffic-nya di diagram "Traffic menurut Metode API".

• Jika tidak menggunakan metode API tersebut, Anda tidak perlu mengkhawatirkan setelan kuota, karena traffic client ID Anda sudah menggunakan kuota project.
• Memperkirakan penggunaan kuota client ID Anda
  • Untuk setiap layanan, periksa perincian Per Detik dan Per Hari.
  • Grafik Per Detik: kalikan traffic puncak dengan 60 untuk kebutuhan Kuota Per Menit tambahan.
  • Grafik Per Hari: Traffic puncak harus berupa kebutuhan Kuota per Hari tambahan.
• Sesuaikan kuota Anda di layanan Maps Platform yang sesuai
  • Berdasarkan nama metode yang Anda temukan di Langkah 1, sesuaikan kuota pada layanan yang sesuai.

Mengupdate kode Anda

Mengganti parameter klien dengan parameter kunci

Perbarui kredensial autentikasi dari URL&client={value} menjadi URL&key={value} dalam panggilan API GMP keluar Anda. Jika aplikasi Anda menggunakan HTTP untuk mengakses layanan GMP, update aplikasi tersebut agar menggunakan HTTPS.

Memperbarui parameter saluran untuk pelaporan

Anda dapat melacak penggunaan per saluran dengan menentukan parameter saluran ke permintaan API. Kunci API hanya mendukung nilai numerik untuk parameter saluran. Jika Anda menggunakan Client ID dengan nilai non-numerik untuk parameter saluran, perbarui ke nilai numerik yang didukung.

Lihat Pelaporan Google Maps Platform untuk informasi selengkapnya.

Menghapus parameter tanda tangan untuk layanan web

Untuk Web Service API berikut, parameter tanda tangan tidak diperlukan saat Anda mengaksesnya dengan kunci API. Hanya hapus parameter tanda tangan dari permintaan API Anda.

• Directions API (Lama)
• Distance Matrix API (Lama)
• Geocoding API
• Elevation API
• Time Zone API

Lihat Ringkasan Paket Premium untuk mengetahui informasi selengkapnya.

Rahasia Penandatanganan untuk Imagery API

Maps Static API, dan Street View Static API masih memerlukan parameter tanda tangan. API tersebut menerima sejumlah kecil permintaan tanpa tanda tangan untuk tujuan pengujian, tetapi mulai gagal setelah mencapai batas di lingkungan produksi Anda. Ganti rahasia penandatanganan Anda dari rahasia untuk client ID menjadi rahasia untuk kunci API. Anda dapat menggunakan algoritma penandatanganan yang sama, tetapi Anda harus menggunakan rahasia penandatanganan lain. Untuk mempelajari lebih lanjut, lihat Menggunakan Tanda Tangan Digital.

Memantau traffic client ID Anda

Setelah deployment, pastikan traffic Anda telah berhasil dimigrasikan menggunakan dasbor Konsol Cloud. Anda akan mulai melihat penurunan traffic client ID, yang ditampilkan dalam format "project_number:123456" di dasbor saat dikelompokkan menurut kredensial.

Menjeda client ID

Sebaiknya developer menjeda client ID setelah migrasi. Tujuannya adalah untuk melindungi kredensial Anda dari traffic yang tidak diinginkan, dan untuk mengonfirmasi bahwa penggunaan yang tersisa pada client ID Anda tidak penting (misalnya, pengujian, cache, bot, …) dan dapat menampilkan error tanpa menyebabkan dampak bisnis. Anda dapat menjeda client ID di Konsol Cloud. Lihat Ringkasan Autentikasi Paket Premium untuk mengetahui detail selengkapnya.

Pengaktifan kembali sementara layanan mandiri client ID

Karena Client ID Google Maps Platform memasuki periode penghentian bertahap pada Mei 2026, ketersediaan layanan tidak lagi dijamin. Akses akan dibatasi secara berkala sebagai bagian dari proses penghentian layanan terjadwal. Meskipun layanan biasanya dipulihkan secara otomatis dalam beberapa jam, Anda dapat memilih untuk mengaktifkan kembali akses secara manual jika diperlukan pemulihan segera.

Untuk segera memulihkan akses, Anda dapat melakukan pengaktifan kembali mandiri melalui Konsol Google Cloud:

• Buka halaman Credentials Google Maps Platform.
• Temukan Project Cloud spesifik Anda yang ditautkan ke Client ID Anda.
• Klik ikon lanjutkan yang terletak di ujung kanan entri untuk memulihkan layanan.

Jika Anda tidak dapat bermigrasi ke kunci API dengan cepat dan ingin dikecualikan sementara dari gangguan lebih lanjut, hubungi tim Dukungan Google Maps Platform dengan memberikan detail berikut:

• Client ID
• Kasus penggunaan tertentu
• Tanggal migrasi target
• Penilaian dampak bisnis

Laporan penggunaan Client ID - dari Laporan Penagihan

Memeriksa laporan Penagihan, bukan Metrik Project, dapat berguna bagi pengguna yang tidak memiliki akses ke metrik project, misalnya, administrator penagihan (terutama Partner Platform Maps). Meskipun Laporan Penagihan memiliki latensi 1-2 hari, laporan ini memiliki manfaat menampilkan insight penggunaan dan biaya selama lebih dari 30 hari.

Anda dapat memantau penggunaan Client ID melalui Konsol Google Cloud dengan mengikuti langkah-langkah berikut:

1. Buka halaman Billing > Reports di Konsol Google Cloud.
2. (Opsional, hanya relevan untuk Partner) Terapkan filter untuk memilih akun sub-penagihan yang diinginkan.
3. Kelompokkan data laporan menurut kunci label goog-maps-api-key-suffix. Label ini menampilkan karakter di akhir kunci API.
4. Identifikasi traffic Client ID dengan mencari entri yang tidak memiliki label goog-maps-api-key-suffix atau labelnya kosong, karena label ini tidak diisi untuk permintaan Client ID.
5. Abaikan SKU yang tidak dimaksudkan untuk dikaitkan dengan permintaan API—misalnya, SKU langganan.

Pemecahan masalah

Bagaimana cara mengetahui apakah permintaan kita gagal atau tidak?

Anda dapat memeriksa statistik error di Grafik kode respons

Error ApiNotActivatedMapError, atau REQUEST_DENIED

Anda akan melihat error ApiNotActivatedMapError, atau REQUEST_DENIED, jika Anda tidak mengaktifkan layanan di Project Cloud Anda. Ikuti petunjuk untuk mengaktifkan layanan.

RefererNotAllowedMapError error

Anda akan melihat error RefererNotAllowedMapError jika domain sumber tidak ditambahkan ke kunci API Anda. Periksa bagian "Mengamankan kunci API Anda", lalu tambahkan domain Anda ke kunci API.

Error OverQuotaMapError, atau OVER_QUERY_LIMIT

Anda akan melihat OverQuotaMapError, atau OVER_QUERY_LIMIT, jika kuota yang dikonfigurasi tidak cukup untuk mencakup traffic Anda. Periksa bagian "Tinjau setelan kuota", dan sesuaikan kuota Anda.

Error "Requests to this API must be over SSL"

Jika Anda menerima pesan error berikut, perbarui permintaan API Anda dari "http://" menjadi "https://".

{
  "error_message" : "Requests to this API must be over SSL. Load the API with
  \"https://\" instead of \"http://\".",

  "results" : [],

  "status" : "REQUEST_DENIED"
}