ข้อมูลการปิดถนน
คุณสามารถใช้ฟีดพาร์ทเนอร์ Waze เพื่อระบุการปิดถนนที่วางแผนไว้และแบบเรียลไทม์โดยอัตโนมัติในวงกว้าง
การปิดถนนตามกำหนดการที่คุณส่งไปยัง Waze จะปรากฏในเครื่องมือแก้ไขแผนที่ของ Waze และจะปรากฏในแอป Waze ในช่วงเวลาที่ปิดจริง
ระบุการปิดถนนเฉพาะในกรณีที่มีการปิดเลนทั้งหมดบนถนน หากการปิดถนนส่งผลกระทบต่อบางเลนเท่านั้น ให้อธิบายเลนที่ได้รับผลกระทบในองค์ประกอบผลกระทบต่อเลน
คุณควรทำตามหลักเกณฑ์ด้านล่างและข้อกำหนด CIFS เพื่อให้การปิดถนนปรากฏบนแผนที่อย่างถูกต้อง
หากฟีดไม่เป็นไปตามข้อกำหนด CIFS แต่มีข้อมูลที่จำเป็นทั้งหมด Waze อาจยังคงประมวลผลฟีดได้ ส่งฟีดผ่านพาร์ทเนอร์ฮับเพื่อรับการตรวจสอบและความคิดเห็น
ในกรณีที่ข้อมูลไม่สมบูรณ์หรือไม่เข้ากันได้ การปิดจะไม่ปรากฏบนแผนที่โดยอัตโนมัติ แต่ระบบจะส่งไปยังชุมชนผู้แก้ไขของเราเป็น "ปัญหาเกี่ยวกับแผนที่" เพื่อรับการตรวจสอบ อนุมัติ หรือปฏิเสธโดยเจ้าหน้าที่
การแชร์การปิด
1. ระบุแท็กปิด
หากต้องการแมปการปิดถนน ให้ระบุ ROAD_CLOSED
เป็นอินพุตแท็กขององค์ประกอบ type
2. จัดโครงสร้างการปิด
หากต้องการแชร์การปิดถนนกับ Waze ให้ระบุ polyline
(ต้องระบุ) และ direction
(ขอ)
- เส้นประกอบคือลําดับพิกัดที่เป็นไปตามเรขาคณิตของถนนและอธิบายส่วนของถนนที่ควรปิด
- ลำดับพิกัดในเส้นประกอบจะบอกเราว่าทิศทางการจราจรใดได้รับผลกระทบ
direction
ระบุว่าการปิดถนนมีผลกับเส้นทางหนึ่งหรือทั้ง 2 เส้นทาง
สำหรับการปิดถนนแบบเดินรถทางเดียว
- ลําดับของจุดในเส้นประกอบต้องตรงกับทิศทางการจราจร
- เราขอแนะนำให้ระบุ
ONE_DIRECTION
แม้สำหรับถนนเดินรถทางเดียว เพื่อหลีกเลี่ยงความคลุมเครือและความแตกต่างในการแมป
สำหรับการปิดถนน 2 เลน
- หากการปิดถนนส่งผลกระทบต่อทิศทางเดียว ลำดับพิกัดในเส้นประกอบจะบอกเราว่าควรปิดการจราจรในทิศทางใด
- หากการปิดถนนมีผลกับทั้ง 2 ทิศทาง ให้แชร์รูปหลายเหลี่ยมและระบุ
BOTH_DIRECTIONS
ในช่องทิศทาง
สำหรับเส้นประกอบที่ทอดยาวจากจุด ก. ถึงจุด ข. การปิดถนนจะส่งผลต่อทิศทางการจราจรโดยอิงตามทิศทางและประเภทถนนดังที่แสดงด้านล่าง
3. กำหนดรูปร่างของเส้นประกอบ
ยิ่งเส้นประกอบมีลักษณะคล้ายกับเรขาคณิตของถนนมากเท่าใด Waze ก็ยิ่งมีโอกาสจับคู่ได้อย่างถูกต้องและประมวลผลการปิดถนนได้มากขึ้นเท่านั้น
เราขอแนะนำให้ระบุจุดหลายจุดสำหรับแต่ละส่วนของพิกัดเริ่มต้นและสิ้นสุด การระบุพิกัดเพียง 2 รายการอาจเพียงพอสำหรับส่วนของถนนสั้นๆ หรือตรงๆ แต่มักเป็นสาเหตุของการประมวลผลที่ไม่สำเร็จ
เส้นประกอบต่อไปนี้คงรูปร่างทั่วไปของถนนไว้อย่างถูกต้อง
รูปหลายเส้นต่อไปนี้ไม่ได้แสดงเรขาคณิตของถนนอย่างชัดเจนเนื่องจากระบุเฉพาะพิกัดเริ่มต้นและสิ้นสุด
- Waze จะใช้เส้นประกอบที่คุณระบุเพื่อใช้เหตุการณ์กับกลุ่มอย่างน้อย 1 กลุ่มบนแผนที่ Waze โปรดทราบว่าการปิดที่ใช้อาจยาวหรือสั้นกว่าโพลีไลน์เล็กน้อย เนื่องจาก Waze จะปิดได้เฉพาะทั้งส่วนที่กําหนดค่าไว้ในแผนที่ Waze
- หากคุณระบุเฉพาะบางส่วนของกลุ่มที่จะปิด ระบบจะปิดทั้งกลุ่ม
- เราขอแนะนำให้จุดเริ่มต้นและจุดสิ้นสุดของการปิดควรอยู่ห่างกันอย่างน้อย 30 เมตร
- ความยาวของเส้นประกอบที่ระบุไม่ควรเกิน 20 กิโลเมตร
4. ตรวจสอบว่าช่วงปิดอยู่ภายใต้หลักเกณฑ์ต่อไปนี้
- ชื่อถนน
- การปิดถนนจะส่งผลต่อถนนหรือตรอกซอกซอยเพียง 1 แห่งในแผนที่ Waze เท่านั้น พิกัดเริ่มต้นและสิ้นสุดของการปิดถนนต้องมีชื่อถนนเดียวกัน การปิดถนนที่รายงานซึ่งครอบคลุมชื่อถนนที่แตกต่างกันอาจประมวลผลไม่สำเร็จ แม้ว่าจะมีการระบุรูปหลายเหลี่ยมที่แน่นอนแล้วก็ตาม
- Waze จะพยายามจับคู่ชื่อถนนที่คุณระบุกับชื่อถนนหลักหรือชื่อถนนสำรองในแผนที่ Waze ณ ตำแหน่งที่รายงาน การจับคู่ทั้งหมดหรือบางส่วนจะช่วยให้เราระบุถนนที่จะปิดได้อย่างถูกต้อง โดยเฉพาะเมื่อมีตัวเลือกหลายรายการ
- ตัวอย่างเช่น I-95S, I-95 Southbound และ JFK Memorial Highway จะจับคู่กับถนนเดียวกันได้สําเร็จ
- โปรดตรวจสอบว่าชื่อถนนที่คุณระบุในข้อมูลตรงกับชื่อถนนในแผนที่ Waze โดยใช้ Reverse Geocoding API ของ Waze หรือตรวจสอบในเครื่องมือแก้ไขแผนที่ของ Waze
- การปิดฟีดทำได้กับถนนประเภทต่อไปนี้ของ Waze เท่านั้น
- ทางหลวง
- ทางหลวง
- ถนนในเมือง
- ทางลาด
- ถนนส่วนบุคคล
- ไม่สามารถรายงานการปิดถนนบนทางเท้า
- เวลาเริ่มต้น:
- คุณต้องระบุเวลาเริ่มต้นของช่วงปิด
- หากไม่แน่ใจเกี่ยวกับเวลาเริ่มต้น ให้ใช้การประทับเวลาของรายงานเริ่มต้น
- การแก้ไขเวลาเริ่มต้น
- การปิดที่ใช้งานอยู่: เมื่อผ่านเวลาเริ่มต้นของการปิดแล้ว (กล่าวคือ การปิดใช้งานอยู่) คุณต้องไม่แก้ไขเวลาเริ่มต้น
- การปิดในอนาคต: สําหรับการปิดที่ยังไม่ได้เริ่ม คุณสามารถแก้ไขเวลาเริ่มต้นได้หากจําเป็น อย่างไรก็ตาม โปรดตรวจสอบว่า event_id ยังคงเหมือนเดิมเพื่อรักษาความสอดคล้อง
- เวลาสิ้นสุด:
- หากไม่ทราบเวลาสิ้นสุด ให้เว้นว่างไว้ การปิดที่ไม่มีเวลาสิ้นสุดจะได้รับการกำหนดระยะเวลาเริ่มต้น (ปัจจุบันคือ 2 สัปดาห์) จากนั้นจะหมดอายุ เว้นแต่จะมีการขยายเวลาอย่างชัดเจนโดยระบุเวลาสิ้นสุดใหม่ คุณสามารถแก้ไขเวลาสิ้นสุดหลังจากเผยแพร่กิจกรรมแล้ว แต่หลีกเลี่ยงการตั้งค่าเวลาสิ้นสุดแบบไดนามิกตามเวลาปัจจุบัน
ดูข้อกำหนดเฉพาะเพิ่มเติมเกี่ยวกับแท็กข้อกำหนดฟีดการปิดและเหตุการณ์ (CIFS) ได้ที่ข้อกำหนด CIFS
ตัวอย่างการปิด
ตัวอย่างต่อไปนี้แสดงการปิดถนนครั้งเดียวในรูปแบบ XML และ JSON
การปิด XML
ต่อไปนี้คือตัวอย่างฟีดที่มีการปิดถนนรายการเดียวในรูปแบบ XML
<incidents> <incident id="101"> <type>ROAD_CLOSED</type> <subtype>ROAD_CLOSED_CONSTRUCTION</subtype> <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> <street>NW 12th St</street> <starttime>2024-06-07T09:00:00+01:00</starttime> <endtime>2024-06-07T23:00:00+01:00</endtime> <description>Closure on I-95 NB due to construction</description> <direction>BOTH_DIRECTIONS</direction> </incident> </incidents>
การปิด JSON
ต่อไปนี้คือตัวอย่างไฟล์ฟีดที่มีการปิดถนนรายการเดียวในรูปแบบ JSON
{ "incidents": [ { "incident": { "id": "101", "type": "ROAD_CLOSED", "subtype": "ROAD_CLOSED_CONSTRUCTION", "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", "street": "NW 12th St", "starttime": "2024-06-07T09:00:00+01:00", "endtime": "2024-06-07T23:00:00+01:00", "description": "Closure on I-95 NB due to construction", "direction": "BOTH_DIRECTIONS" } } ] }
ตัวอย่างต่อไปนี้แสดงไฟล์ฟีดการปิดถนนทั้งไฟล์ในรูปแบบ XML และ JSON
ไฟล์ฟีด XML
ต่อไปนี้คือตัวอย่างไฟล์ฟีดการปิดถนนที่สมบูรณ์ในรูปแบบ XML
<?xml version="1.0" ?> <incidents xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="http://www.gstatic.com/road-incidents/cifsv2.xsd"> <incident id="3f4r45ff233"> <creationtime>2024-07-04T13:31:17-04:00</creationtime> <updatetime>2024-11-17T04:40:41-05:00</updatetime> <type>ROAD_CLOSED</type> <description>Complete road closure due to road works</description> <street>N Liberty St</street> <direction>BOTH_DIRECTIONS</direction> <polyline>42.1601432984533 -119.3525208937842 42.1781676611244 -119.35679623266</polyline> <starttime>2024-06-05T00:01:00-04:00</starttime> <endtime>2024-11-22T15:30:00-05:00</endtime> </incident> <incident id="zxf3kvmrpf"> <creationtime>2024-08-04T13:31:30-04:00</creationtime> <updatetime>2024-12-17T04:40:41-05:00</updatetime> <type>ROAD_CLOSED</type> <subtype>ROAD_CLOSED_CONSTRUCTION</subtype> <description>PLANNED ROAD CLOSURE St Johns Sdrd from William Graham to Woodbine in the Town of Aurora. Closed until Dec 31.</description> <street>St John's Sideroad</street> <direction>BOTH_DIRECTIONS</direction> <polyline>44.02712 -99.43131 44.023011 -99.363349 44.02712 -99.43131 44.0343021 -99.399426</polyline> <starttime>2024-04-18T00:01:00-04:00</starttime> <endtime>2024-12-31T23:59:00-05:00</endtime> </incident> </incidents>
ไฟล์ฟีด JSON
ต่อไปนี้คือตัวอย่างไฟล์ฟีดการปิดถนนที่สมบูรณ์ในรูปแบบ JSON
{ "incidents": [ { "id": "3f4r45ff233", "creationtime": "2024-07-04T13:31:17-04:00", "updatetime": "2024-11-17T04:40:41-05:00", "description": "Complete road closure due to road works", "street": "N Liberty St", "direction": "BOTH_DIRECTIONS", "polyline": "42.1601432984533 -119.3525208937842 42.1781676611244 -119.35679623266", "starttime": "2024-06-05T00:01:00-04:00", "endtime": "2024-11-22T15:30:00-05:00", "type": "ROAD_CLOSED" }, { "id": "zxf3kvmrpf", "creationtime": "2024-08-04T13:31:30-04:00", "updatetime": "2024-12-17T04:40:41-05:00", "description": "St Johns Sdrd from William Graham to Woodbine in the Town of Aurora. Closed until Dec 31. ", "type": "ROAD_CLOSED", "subtype": "ROAD_CLOSED_CONSTRUCTION", "street": "St John's Sideroad", "direction": "BOTH_DIRECTIONS", "polyline": "44.02712 -99.43131 44.023011 -99.363349 44.02712 -99.43131 44.0343021 -99.399426", "starttime": "2024-04-18T00:01:00-04:00", "endtime": "2024-12-31T23:59:00-05:00" } ] }