Bergabunglah bersama kami di Google Maps Platform Developer Community Day berikutnya di San Francisco pada bulan Desember. Daftar sekarang untuk hadir.

Google menggunakan teknologi AI untuk menerjemahkan konten ke dalam bahasa pilihan Anda. Terjemahan AI mungkin mengandung kesalahan.

Menangani error

Developer Wilayah Ekonomi Eropa (EEA)

Setelah membuat permintaan, Anda mungkin menerima respons yang berisi detail error.

Gambar Street View dan Petak 2D

Daftar berikut menjelaskan error yang mungkin Anda alami saat menggunakan Petak 2D dan gambar Street View.

Listingan error

Daftar berikut menjelaskan error yang mungkin Anda alami saat menggunakan Map Tiles API.

required

Permintaan Anda tidak memiliki parameter URL. Perhatikan bahwa pesan error menunjukkan parameter mana yang tidak ada.

notFound, invalid

Nilai x, y, atau z Anda berada di luar rentang.

Untuk ubin peta reguler, tingkat zoom maksimum bergantung pada ubin peta tertentu, dan pada opsi peta yang Anda minta.
Untuk ubin peta reguler, koordinat x harus berada dalam rentang [0, (2^zoom)-1].
Untuk ubin peta reguler, koordinat y harus berada dalam rentang [0, (2^(zoom-1))-1].
Untuk Petak Street View, zoom harus antara nol dan lima, inklusif.
Untuk Petak Street View, rentang koordinat x dan y sama dengan rentang koordinat untuk petak peta reguler, hingga zoom level lima. Pada titik tersebut, nilai maksimumnya adalah imageHeight atau imagewidth dibagi dengan tileHeight atau tileWidth.

forbidden:

Kemungkinan penyebab:

Permintaan tidak memiliki kunci API yang valid.
Pesan: Your request cannot be served. Please ensure the parameters and request type are valid for your account and region.

Ubin satelit 2D tidak tersedia dalam project yang ditautkan ke akun penagihan dengan alamat Wilayah Ekonomi Eropa (EEA). Untuk mengetahui informasi selengkapnya, lihat Penyesuaian Map Tiles API untuk pelanggan EEA.

expired

Masa berlaku token session Anda telah berakhir. Token sesi berlaku selama dua minggu sejak waktu pembuatannya. Perhatikan bahwa hal ini dapat berubah tanpa pemberitahuan. Jika Anda menerima error ini, Anda harus mendapatkan token sesi baru, seperti yang dijelaskan dalam Menggunakan token sesi.

badRequest

Permintaan Anda salah format. Alasan umum untuk error ini mencakup:

Anda menentukan jenis peta terrain tanpa menyertakan lapisan roadmap.
Anda menyertakan array styles untuk jenis peta non-peta jalan.
Anda mengirim nilai lintang/bujur, serta ID panorama dalam permintaan metadata Street View.

quotaExceeded, rateLimitExceeded

Aplikasi Anda telah melampaui kuota yang diizinkan, atau melampaui jumlah kueri per detik yang diizinkan.

Contoh error

{
  "error": {
    "code": 403,
    "message": "The request is missing a valid API key.",
    "errors": [
      {
        "message": "The request is missing a valid API key.",
        "domain": "global",
        "reason": "forbidden"
      }
    ],
    "status": "PERMISSION_DENIED"
  }
}

Mencoba kembali permintaan

Jika permintaan gagal dengan quotaExceeded dan rateLimitExceeded, Anda harus mencoba lagi permintaan Anda sedemikian rupa sehingga permintaan yang rusak atau kegagalan berskala luas tidak membanjiri server Google—karena banyak klien mencoba mengulangi permintaan secara berurutan. Artinya, gunakan backoff eksponensial saat Anda mencoba ulang permintaan. Backoff eksponensial memaksa Anda untuk menyebarkan permintaan dari waktu ke waktu, agar server memiliki waktu untuk pulih.

Misalnya, jika permintaan gagal, coba lagi setelah satu detik. Namun, jika upaya tersebut juga gagal, coba lagi permintaan Anda setelah dua detik. Jika permintaan tersebut juga gagal, coba lagi setelah empat detik. Jadi, Anda secara efektif menyebarkan setiap permintaan berturut-turut hanya dengan menggandakan durasi waktu di antaranya.

Petak 3D

Error dari server Google mungkin tidak terlihat oleh Anda karena Anda mengakses petak fotorealistik melalui perender, yang bertanggung jawab untuk menangani error server.

Error perender ubin

Misalnya, perender CesiumJS biasanya gagal tanpa pesan error saat terjadi error server, yang dapat mengakibatkan error, layar kosong, hingga ubin tertentu tidak dimuat.

Teknik yang Anda gunakan untuk men-debug error server akan bergantung pada perender tertentu yang Anda gunakan. Untuk perender berbasis browser seperti CesiumJS, Anda dapat memeriksa traffic jaringan dengan alat yang ada di sebagian besar browser. Misalnya, Anda dapat menggunakan Chrome DevTools.

Error yang biasa terjadi

Daftar berikut berisi detail tentang error paling umum yang mungkin Anda temui.

400: Argumen tidak valid: Kunci API, parameter kueri, ID ubin/tileset, atau token sesi yang tidak valid atau sudah tidak berlaku.
400: Invalid Value: Pastikan mapType yang digunakan untuk membuat permintaan createSessionToken cocok dengan mapType yang digunakan di endpoint ubin berikutnya. Misalnya, token sesi streetview tidak dapat digunakan untuk meminta ubin roadmap.

403: Permission denied