Spesifikasi CIFS
CIFS (Spesifikasi Feed Penutupan dan Insiden) adalah protokol standar Waze untuk mendeskripsikan Insiden dan Penutupan Jalan di feed Partner.
Tabel parameter di bawah mengklasifikasikan setiap elemen sebagai berikut:
- Wajib: Tanpa nilai yang diformat dengan benar untuk tag wajib, feed Anda dianggap tidak valid.
- Diminta: Meskipun secara teknis tidak diperlukan, tag yang diminta dianggap direkomendasikan.
- Opsional: Tag opsional yang memungkinkan Anda memberikan lebih banyak data.
Urutan elemen tidak menjadi masalah bagi mesin yang mem-parsing file.
Tag tersebut dapat mendeskripsikan Insiden atau Penutupan Jalan sesuai dengan nilai tag type.
Perbedaan kecil dijelaskan jika relevan.
Berikut beberapa contoh Penutupan Jalan dalam feed
Berikut beberapa contoh Insiden dalam feed
Ingatlah bahwa Anda dapat menggabungkan Penutupan dan Insiden dalam file feed yang sama.
Elemen CIFS
| Elemen | Wajib | Input tag | Deskripsi |
|---|---|---|---|
| ID insiden | Wajib | Teks bebas | Menentukan ID alfanumerik atau numerik.
<incident id="LND11DEayKr">...</incident> |
| jenis | Wajib | Salah satu dari:
ROAD_CLOSED
ACCIDENT
HAZARD
POLICE
CHIT_CHAT
JAM
|
Jenis ini akan menentukan cara acara Anda digunakan oleh aplikasi Waze.
Semua jenis lainnya akan ditampilkan di peta Waze dan akan memicu notifikasi pop-up untuk Wazer di sekitar, tetapi tidak akan berdampak langsung pada perutean. <type>ROAD_CLOSED</type> |
| subjenis | Diminta | Lihat daftar subjenis yang diizinkan | Deskripsi yang lebih akurat untuk jenis insiden yang dilaporkan.
|
| polyline | Wajib | Daftar pasangan lat lon yang dipisahkan spasi |
Koordinat lintang dan bujur Derajat Desimal (DD, proyeksi SRID 4326) yang mendeskripsikan lokasi insiden atau penutupan jalan. Idealnya, nilai ini harus memiliki setidaknya 6 digit di belakang tanda desimal agar akurasinya memadai. Urutan koordinat harus mencerminkan arah traffic yang terpengaruh. Kita tidak dapat menyimpulkan arah traffic dari satu titik. Polyline berikut akan memengaruhi satu arah lalu lintas (tambahkan elemen <polyline>51.510090 -0.006902 51.509142 -0.006564 51.506291 -0.003640 51.503796 0.001051 51.499218 0.001687 51.497365 0.002020</polyline> |
| direction | Diminta | BOTH_DIRECTIONS atau ONE_DIRECTION |
Menentukan apakah gangguan atau penutupan memengaruhi satu atau kedua arah lalu lintas di jalan. Sangat disarankan untuk memberikan arah, meskipun polyline diberikan. Jika hanya satu set koordinat yang dapat diberikan, kolom arah diperlukan untuk memastikan bahwa acara ditampilkan dalam arah mengemudi yang benar. <direction>BOTH_DIRECTIONS</direction> |
| jalan | Wajib | Teks bebas | Menentukan nama jalan tempat peristiwa terjadi. <street>NW 12th St</street> |
| starttime (waktu dimulai) | Wajib | yyyy-MM-dd'T'HH:mm:ss+HH:mm |
Menentukan tanggal dan waktu mulai untuk satu periode gangguan. Anda dapat menghapusnya untuk insiden yang bukan berjenis ROAD_CLOSED dan kami akan menganggap insiden tersebut saat ini aktif. Stempel waktu harus dalam format ISO8601 dengan perincian detik dan menyertakan selisih zona waktu. <starttime>2023-04-07T09:00:00+01:00</starttime> |
| endtime | Diminta | yyyy-MM-dd'T'HH:mm:ss+HH:mm |
Tentukan tanggal dan waktu berakhir menggunakan format ISO8601 dalam perincian detik dan sertakan selisih zona waktu Jika Anda menghapusnya, setelan defaultnya saat ini adalah 14 hari setelah waktu mulai. <endtime>2023-04-07T23:00:00+01:00</endtime> |
| deskripsi | Diminta | Teks bebas | Penyebab gangguan lalu lintas. Deskripsi ini harus kurang dari 40 karakter. Deskripsi yang lebih dari 40 karakter akan diterima, tetapi mungkin tidak ditampilkan dengan benar di aplikasi Waze. <description>I-95 All NB lanes closed btwn Exits 184 and 186.</description> |
| dampak jalur | opsional | informasi dampak lajur terstruktur | Hanya berikan data dampak lajur jika insiden bukan penutupan jalan sepenuhnya dan memengaruhi satu arah lalu lintas.
Berikan informasi tentang semua jalur dengan menentukan array jalur, menggunakan
format jalur WZDx atau format serupa.
Contoh format lengkap: <lanes>
<lane>
<order>1</order>
<type>LANE</type>
<status>CLOSED</status>
</lane>
<lane>
<order>2</order>
<type>LANE</type>
<status>OPEN</status>
</lane>
</lanes>
Contoh format sebagian: <lane_impact> <total_closed_lanes>2</total_closed_lanes> <roadside>RIGHT</roadside> </lane_impact> |
| jadwal | Opsional | <dayname>hh:mm-hh:mm</dayname> |
Mencakup semua tanggal dan waktu mulai dan berakhir untuk insiden. <schedule> <monday>09:00-11:00,17:00-21:00</monday> <thursday>09:00-11:00,17:00-21:00</thursday> <friday>09:00-11:00,17:00-21:00</friday> <saturday>00:00-05:00</saturday> <sunday>09:00-18:00</sunday> </schedule> |
Subjenis Insiden dan Penutupan
Berikan detail lebih lanjut mengenai sifat insiden tersebut. Subjenis yang dapat diterima ditentukan oleh jenis yang diberikan.
| Jenis | Kemungkinan subjenis |
|---|---|
ACCIDENT |
|
HAZARD |
|
ROAD_CLOSED |
|
JAM |
|
POLICE |
|