Maps Static API dapat mengeluarkan error atau peringatan jika terjadi error. Panduan ini menjelaskan setiap pesan error, dan memberikan petunjuk lebih lanjut untuk menyelesaikan error.
Permintaan tidak valid
Jika ada permintaan yang tidak valid, Maps Static API akan menampilkan
kode status HTTP 4xx
dan pesan yang menjelaskan
masalah tersebut. Di bawah ini adalah contoh dari kondisi kesalahan tersebut. Catatan: Ini bukanlah
daftar lengkap error yang mungkin terjadi. Periksa kode error yang sebenarnya dan pesan yang ditampilkan oleh API untuk mengetahui detail masalah tertentu.
Contoh kondisi kesalahan | Kode status |
---|---|
Permintaan berisi parameter yang tidak valid, atau parameter yang diperlukan
tidak ada. Misalnya, parameter size tidak 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, tergantung error-nya. Contoh kondisi error tersebut adalah saat aplikasi melebihi batas penggunaan.
![Gambar kesalahan ditampilkan sebagai ganti peta](https://developers-dot-devsite-v2-prod.appspot.com/static/maps/documentation/maps-static/images/error-image-generic.png?authuser=4&hl=id)
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 menyelesaikan, Anda harus: |
![]() |
Permintaan Anda tidak memiliki tanda tangan digital (wajib). Untuk menyelesaikan, Tanda tangani URL Anda |
Peringatan
Untuk beberapa kondisi error, API menampilkan peta tetapi beberapa informasi mungkin tidak ada di peta. Jika ini terjadi, dua kondisi terjadi untuk memberi tahu Anda tentang peringatan.
- Pertama, peta ditampilkan, tetapi dengan kolom error kuning yang tumpang-tindih di atas peta dengan teks "Map error: g.co/staticmaperror".
- Dua, API akan 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 batang error kuning yang tumpang-tindih pada gambar dengan pesan "Error peta: g.co/staticmaperror":
![Peta ditampilkan, namun dengan kesalahan peta: g.co/staticmaperror](https://developers-dot-devsite-v2-prod.appspot.com/static/maps/documentation/maps-static/images/map-warning.png?authuser=4&hl=id)
API juga mengembalikan header HTTP berikut:
X-Staticmap-API-Warning:Error geocoding: marker 1
Tabel berikut menjelaskan peringatan yang mungkin 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 dari pesan ini, bergantung pada elemen dengan geocoding yang gagal (tengah, penanda, terlihat, atau jalur) dan jumlah elemen yang gagal. Salah satu contoh peringatan ini adalah
X-Staticmap-API-Warning:Error geocoding: marker 1 , seperti
yang ditunjukkan pada contoh di atas. |
Too many geocoded markers requested (max is 15). |
Permintaan menetapkan jumlah penanda melebihi batas yang diizinkan dengan alamat yang dapat dibaca manusia. Maksimumnya 15. Perhatikan, batas ini hanya berlaku untuk penanda yang ditetapkan sebagai alamat yang dapat dibaca manusia yang memerlukan geocoding. Ini tidak berlaku pada penanda yang ditetapkan dengan koordinat lintang/bujur. |
Too many geocoded polyline vertices requested (max is 15). |
Permintaan tersebut menetapkan jumlah polyline melebihi maksimum yang diizinkan dengan alamat yang dapat dibaca manusia. Maksimumnya 15. Perhatikan, batas ini hanya berlaku untuk polyline dengan verteks yang ditetapkan sebagai alamat yang dapat dibaca manusia dan memerlukan geocoding. Ini tidak berlaku untuk polyline yang ditetapkan dengan koordinat garis lintang/bujur. |
Anda dapat melihat peringatan header HTTP di Konsol Chrome DevTools, Konsol Web Firefox, atau alat lain yang setara di browser Anda.