Spesifikasi CIFS
CIFS (Closure and Incident Feed Specification) adalah protokol standar Waze untuk menjelaskan 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 yang diperlukan, feed Anda akan 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 penting bagi mesin yang mengurai file.
Tag tersebut dapat mendeskripsikan Insiden atau Penutupan Jalan sesuai dengan nilai tag type.
Perbedaan kecil dijelaskan jika relevan.
Berikut adalah beberapa contoh Penutupan Jalan dalam feed
Berikut adalah beberapa contoh Insiden dalam feed
Perlu diingat bahwa Anda dapat mencampurkan 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 peristiwa 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 pemilihan rute. <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 kosong |
Koordinat lintang dan bujur Derajat Desimal (DD, proyeksi SRID 4326) yang mendeskripsikan lokasi insiden atau penutupan jalan. Idealnya, nilai ini harus memiliki minimal 6 digit setelah titik desimal untuk akurasi yang memadai. Urutan koordinat harus mencerminkan arah traffic yang terpengaruh. Kami tidak dapat mengurangi arah traffic dari satu titik. Polyline berikut akan memengaruhi satu arah traffic (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 rute, meskipun polyline disediakan. Jika hanya satu kumpulan koordinat yang dapat diberikan, kolom arah diperlukan untuk memastikan bahwa peristiwa 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 mulai) | Wajib | yyyy-MM-dd'T'HH:mm:ss+HH:mm |
Menentukan tanggal waktu mulai untuk satu periode gangguan. Anda dapat menghilangkannya 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 offset zona waktu. <starttime>2023-04-07T09:00:00+01:00</starttime> |
| endtime | Diminta | yyyy-MM-dd'T'HH:mm:ss+HH:mm |
Tentukan tanggal & waktu akhir menggunakan format ISO8601 dalam perincian detik dan sertakan offset zona waktu Jika Anda menghapusnya, saat ini setelan defaultnya 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 jalur terstruktur | Berikan informasi ini hanya jika insiden tidak menyebabkan penutupan jalan sepenuhnya.
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> |
Mengenkapsulasi semua tanggal waktu mulai dan akhir 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 selengkapnya tentang sifat insiden tersebut. Subjenis yang dapat diterima ditentukan oleh jenis yang diberikan.
| Jenis | Kemungkinan subjenis |
|---|---|
ACCIDENT |
|
HAZARD |
|
ROAD_CLOSED |
|
JAM |
|
POLICE |
|