Memahami validasi rute

Setelah Anda membuat rute, Roads Selection API akan melakukan proses validasi. Validasi ini memastikan bahwa rute tersebut cocok untuk pengumpulan dan pembaruan data dalam Roads Management Insights. Proses ini biasanya selesai dalam beberapa menit.

Anda dapat memantau status validasi rute melalui kolom state dalam respons API. Anda dapat memeriksanya menggunakan endpoint get, seperti yang dijelaskan dalam Mendapatkan rute yang dipilih, atau dengan memeriksa tabel routes_status di BigQuery.

Status rute

Kolom state dalam resource SelectedRoute menunjukkan status validasi dan operasionalnya saat ini. Kolom state dapat memiliki nilai berikut:

  • STATE_UNSPECIFIED: Status validasi rute ini tidak ditetapkan.
  • STATE_VALIDATING: Rute sedang divalidasi.
  • STATE_RUNNING: Rute telah berhasil lulus validasi dan kini aktif. API secara aktif mengumpulkan data dan mengirimkan pembaruan berkala untuk rute ini ke BigQuery, Pub/Sub, atau keduanya.
  • STATE_DELETING: Rute telah ditandai untuk dihapus dan sedang dihapus dari sistem.
  • STATE_INVALID: Rute gagal divalidasi berdasarkan kriteria tertentu. Jika rute berada dalam STATE_INVALID, respons akan menyertakan validationError kolom dengan detail alasan validasi gagal.

Error validasi

Jika SelectedRoute resource's state adalah STATE_INVALID, respons API akan menyertakan kolom validationError. Kolom ini memberikan alasan spesifik untuk kegagalan validasi.

Kolom validationError dapat memiliki nilai berikut:

  • VALIDATION_ERROR_UNSPECIFIED: Error validasi untuk rute ini tidak ditetapkan.
  • VALIDATION_ERROR_ROUTE_OUTSIDE_JURISDICTION: Rute berada di luar yurisdiksi resmi project Anda.
  • VALIDATION_ERROR_LOW_ROAD_USAGE: Rute memiliki penggunaan jalan yang rendah, yang berarti data traffic yang tidak memadai dapat dikumpulkan untuk analisis yang bermakna. Rute yang diklasifikasikan sebagai tidak valid karena penggunaan jalan yang rendah dapat menjadi valid lagi jika volume traffic meningkat di atas nilai minimum yang telah ditentukan. Pelajari lebih lanjut di Rute penggunaan jalan yang rendah.

Rute penggunaan jalan yang rendah

Rute dapat ditandai dengan VALIDATION_ERROR_LOW_ROAD_USAGE jika API menentukan bahwa tidak ada cukup data traffic untuk analisis yang konsisten. Hal ini dapat terjadi selama validasi awal atau selama evaluasi berkelanjutan.

Berikut hal yang dapat Anda harapkan untuk rute dengan penggunaan jalan yang rendah:

  • Publikasi data ke BigQuery berlanjut: Meskipun rute diklasifikasikan sebagai STATE_INVALID karena penggunaan jalan yang rendah, API akan terus memproses dan memublikasikan data yang tersedia untuk rute tersebut ke BigQuery.
  • Pembaruan Pub/Sub berhenti: Pembaruan real-time berkala ke Pub/Sub akan berhenti jika state rute berubah menjadi STATE_INVALID.
  • Evaluasi triwulanan: API melakukan evaluasi triwulanan terhadap semua rute aktif untuk volume traffic.
    • Jika traffic rendah terdeteksi selama evaluasi, API akan menampilkan a peringatan dalam resource SelectedRoute.
    • Jika traffic rendah berlanjut selama empat triwulan berturut-turut, rute state akan berubah menjadi STATE_INVALID, dan pembaruan Pub/Sub akan berhenti.
  • Validasi ulang dapat dilakukan: Meskipun rute adalah STATE_INVALID, rute tersebut tetap tunduk pada evaluasi traffic yang sedang berlangsung. Evaluasi berikutnya dapat mengklasifikasikan ulang rute sebagai valid (STATE_RUNNING) jika volume traffic-nya meningkat di atas nilai minimum yang telah ditentukan.
  • Memantau status: Anda dapat memantau status validasi rute melalui endpoint get, seperti yang dijelaskan dalam Mendapatkan Rute yang Dipilih, atau dengan memeriksa tabel routes_status di BigQuery.

Memecahkan masalah rute yang tidak valid

Jika rute state Anda adalah STATE_INVALID, ikuti panduan pemecahan masalah berikutnya berdasarkan validationError yang Anda terima:

  • VALIDATION_ERROR_ROUTE_OUTSIDE_JURISDICTION: Error ini menunjukkan bahwa rute yang ditentukan meluas di luar area geografis yang diizinkan untuk project Anda. Untuk memperbaikinya, hapus rute yang ada dan buat ulang rute, pastikan semua titiknya (asal, tujuan, dan perantara) berada dalam yurisdiksi project Anda yang diizinkan.

  • VALIDATION_ERROR_LOW_ROAD_USAGE: Error ini berarti rute yang dipilih tidak memiliki data penggunaan jalan yang cukup untuk analisis dan pembaruan yang bermakna. Untuk memperbaikinya, hapus rute yang ada dan buat ulang rute, pilih area dengan penggunaan jalan atau "kesibukan" yang lebih tinggi untuk pengumpulan data. Perhatikan bahwa jika rute Anda mengalami error ini, status rute dapat berubah kembali menjadi STATE_RUNNING jika traffic meningkat dari waktu ke waktu seperti yang dijelaskan dalam Rute penggunaan jalan yang rendah.