Error dan pemecahan masalah

Isochrones API menampilkan error menggunakan format JSON google.rpc.Status Google Cloud standar:

{
  "error": {
    "code": 400,
    "message": "Violation in GenerateIsochroneRequest.travel_duration: travel_duration must be at least 1 second and not exceed 3600 seconds (60 minutes) for DRIVE or TWO_WHEELER mode or 7200 seconds (120 minutes) for other modes",
    "status": "INVALID_ARGUMENT"
  }
}

Gunakan kolom status (atau HTTP code) untuk menangani error secara terprogram. Teks message ditujukan untuk developer dan dapat berubah, jadi jangan mengurainya.

Saat menggunakan Isochrones API, Anda mungkin mengalami kode status error umum berikut:

• 400 INVALID_ARGUMENT: Permintaan berisi parameter yang tidak valid atau sintaksis yang salah format:
  • Batas durasi: Pastikan travelDuration minimal "1s", diakhiri dengan "s" (seperti "1800s"), dan tidak melebihi batas mode: 3600s (60 menit) untuk DRIVE dan TWO_WHEELER, atau 7200s (120 menit) untuk WALK dan BICYCLE. Nol ("0s"), nilai negatif, dan nilai sub-detik di bawah 1 detik (seperti "0.5s") akan ditolak.
  • Preferensi traffic: Pastikan routingPreference tidak ditetapkan ke TRAFFIC_AWARE saat travelMode adalah WALK atau BICYCLE. Traffic langsung hanya didukung untuk DRIVE dan TWO_WHEELER.
  • Enum yang diperlukan: Pastikan travelMode dan travelDirection (FROM atau TO) ditentukan dan tidak ditetapkan ke *_UNSPECIFIED.
  • Koordinat asal (location): Tetapkan latitude (dalam [-90, 90]) dan longitude (dalam [-180, 180]). Kolom yang dihilangkan akan diperlakukan sebagai 0 tanpa error: menghilangkan keduanya akan menghasilkan (0, 0), yang ditolak; menghilangkan latitude saja akan menempatkan titik asal di Khatulistiwa; dan menghilangkan longitude saja akan menempatkannya di meridian utama.
  • Format ID tempat (place): Pastikan place adalah ID tempat atau nama resource places/{place_id} (misalnya, "places/ChIJIQBpAG2ahYAR_6128GcTUEo"), tanpa segmen jalur tambahan, dan mengacu pada ID tempat yang valid.
  • Masker kolom (X-Goog-FieldMask): Jika disediakan, header harus merujuk ke jalur respons yang valid seperti isochrone, isochrone.geoJson, atau *.
  • Kunci API tidak valid (API_KEY_INVALID): Kunci API yang salah format atau tidak dikenali di X-Goog-Api-Key atau ?key= akan menampilkan 400 INVALID_ARGUMENT dengan alasan API_KEY_INVALID.
• 403 PERMISSION_DENIED: Autentikasi atau otorisasi gagal:
  • Tidak ada kredensial autentikasi (token X-Goog-Api-Key, ?key=, atau Authorization: Bearer) yang diberikan dalam permintaan.
  • Isochrones API (isochrones.googleapis.com) tidak diaktifkan di project Google Cloud Anda, atau penagihan tidak diaktifkan.
  • Kunci API Anda memiliki pembatasan target API, alamat IP, atau perujuk HTTP yang memblokir permintaan ke isochrones.googleapis.com.
• 404 NOT_FOUND: Origin tidak dapat di-resolve atau diposisikan ke jaringan jalan:
  • place tidak dapat di-resolve ke lokasi. Pastikan ID tempat valid dan terbaru.
  • Titik pusat asal location atau place terletak lebih jauh dari segmen jalan yang kompatibel dengan mode daripada jarak snap maksimum (sekitar 200 meter, atau kurang untuk WALK dan BICYCLE). Pindahkan koordinat lebih dekat ke jalan umum atau teruskan koordinat pintu masuk jalan, bukan ID tempat taman besar atau tempat terkenal.
  • Koordinat berada di area tanpa data jalan (seperti laut lepas).

• 429 RESOURCE_EXHAUSTED: Project Anda melebihi batas kuota per menit (default 300 permintaan per menit):

  {
    "error": {
      "code": 429,
      "message": "Quota exceeded for quota metric 'Requests' and limit 'Requests per minute' of service 'isochrones.googleapis.com'.",
      "status": "RESOURCE_EXHAUSTED"
    }
  }
  

  Batasi rasio permintaan klien dan coba lagi respons 429 menggunakan backoff eksponensial dengan jitter acak.

• 503 UNAVAILABLE: Layanan tidak tersedia untuk sementara atau kelebihan beban. Coba lagi permintaan menggunakan backoff eksponensial.

• 500 INTERNAL: Terjadi error server internal, seperti waktu tunggu backend habis. Coba lagi permintaan menggunakan backoff eksponensial.