Memahami validasi rute

Setelah Anda membuat rute, Roads Selection API akan melakukan proses validasi. Validasi ini memastikan bahwa rute tersebut sesuai untuk pengumpulan dan pembaruan data dalam Analisis Pengelolaan Jalan Raya. 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 status 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 melewati validasi dan kini aktif. API ini 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 dalam status STATE_INVALID, respons akan menyertakan kolom validationError yang berisi detail tentang alasan kegagalan validasi.

Error validasi

Jika state resource SelectedRoute adalah STATE_INVALID, respons API akan menyertakan kolom validationError. Kolom ini memberikan alasan spesifik atas 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 wilayah hukum yang diizinkan untuk project Anda.
  • VALIDATION_ERROR_LOW_ROAD_USAGE: Rute ini memiliki penggunaan jalan yang rendah, yang berarti data lalu lintas yang dikumpulkan tidak cukup 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 batas yang telah ditentukan. Pelajari lebih lanjut di Rute penggunaan jalan rendah.

Rute dengan penggunaan jalan yang rendah

Rute mungkin 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 yang sedang berlangsung.

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 kuartalan: API melakukan evaluasi kuartalan terhadap semua rute aktif untuk volume traffic.
    • Jika traffic rendah terdeteksi selama evaluasi, API akan mengeluarkan peringatan dalam resource SelectedRoute.
    • Jika traffic rendah terus berlanjut selama empat kuartal berturut-turut, state rute akan berubah menjadi STATE_INVALID, dan update Pub/Sub akan berhenti.
  • Validasi ulang dapat dilakukan: Meskipun rute berstatus 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.
  • Status pemantauan: 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, dengan memastikan semua titiknya (asal, tujuan, dan perantara) berada dalam wilayah hukum project yang diizinkan.

  • VALIDATION_ERROR_LOW_ROAD_USAGE: Error ini berarti rute yang dipilih tidak memiliki data penggunaan jalan yang memadai untuk analisis dan update yang bermakna. Untuk memperbaikinya, hapus rute yang ada dan buat ulang rute, dengan memilih area dengan penggunaan jalan atau "tingkat 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.