Pemecahan masalah

Error Kunci API dan Penagihan

Pada kondisi tertentu, peta gelap, atau gambar Street View 'negatif', yang diberi watermark dengan teks "hanya untuk tujuan pengembangan", mungkin ditampilkan. Perilaku ini biasanya mengindikasikan terjadi masalah pada kunci API atau penagihan. Untuk menggunakan produk Google Maps Platform, penagihan harus diaktifkan di akun Anda, dan semua permintaan harus menyertakan kunci API yang valid. Alur berikut akan membantu Anda memecahkan masalah ini:

Kunci API diteruskan sebagai parameter key pada URL yang digunakan untuk memuat Maps JavaScript API. Berikut adalah beberapa opsi untuk memeriksa apakah Anda menggunakan kunci API:

  • Gunakan ekstensi Chrome Google Maps Platform API Checker. Ekstensi ini memungkinkan Anda mengetahui apakah situs Anda mengimplementasikan Maps API berlisensi Google dengan benar atau tidak.
  • Jika Anda menggunakan library atau plugin untuk memuat Maps JavaScript API, periksa setelan library tersebut dan cari opsi kunci API.
  • Periksa error pada browser Anda. Jika Anda melihat pesan berikut, Anda tidak menggunakan kunci API Anda dengan benar:

Untuk developer web:

  • Jika Anda memiliki akses ke kode sumber dari aplikasi Anda, cari tag <script> yang digunakan untuk memuat Maps JavaScript API. Saat memuat Maps JavaScript API, ganti YOUR_API_KEY pada kode di bawah dengan kunci API Anda. 
      <script async defer
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap">
  </script>
  • Periksa traffic jaringan yang dihasilkan oleh situs Anda pada browser. Di Chrome, Anda dapat melihatnya melalui tab Jaringan pada DevTools. Di sini Anda akan melihat permintaan jaringan yang dibuat oleh situs Anda. Permintaan yang dibuat menggunakan Maps JavaScript API akan berada pada jalur maps/api/js. Di sini Anda dapat mengonfirmasi apakah permintaan menggunakan parameter key. Sebaiknya filter traffic jaringan Anda menurut maps/api/js saat membuka tab Jaringan.

Untuk mendapatkan kunci API, klik tombol di bawah ini. Jika Anda tidak melihat penyiapan terpandu, ikuti petunjuk lengkap pada Memulai Google Maps Platform.
Mulai

Bagus! Sekarang periksa apakah akun penagihan telah dikaitkan ke project Anda.

Buka halaman Billing di konsol Google Cloud dan pilih project tempat kunci API Anda dibuat. Untuk mengonfirmasi bahwa kunci tersebut terkait dengan project:

  1. Buka bagian Credentials, yang dapat diakses melalui sidebar sebelah kiri pada Google Maps Platform > Credentials.
  2. Pastikan bahwa kunci API yang saat ini digunakan di situs Anda telah tercantum. Jika belum, beralihlah ke project lain, lalu periksa kredensial project tersebut.
  3. Jika tidak dapat menemukan project untuk kunci API Anda, kemungkinan Anda telah kehilangan akses ke project tersebut. Minta bantuan orang lain di organisasi Anda. Jika project asli tidak dapat ditemukan, Anda harus:
    1. Membuat project baru. Hal ini dapat dilakukan dengan memilih New Project dari daftar project, atau dengan memilih Create Project melalui halaman Resource Manager.
    2. Membuat kunci API baru. Hal ini dapat dilakukan di halaman Credentials. Setelah membuka halaman, klik Buat kredensial, lalu pilih Kunci API.

Setelah menemukan project Anda di konsol Cloud, periksa apakah akun penagihan telah dikaitkan dengan membuka bagian Billing pada menu samping kiri.

Buka halaman Enable Billing di konsol Cloud dan tambahkan akun penagihan ke project Anda. Untuk informasi tambahan, lihat Memulai Google Maps Platform.

Bagus! Sekarang pastikan bahwa metode penagihan yang diberikan sudah valid.

Anda dapat menambahkan, menghapus, atau memperbarui metode pembayaran di Konsol Cloud.

Jika Anda telah menetapkan batas harian pada API, yang umumnya dilakukan untuk mencegah peningkatan tak terduga, Anda dapat memperbaiki masalah ini dengan meningkatkan batas harian.

Anda dapat memeriksa batas harian dengan membuka Dasbor API & Layanan di Konsol Cloud. Setelah membukanya:

  1. Pilih project jika diminta.
  2. Pilih API dari daftar, lalu klik tab Quotas.

Kunci API dengan pembatasan alamat IP hanya dapat digunakan pada layanan web yang ditujukan untuk penggunaan dari sisi server (seperti Geocoding API dan Web Service API lainnya). Sebagian besar layanan web ini memiliki layanan yang setara pada Maps JavaScript API (misalnya, lihat Layanan Geocoding). Untuk menggunakan layanan sisi klien Maps JavaScript API, Anda harus membuat kunci API terpisah yang dapat diamankan menggunakan pembatasan perujuk HTTP (lihat bagian Mendapatkan, menambahkan, dan membatasi kunci API).

Jika kode Anda tidak berfungsi:

Untuk membantu Anda menyiapkan dan menjalankan kode peta, Brendan Kenny dan Mano Marks menunjukkan beberapa kesalahan umum dan cara memperbaikinya di video ini.

  • Cari kesalahan ketik. Ingat, JavaScript adalah bahasa yang peka huruf besar dan kecil.
  • Periksa dasar-dasarnya - beberapa masalah yang paling umum terjadi saat awal pembuatan peta. Misalnya:
    • Pastikan Anda telah menentukan properti zoom dan center di opsi peta Anda.
    • Pastikan Anda telah mendeklarasikan elemen div tempat peta akan muncul di layar.
    • Pastikan elemen div untuk peta memiliki ketinggian. Secara default, elemen div dibuat dengan ketinggian 0, sehingga tidak terlihat.
    Lihat contoh kami untuk penerapan referensi.
  • Gunakan debugger JavaScript untuk membantu mengidentifikasi masalah, seperti yang tersedia dalam Chrome Developer Tools. Mulailah dengan mencari error di konsol JavaScript.
  • Posting pertanyaan ke Stack Overflow. Panduan tentang cara memposting pertanyaan bagus tersedia di halaman Dukungan.