ข้อมูลการปิดถนน

คุณสามารถใช้ฟีดพาร์ทเนอร์ 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"
    }
  ]
}