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 ini mengklasifikasikan setiap elemen sebagai berikut:
- Wajib: Tanpa nilai yang diformat dengan benar untuk tag wajib, feed Anda akan dianggap tidak valid.
- Diminta: Meskipun secara teknis tidak wajib, tag yang diminta dianggap direkomendasikan.
- Opsional: Tag opsional yang memungkinkan Anda memberikan lebih banyak data.
Urutan elemen tidak menjadi masalah bagi mesin yang menguraikan file.
Tag tersebut dapat mendeskripsikan Insiden atau Penutupan Jalan sesuai dengan nilai tag type
.
Perbedaan kecil akan dijelaskan jika relevan.
Berikut beberapa contoh Penutupan Jalan dalam feed
Berikut beberapa contoh Insiden dalam feed
Perlu diingat bahwa Anda dapat menggabungkan Closures dan Incidents 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> |
tipe | Wajib | Salah satu dari:
ROAD_CLOSED
ACCIDENT
HAZARD
POLICE
CHIT_CHAT
JAM
|
Jenis ini akan menentukan cara acara Anda akan 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 tepat untuk jenis insiden yang dilaporkan.
|
polyline | Wajib | Daftar pasangan lat lon terpisah yang kosong |
Derajat Desimal (DD, proyeksi SRID 4326) koordinat lintang dan bujur yang mendeskripsikan lokasi insiden atau penutupan jalan. Idealnya, ada minimal 6 digit di belakang titik desimal agar akurasinya memadai. Urutan koordinat harus mencerminkan arah lalu lintas yang terpengaruh. Kami tidak dapat memotong arah lalu lintas 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 tersebut memengaruhi salah satu atau kedua arah lalu lintas di jalan. Sangat disarankan untuk memberikan arah, bahkan bila polyline disediakan. Jika hanya satu kumpulan koordinat yang dapat diberikan, kolom arah diperlukan untuk memastikan peristiwa ditampilkan pada arah mengemudi yang benar. <direction>BOTH_DIRECTIONS</direction> |
jalan | Wajib | Teks bebas | Menentukan nama jalan atau jalan tempat peristiwa terjadi. Harus cocok dengan peta Waze. <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 menghilangkannya untuk insiden yang bukan jenisnya Road_CLOSED dan kami akan menganggap insiden tersebut sedang aktif. Stempel waktu harus dalam format ISO8601 dengan perincian detik dan menyertakan offset zona waktu. <starttime>2023-04-07T09:00:00+01:00</starttime> |
waktu berakhir | 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, waktu default-nya 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 berisi 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 lajur | opsional | informasi dampak lajur terstruktur | Berikan informasi ini hanya jika insiden tersebut tidak menyebabkan penutupan jalan sepenuhnya.
Berikan informasi tentang semua jalur dengan menentukan array jalur, menggunakan
format jalur WZDx atau format yang 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 parsial: <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 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 tentang sifat insiden itu. Subjenis yang dapat diterima ditentukan berdasarkan jenis yang diberikan.
Jenis | Kemungkinan subjenis |
---|---|
ACCIDENT |
|
HAZARD |
|
ROAD_CLOSED |
|
JAM |
|
POLICE |
|