Menangani error

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

Ubin 2D dan gambar Street View

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

Kesalahan listingan

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

required
Permintaan Anda tidak memiliki parameter URL. Perhatikan bahwa pesan {i>error <i}menunjukkan parameter mana yang tidak ada.
notFound, invalid

x, y, atau Nilai z di luar rentang.

  • Untuk petak peta reguler, tingkat zoom maksimum bergantung pada petak peta, dan opsi peta yang diminta.

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

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

  • Untuk Ubin Street View, zoom harus antara nol dan lima, inklusif.

  • Untuk Ubin Street View, rentang koordinat x dan y sama dengan untuk ubin peta biasa, hingga zoom tingkat lima. Pada saat itu, nilai maksimum nilainya 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 valid untuk dua minggu sejak pembuatannya. Perhatikan bahwa ini mungkin berubah tanpa pemberitahuan. Jika menerima error ini, Anda harus mendapatkan sesi baru seperti yang dijelaskan dalam Gunakan 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-roadmap.

  • Anda mengirimkan nilai lat/lng, serta ID panorama dalam metadata Street View permintaan.

quotaExceeded, rateLimitExceeded

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

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 besar jangan membanjiri server Goodle—karena banyak klien yang mencoba mencoba ulang permintaan dengan cepat suksesi. Ini berarti menggunakan backoff eksponensial saat Anda mencoba kembali permintaan Anda. Backoff eksponensial memaksa Anda untuk permintaan keluar tepat waktu, untuk memberi waktu kepada server untuk memulihkan.

Misalnya, jika permintaan gagal, coba lagi setelah satu detik. Tapi jika itu upaya gagal juga gagal, lalu coba lagi permintaan Anda setelah dua detik. Jika hal tersebut juga gagal, lalu coba lagi setelah empat detik. Jadi Anda menyebarkan secara efektif setiap permintaan berturut-turut hanya dengan melipatgandakan durasi waktu antar permintaan.

Ubin 3D

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

Error perender kartu

Misalnya, perender CesiumJS biasanya gagal secara otomatis saat terjadi error server yang bisa mengakibatkan kejadian mulai kerusakan, layar kosong, hingga ubin tidak dimuat.

Teknik yang Anda gunakan untuk men-debug error server akan bergantung pada perender yang Anda gunakan. Untuk perender berbasis browser seperti CesiumJS, Anda dapat memeriksa lalu lintas jaringan dengan alat yang terpasang di sebagian besar browser. Sebagai contoh, Anda dapat penggunaan Chrome DevTools.

Error yang biasa terjadi

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

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