Panduan Migrasi Client ID

Ringkasan

Untuk meningkatkan keamanan dan keandalan autentikasi, ID klien Maps Platform tidak digunakan lagi sejak 26 Mei 2025, dan tidak dapat digunakan lagi setelah 31 Mei 2026.

Daripada menggunakan client ID, Anda harus menggunakan kredensial Kunci API untuk mengautentikasi traffic layanan Google Maps API Anda. Panduan ini menunjukkan cara bermigrasi dari menggunakan ID klien, ke menggunakan kunci API.

Ikuti langkah-langkah berikut untuk memulai:

  1. Memeriksa penggunaan client ID saat ini
  2. Menyiapkan Kunci API
  3. Meninjau setelan kuota
  4. Perbarui kode Anda
  5. Memantau traffic ID klien Anda
  6. Menjeda client ID Anda

Memeriksa penggunaan client ID saat ini

Sebelum memulai proses migrasi, cantumkan hal berikut:

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

Google mengirimkan email notifikasi kepada pelanggan yang terpengaruh tentang penghentian penggunaan ID klien 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 Metrik 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 Metrik di Konsol Cloud.
  2. Pilih layanan Maps Platform dari 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 lalu lintasnya.

Siapkan kunci API

Semua ID klien 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 ID klien Anda. Sebaiknya lakukan migrasi ke project terkait untuk menghindari masalah kuota atau fitur yang tidak ada.

  1. Temukan Project Cloud yang ditautkan ke client ID Anda:
  2. Pastikan Project Cloud Anda ditautkan ke Akun Penagihan yang aktif.
  3. Buat kunci API baru untuk migrasi ID klien.
    • 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 ID klien 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 laporan kuota lebih lanjut

Peningkatan 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 dengan tepat.

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

Metode API

Layanan sisi klien

Layanan untuk menyesuaikan kuota

google.routes.Directions.Javascript

Layanan Directions

Directions API

google.routes.DistanceMatrix.Javascript

Layanan Distance Matrix

Distance Matrix API

google.maps.Elevation.Javascript

Layanan Elevation

Elevation API

google.places.Geocoding.Javascript

Layanan Geocoding

Geocoding API

google.places.*.JavaScript, selain google.places.Geocoding.JavaScript

Library Tempat

Places API
  • Jika Anda tidak menggunakan metode API tersebut, Anda tidak perlu mengkhawatirkan setelan kuota, karena traffic client ID Anda sudah menggunakan kuota project Anda.
  • Memperkirakan penggunaan kuota ID klien 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: Puncak traffic harus berupa Kebutuhan Kuota tambahan per Hari.
  • Sesuaikan kuota Anda di layanan Maps Platform yang sesuai
    • Berdasarkan nama metode yang Anda temukan di Langkah 1, sesuaikan kuota di layanan yang sesuai.

Memperbarui kode

Mengganti parameter klien dengan parameter kunci

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

Memperbarui parameter saluran untuk pelaporan

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

Lihat Pelaporan Google Maps Platform untuk mengetahui 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 Premium Plan untuk mengetahui informasi selengkapnya.

Rahasia Penandatanganan untuk API Gambar

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

Memantau traffic ID klien Anda

Setelah deployment, konfirmasi bahwa 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 ID klien setelah migrasi. Tujuannya adalah untuk melindungi kredensial Anda dari traffic yang tidak diinginkan, dan untuk mengonfirmasi bahwa penggunaan yang tersisa di ID klien Anda tidak bersifat kritis (misalnya, pengujian, cache, bot, …) dan dapat menampilkan error tanpa menyebabkan dampak bisnis. Anda dapat menjeda client ID di Konsol Cloud. Lihat Ringkasan Autentikasi Premium Plan untuk mengetahui detail selengkapnya.

Pemecahan masalah

Bagaimana cara mengetahui apakah permintaan kita gagal atau tidak?

Anda dapat memeriksa statistik error di grafik Kode respons

ApiNotActivatedMapError, atau REQUEST_DENIED error

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 Anda tidak ditambahkan ke kunci API Anda. Periksa bagian "Amankan kunci API Anda", lalu tambahkan domain Anda ke kunci API.

OverQuotaMapError, atau OVER_QUERY_LIMIT error

Anda akan melihat OverQuotaMapError, atau OVER_QUERY_LIMIT, jika kuota yang dikonfigurasi tidak cukup untuk mencakup traffic Anda. Periksa bagian "Tinjau setelan kuota", lalu 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"
}