ข้อกำหนด 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 หลัก เพื่อให้มีความแม่นยำเพียงพอ ลำดับของพิกัดต้องแสดงทิศทางการจราจรที่ได้รับผลกระทบ เราไม่สามารถสรุปทิศทางการเข้าชมจากจุดเดียวได้ หากเหตุการณ์ส่งผลต่อการจราจรในทิศทางเดียวเท่านั้น คุณควรระบุพิกัดเพิ่มเติมเพื่อชี้แจงทิศทาง เส้นหลายเส้นต่อไปนี้จะส่งผลต่อการจราจรในทิศทางเดียว (เพิ่มองค์ประกอบ 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>
ถนน	ต้องระบุ	ข้อความอิสระ	ระบุชื่อถนนที่เกิดเหตุการณ์ <street>NW 12th St</street>
starttime	ต้องระบุ	yyyy-MM-dd'T'HH:mm:ss+HH:mm	ระบุวันที่และเวลาเริ่มต้นของช่วงที่เกิดการหยุดชะงัก คุณละเว้น ได้สำหรับเหตุการณ์ที่ไม่ใช่ประเภท ROAD_CLOSED และเราจะถือว่าเหตุการณ์นั้นยังคงเกิดขึ้นอยู่ การประทับเวลาต้องอยู่ในรูปแบบ ISO8601 โดยระบุรายละเอียดเป็นวินาทีและรวมออฟเซ็ตเขตเวลา <starttime>2023-04-07T09:00:00+01:00</starttime>
endtime	ได้ขอมาแล้ว	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 รูปแบบ ได้แก่ แบบเต็มและแบบบางส่วน ตัวอย่างรูปแบบเต็ม: <order>1</order> แสดงถึงเลนซ้ายสุด <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 POLICE_WITH_MOBILE_CAMERA