Maps Static API akan mengeluarkan error atau peringatan jika permintaan gagal. Panduan ini menjelaskan pesan error dan memberikan petunjuk untuk mengatasinya.
Permintaan tidak valid
Untuk permintaan yang tidak valid, Maps Static API akan menampilkan
kode status HTTP 4xx dan pesan yang menjelaskan
masalah, seperti yang ditunjukkan dalam daftar berikut. Periksa kode error dan pesan sebenarnya yang ditampilkan oleh API untuk mengetahui detail masalah tertentu.
- Permintaan menyertakan parameter yang tidak valid, atau parameter yang diperlukan tidak ada. Misalnya, parameter
sizetidak berada dalam rentang nilai numerik yang diharapkan, atau tidak ada dalam permintaan. 400 BAD REQUEST- Kunci API yang disertakan dalam permintaan tidak valid.
403 FORBIDDEN
Error yang mencegah peta ditampilkan
Jika permintaan valid, tetapi terjadi error lain yang mencegah peta ditampilkan, Maps Static API akan menampilkan teks atau gambar error, bukan peta. Misalnya, error terjadi saat aplikasi melebihi batas penggunaan.
Error terkait kunci API dan penagihan
Jika Anda menggunakan Maps Static API tanpa kunci API, atau jika penagihan tidak diaktifkan di akun Anda, halaman akan menampilkan gambar error, bukan peta, dengan link yang menunjukkan jenis error. Misalnya, "g.co/staticmaperror/key."
| Error dan solusi tanpa kunci | |
|---|---|
 |
Anda menggunakan Maps Static API tanpa kunci API. Untuk mengatasi error ini, selesaikan langkah-langkah berikut: |
 |
Permintaan Anda tidak memiliki tanda tangan digital yang diperlukan. Untuk mengatasi error ini, tandatangani URL Anda. |
Peringatan
Untuk beberapa kondisi error, API menampilkan peta, tetapi beberapa informasi mungkin tidak ada dalam peta. Jika hal ini terjadi, Anda dapat mengidentifikasi peringatan menggunakan kondisi berikut:
- Peta muncul dengan kolom error berwarna kuning yang ditumpangkan di atas peta dengan teks "Error peta: g.co/staticmaperror".
- API menampilkan peringatan dalam
bentuk header HTTP bernama
X-Staticmap-API-Warning.
Misalnya, URL berikut berisi nilai yang tidak terduga dalam
parameter markers:
https://maps.googleapis.com/maps/api/staticmap?center=Williamsburg,Brooklyn,NY&zoom=13&scale=1&size=400x400&markers=sdgaags&key=YOUR_API_KEY
API menampilkan peta, tetapi menampilkan kolom error kuning yang ditumpangkan pada gambar dengan teks "Error peta: g.co/staticmaperror":
API juga mengembalikan header HTTP berikut:
X-Staticmap-API-Warning:Error geocoding: marker 1
Tabel berikut menjelaskan peringatan yang dapat dikeluarkan API sebagai header HTTP:
Peringatan di header X-Staticmap-API-Warning
|
|
|---|---|
Error geocoding:
[center, ][marker #number, ][visible #num, ][path #num, ]* |
Terjadi kesalahan saat mencoba untuk melakukan geocode permintaan. Ada banyak
varian pesan ini, bergantung pada elemen tempat geocoding
gagal, seperti center, marker,
visible, atau path, dan jumlah
elemen yang gagal. Salah satu contoh peringatan ini adalah
X-Staticmap-API-Warning:Error geocoding: marker 1, seperti
yang ditunjukkan dalam contoh sebelumnya. |
Too many geocoded markers requested (max is 15). |
Permintaan menentukan lebih dari jumlah maksimum penanda yang diizinkan dengan alamat yang dapat dibaca manusia. Maksimumnya 15. Batas ini hanya berlaku untuk penanda yang ditentukan sebagai alamat yang dapat dibaca manusia yang memerlukan geocoding. Hal ini tidak berlaku untuk penanda yang ditentukan dengan koordinat lintang dan bujur. |
Too many geocoded polyline vertices requested (max is 15). |
Permintaan menentukan lebih dari jumlah maksimum polyline yang diizinkan dengan alamat yang dapat dibaca manusia. Maksimumnya 15. Batas ini hanya berlaku untuk polyline dengan verteks yang ditentukan sebagai alamat yang dapat dibaca manusia yang memerlukan geocoding. Tidak berlaku untuk polyline yang ditentukan dengan koordinat lintang dan bujur. |
Anda dapat melihat peringatan header HTTP di Konsol Chrome DevTools, Konsol Web Firefox, atau alat lain yang setara di browser Anda.