ข้อกำหนดของ CIFS

CIFS (ข้อกำหนดฟีดการปิดถนนและเหตุการณ์) เป็นโปรโตคอลมาตรฐานของ Waze ที่ใช้อธิบายเหตุการณ์และการปิดถนนในฟีดของพาร์ทเนอร์

ตารางพารามิเตอร์ด้านล่างจำแนกองค์ประกอบแต่ละรายการดังนี้

• จำเป็น: หากไม่มีค่าที่จัดรูปแบบอย่างถูกต้องสำหรับแท็กที่จำเป็น ฟีดของคุณจะถือว่าไม่ถูกต้อง
• ขอ: แม้ว่าจะไม่จำเป็นในทางเทคนิค แต่แท็กที่ขอถือเป็นแท็กที่แนะนำ
• ไม่บังคับ: แท็กที่ไม่บังคับที่ช่วยให้คุณระบุข้อมูลเพิ่มเติมได้

ลำดับขององค์ประกอบไม่สำคัญต่อเครื่องมือแยกวิเคราะห์ไฟล์

แท็กเหล่านี้อธิบายเหตุการณ์หรือการปิดถนนตามค่าของแท็ก type ความแตกต่างเล็กน้อยจะอธิบายตามส่วนที่เกี่ยวข้อง

ต่อไปนี้เป็นตัวอย่างการปิดถนนในฟีด
ต่อไปนี้คือตัวอย่างของเหตุการณ์ในฟีด
โปรดทราบว่าคุณรวมการปิดถนนและเหตุการณ์ในไฟล์ฟีดเดียวกันได้

องค์ประกอบ CIFS

องค์ประกอบ	จำเป็น	อินพุตแท็ก	คำอธิบาย
รหัสเหตุการณ์	จำเป็น	ข้อความอิสระ	ระบุตัวระบุที่เป็นตัวเลขและตัวอักษร รหัสต้องไม่ซ้ำกันภายในฟีดและคงที่ตลอดอายุการใช้งานของเหตุการณ์ <incident id="LND11DEayKr">...</incident>
ประเภท	จำเป็น	หนึ่งในรายการต่อไปนี้ ROAD_CLOSED ACCIDENT HAZARD POLICE CHIT_CHAT JAM	ประเภทนี้จะกำหนดวิธีที่แอป Waze จะใช้กิจกรรม ROAD_CLOSED จะส่งผลให้มีการปิดกิจกรรมโดยสมบูรณ์ ข้อมูลประเภทอื่นๆ ทั้งหมดจะปรากฏในแผนที่ Waze และจะเรียกแบบป๊อปอัปแจ้งเตือนสำหรับผู้ใช้ Waze ที่อยู่ใกล้เคียง แต่จะไม่ส่งผลต่อการกำหนดเส้นทางโดยตรง <type>ROAD_CLOSED</type>
ประเภทย่อย	ได้ขอมาแล้ว	ดูรายการประเภทย่อยที่อนุญาต	คำอธิบายที่ถูกต้องมากขึ้นสำหรับประเภทเหตุการณ์ที่รายงาน ประเภทย่อยต้องตรงกับค่าที่ระบุไว้ในแท็กประเภท นี่คือรายการประเภทย่อยที่อนุญาตสำหรับแต่ละประเภททั้งหมด
เส้นประกอบ	จำเป็น	รายการคู่ว่าง lat lon คู่ที่คั่นด้วยช่องว่าง	พิกัดละติจูดและลองจิจูดแบบองศาทศนิยม (DD, การฉายภาพ SRID 4326) ที่อธิบายตำแหน่งของเหตุการณ์หรือการปิดถนน โดยหลักการแล้วควรมีตัวเลขตามหลังจุดทศนิยมอย่างน้อย 6 หลักเพื่อความแม่นยำที่เพียงพอ ลำดับของพิกัดต้องแสดงถึงทิศทางการจราจรที่ได้รับผลกระทบ เราไม่สามารถหักทิศทางการเข้าชมจากจุดเดียวได้ หากเหตุการณ์ส่งผลต่อทิศทางการจราจรเพียงเส้นทางเดียว คุณควรระบุพิกัดเพิ่มเติมเพื่อชี้แจงทิศทาง เส้นประกอบต่อไปนี้จะส่งผลต่อทิศทางการจราจร 1 ทิศทาง (เพิ่มองค์ประกอบ direction เพื่อส่งผลกระทบต่อทั้ง 2 ทิศทาง) <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	ได้ขอมาแล้ว	BOTH_DIRECTIONS หรือ ONE_DIRECTION	ระบุว่าเหตุขัดข้องหรือการปิดถนนส่งผลต่อเส้นทางการจราจรบนถนนเพียงเส้นเดียวหรือทั้ง 2 เส้น ขอแนะนำให้ระบุทิศทาง แม้จะระบุเส้นประกอบก็ตาม หากสามารถระบุพิกัดได้ชุดเดียว จะต้องระบุฟิลด์ทิศทางเพื่อให้แน่ใจว่ากิจกรรมจะแสดงในทิศทางการขับที่ถูกต้อง <direction>BOTH_DIRECTIONS</direction>
ถนน	จำเป็น	ข้อความอิสระ	ระบุชื่อถนนหรือถนนที่เกิดเหตุการณ์ขึ้น ควรตรงกับแผนที่ Waze <street>NW 12th St</street>
เวลาเริ่มต้น	จำเป็น	yyyy-MM-dd'T'HH:mm:ss+HH:mm	ระบุวันที่และเวลาเริ่มต้นสำหรับการหยุดชะงักหนึ่งช่วงเวลา คุณสามารถละเว้นได้สำหรับเหตุการณ์ที่ไม่ใช่ประเภท ROAD_CLOSED และเราจะถือว่าเหตุการณ์ดังกล่าวทำงานอยู่ การประทับเวลาต้องอยู่ในรูปแบบ ISO8601 ในระดับรายละเอียดเป็นวินาที และรวมค่าออฟเซ็ตเขตเวลาไว้ด้วย <starttime>2023-04-07T09:00:00+01:00</starttime>
เวลาสิ้นสุด	ได้ขอมาแล้ว	yyyy-MM-dd'T'HH:mm:ss+HH:mm	ระบุวันที่และเวลาสิ้นสุดโดยใช้รูปแบบ ISO8601 แบบละเอียดเป็นหน่วยวินาทีและรวมออฟเซ็ตเขตเวลา หากไม่เลือกช่องนี้ ระบบจะเลือกค่าเริ่มต้นเป็น 14 วันหลังจากเวลาเริ่มต้น <endtime>2023-04-07T23:00:00+01:00</endtime>
คำอธิบาย	ได้ขอมาแล้ว	ข้อความอิสระ	สาเหตุของเหตุขัดข้องการจราจร คำอธิบายนี้ควรมีอักขระไม่เกิน 40 ตัว ระบบจะยอมรับคำอธิบายที่ยาวเกิน 40 อักขระ แต่อาจไม่แสดงในแอป Waze อย่างถูกต้อง <description>I-95 All NB lanes closed btwn Exits 184 and 186.</description>
ผลกระทบต่อเลน	ไม่บังคับ	ข้อมูลผลกระทบของเลนที่มีโครงสร้าง	จัดเตรียมส่วนนี้เฉพาะในกรณีที่เหตุการณ์ไม่ได้ส่งผลให้มีการปิดถนนอย่างสมบูรณ์ ให้ข้อมูลของช่องทางทั้งหมดโดยระบุอาร์เรย์ของช่องทางโดยใช้ รูปแบบช่องทาง WZDx หรือรูปแบบที่คล้ายกัน ผลกระทบต่อช่องทางแบ่งออกเป็น 2 รูปแบบ คือ บางส่วนและแบบเต็ม ตัวอย่างรูปแบบแบบเต็ม <lanes> <lane> <order>1</order> <type>LANE</type> <status>CLOSED</status> </lane> <lane> <order>2</order> <type>LANE</type> <status>OPEN</status> </lane> </lanes> ตัวอย่างรูปแบบบางส่วน: <lane_impact> <total_closed_lanes>2</total_closed_lanes> <roadside>RIGHT</roadside> </lane_impact>
กำหนดเวลา	ไม่บังคับ	<dayname>hh:mm-hh:mm</dayname>	สรุปวันที่และเวลาเริ่มต้นและสิ้นสุดทั้งหมดสำหรับเหตุการณ์ <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>

