Menangani error

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

Petak 2D dan citra Street View

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

Listingan error

Daftar berikut menjelaskan error yang mungkin Anda temui 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 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 dalam rentang [0, (2^zoom)-1].

  • Untuk ubin peta reguler, koordinat y harus dalam rentang [0, (2^(zoom-1))-1].

  • Untuk Kartu Street View, zoom harus berada di antara nol dan lima, inklusif.

  • Untuk Kartu Street View, rentang koordinat x dan y sama seperti untuk kartu peta reguler, hingga zoom tingkat lima. Pada saat itu, nilai maksimum adalah imageHeight atau imagewidth dibagi dengan tileHeight atau tileWidth.

forbidden: Permintaan tidak memiliki kunci API yang valid.

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 menerima error ini, Anda harus mendapatkan token sesi baru, seperti yang dijelaskan dalam Menggunakan token sesi.
badRequest

Permintaan Anda salah format. Alasan umum untuk hal ini meliputi:

  • Anda menentukan jenis peta terrain tanpa menyertakan lapisan roadmap.

  • Anda menyertakan array styles untuk jenis peta non-peta jalan.

  • Anda mengirim nilai lat/lng, 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 ulang permintaan

Jika permintaan gagal dengan quotaExceeded dan rateLimitExceeded, Anda harus mencoba ulang permintaan dengan cara sedemikian rupa sehingga permintaan yang rusak atau kegagalan berskala luas tidak membanjiri server Google—karena banyak klien mencoba untuk mencoba ulang permintaan secara berturut-turut. Artinya, gunakan backoff eksponensial saat Anda mencoba ulang permintaan. Backoff eksponensial memaksa Anda untuk menyebarkan permintaan tepat waktu, untuk memberi waktu bagi server untuk melakukan pemulihan.

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 mendistribusikan setiap permintaan berturut-turut hanya dengan menggandakan durasi di antara permintaan tersebut.

Kartu 3D

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

Error perender kartu

Misalnya, perender CesiumJS biasanya gagal secara diam-diam saat error server terjadi, yang dapat menyebabkan apa pun mulai dari error, layar kosong, hingga kartu tertentu tidak dapat 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 bawaan 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 alami.

400: Argumen tidak valid
Kunci API, parameter kueri, ID kartu/kartu tidak valid, atau token sesi yang sudah tidak berlaku.
403: Izin ditolak
Kunci API tidak ada, koneksi SSL tidak ada, atau kunci API Anda belum ditambahkan ke daftar yang diizinkan untuk Kartu 3D. Hubungi Dukungan Google dengan project ID Anda untuk ditambahkan ke daftar yang diizinkan untuk fungsi 3D Tiles dari Map Tiles API.
429: Terlalu banyak permintaan
Kuota Anda sudah habis. Hubungi Dukungan Google untuk meningkatkan kuota Anda.