Memahami validasi rute

Setelah Anda membuat rute, Roads Selection API akan melakukan proses validasi. Validasi ini memastikan bahwa rute sesuai 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 di resource SelectedRoute menunjukkan status validasi dan operasionalnya saat ini. Kolom state dapat memiliki nilai berikut:

  • STATE_UNSPECIFIED: Status validasi rute ini belum ditetapkan.
  • STATE_VALIDATING: Rute sedang divalidasi.
  • STATE_RUNNING: Rute berhasil melewati validasi dan sekarang aktif. API secara aktif mengumpulkan data dan mengirimkan update 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 di STATE_INVALID, respons akan menyertakan kolom validationError dengan detail tentang alasan validasi gagal.

Error validasi

Jika state resource SelectedRoute 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 lalu lintas yang cukup tidak dapat dikumpulkan untuk analisis yang bermakna. Rute yang diklasifikasikan sebagai tidak valid karena penggunaan jalan yang rendah dapat menjadi valid kembali jika volume lalu lintas meningkat di atas nilai minimum yang telah ditentukan. Pelajari lebih lanjut di Rute penggunaan jalan rendah.

Rute dengan penggunaan jalan rendah

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

Berikut yang akan terjadi 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 per kuartal: API melakukan evaluasi per kuartal atas semua rute aktif untuk volume traffic.
    • Jika traffic rendah terdeteksi selama evaluasi, API akan mengeluarkan peringatan dalam resource SelectedRoute.
    • Jika traffic rendah berlanjut selama empat kuartal berturut-turut, state rute akan berubah menjadi STATE_INVALID, dan pembaruan Pub/Sub akan berhenti.
  • Validasi ulang dapat dilakukan: Meskipun rute STATE_INVALID, rute tersebut tetap tunduk pada evaluasi traffic yang sedang berlangsung. Evaluasi berikutnya dapat mengklasifikasikan ulang rute sebagai valid (STATE_RUNNING) jika volume trafficnya 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 melampaui 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 wilayah hukum project resmi Anda.

  • VALIDATION_ERROR_LOW_ROAD_USAGE: Error ini berarti rute yang dipilih tidak memiliki data penggunaan jalan yang memadai untuk analisis dan pembaruan yang bermakna. Untuk memperbaikinya, hapus rute yang ada dan buat ulang rute, dengan memilih 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 seiring waktu seperti yang dijelaskan dalam Rute penggunaan jalan rendah.