ประเภทย่อยของเหตุการณ์และการปิด

ให้รายละเอียดเพิ่มเติมเกี่ยวกับลักษณะของเหตุการณ์ ระบบจะกำหนดประเภทย่อยที่ยอมรับได้ตามประเภทที่ระบุ

ประเภท	ประเภทย่อยที่เป็นไปได้
ACCIDENT	ACCIDENT_MINOR ACCIDENT_MAJOR
HAZARD	HAZARD_ON_ROAD HAZARD_ON_ROAD_CAR_STOPPED HAZARD_ON_ROAD_CONSTRUCTION HAZARD_ON_ROAD_EMERGENCY_VEHICLE HAZARD_ON_ROAD_ICE HAZARD_ON_ROAD_LANE_CLOSED HAZARD_ON_ROAD_OBJECT HAZARD_ON_ROAD_OIL HAZARD_ON_ROAD_POT_HOLE HAZARD_ON_ROAD_ROAD_KILL HAZARD_ON_ROAD_TRAFFIC_LIGHT_FAULT HAZARD_ON_SHOULDER HAZARD_ON_SHOULDER_ANIMALS HAZARD_ON_SHOULDER_CAR_STOPPED HAZARD_ON_SHOULDER_MISSING_SIGN HAZARD_WEATHER HAZARD_WEATHER_FLOOD HAZARD_WEATHER_FOG HAZARD_WEATHER_FREEZING_RAIN HAZARD_WEATHER_HAIL HAZARD_WEATHER_HEAT_WAVE HAZARD_WEATHER_HEAVY_RAIN HAZARD_WEATHER_HEAVY_SNOW HAZARD_WEATHER_HURRICANE HAZARD_WEATHER_MONSOON HAZARD_WEATHER_TORNADO
ROAD_CLOSED	ROAD_CLOSED_HAZARD ROAD_CLOSED_CONSTRUCTION ROAD_CLOSED_EVENT
JAM	JAM_LIGHT_TRAFFIC JAM_MODERATE_TRAFFIC JAM_HEAVY_TRAFFIC JAM_STAND_STILL_TRAFFIC
POLICE	POLICE_VISIBLE POLICE_HIDING