Informasi penutupan jalan

Anda dapat menggunakan feed Partner Waze untuk memberikan penutupan jalan yang direncanakan dan real time secara otomatis dan dalam skala besar.

Penutupan terencana yang Anda kirim ke Waze akan muncul di Editor Peta Waze, dan akan muncul di aplikasi Waze selama waktu penutupan yang sebenarnya.

Berikan penutupan jalan hanya jika semua lajur di jalan ditutup. Jika penutupan hanya memengaruhi beberapa jalur, jelaskan jalur yang terpengaruh di elemen dampak jalur.

Agar penutupan jalan muncul di peta secara akurat, Anda harus mengikuti panduan di bawah dan spesifikasi CIFS.

Jika feed Anda tidak mematuhi spesifikasi CIFS, tetapi menyertakan semua data yang diperlukan, Waze mungkin masih dapat memprosesnya. Kirimkan feed Anda melalui Partner Hub untuk validasi dan masukan.

Jika data tidak lengkap atau tidak kompatibel, penutupan tidak akan otomatis muncul di peta, tetapi akan dikirim ke Komunitas Editor kami sebagai 'masalah peta' untuk ditinjau, disetujui, atau ditolak secara manual.

Membagikan penutupan

1. Menentukan tag penutupan

Untuk memetakan penutupan jalan, tentukan ROAD_CLOSED sebagai input tag elemen type.

2. Menyusun penutupan

Untuk membagikan penutupan kepada Waze, tentukan polyline (wajib) dan direction (diminta).

  • Polyline adalah urutan koordinat yang mengikuti geometri jalan dan menjelaskan ruas jalan yang harus ditutup.
  • Urutan koordinat dalam polyline memberi tahu kita arah traffic mana yang terpengaruh.
  • direction menunjukkan apakah penutupan berlaku untuk satu, atau kedua arah lalu lintas.

Untuk penutupan di jalan satu arah:

  • Urutan titik dalam polyline harus cocok dengan arah lalu lintas.
  • Untuk menghindari ambiguitas dan mengatasi perbedaan pemetaan, sebaiknya tentukan ONE_DIRECTION bahkan untuk jalan satu arah.

Untuk penutupan di jalan dua arah:

  • Jika penutupan hanya memengaruhi satu arah: urutan koordinat dalam polyline memberi tahu kita arah lalu lintas mana yang akan ditutup.
  • Jika penutupan memengaruhi kedua arah: bagikan poligon, dan di kolom arah, tunjukkan BOTH_DIRECTIONS.

Untuk polyline yang membentang dari titik A ke titik B, penutupan akan memengaruhi arah lalu lintas berdasarkan arah dan jenis jalan seperti yang terlihat di bawah:

Gambar yang menjelaskan perilaku polyline dan arah.

3. Membentuk polyline

  • Makin mirip polyline dengan geometri jalan, makin besar kemungkinan Waze dapat mencocokkannya dengan benar dan memproses penutupan.
    Sebaiknya berikan beberapa titik untuk setiap segmen di antara koordinat awal dan akhir. Hanya memberikan 2 koordinat mungkin cukup untuk segmen pendek atau lurus, tetapi sering kali menyebabkan kegagalan pemrosesan.
    Polyline berikut mempertahankan bentuk umum jalan dengan benar:

    Gambar polyline yang digunakan dalam konteks.
    Polyline berikut tidak mencerminkan geometri jalan dengan jelas karena hanya memberikan koordinat awal dan akhir:

    Gambar polyline yang digunakan dalam konteks.

  • Waze akan menggunakan polyline yang Anda berikan untuk menerapkan peristiwa ke satu atau beberapa segmen di peta Waze. Perhatikan bahwa penutupan yang diterapkan mungkin lebih panjang atau sedikit lebih pendek dari polyline, karena Waze hanya dapat menutup seluruh segmen seperti yang dikonfigurasi di peta Waze.
  • Jika Anda hanya menentukan sebagian segmen untuk ditutup, seluruh segmen akan ditutup.
  • Sebaiknya titik awal dan akhir penutupan berjarak minimal 30 meter.
  • Panjang polyline yang diberikan tidak boleh melebihi 20 km.

4. Pastikan penutupan Anda sesuai dengan pedoman berikut:

  • Nama jalan
    • Penutupan hanya dapat memengaruhi satu jalan di peta Waze. Koordinat awal dan akhir penutupan harus memiliki nama jalan yang sama. Penutupan yang dilaporkan yang mencakup nama jalan yang berbeda mungkin akan gagal diproses, meskipun polyline yang tepat diberikan.
    • Waze akan mencoba mencocokkan nama jalan yang Anda berikan dengan nama jalan utama atau alternatif di peta Waze di lokasi yang dilaporkan. Kecocokan penuh atau sebagian akan membantu kami mengidentifikasi dengan benar jalan mana yang akan ditutup, terutama jika ada beberapa kandidat.
      • Contoh: I-95S, I-95 Southbound, dan JFK Memorial Highway semuanya akan berhasil dicocokkan dengan jalan yang sama.
    • Untuk memastikan bahwa nama jalan yang Anda berikan di listingan cocok dengan nama jalan di peta Waze, gunakan Reverse Geocoding API Waze atau periksa Editor Peta Waze.
  • Penutupan feed hanya dapat dilakukan pada jenis jalan Waze berikut:
    • Jalan Tol
    • Jalan raya
    • Jalanan Kota
    • Jalan Landai
    • Jalan pribadi
  • Penutupan jalan tidak dapat dilaporkan di jalan pejalan kaki.
  • Waktu mulai:
    • ​Anda harus memberikan waktu mulai untuk penutupan.
    • Jika tidak yakin dengan waktu mulai, Anda dapat menggunakan stempel waktu laporan awal.
    • Perubahan waktu mulai:
      • Penutupan aktif: Setelah waktu mulai penutupan berlalu (yaitu, penutupan aktif), waktu mulai tidak boleh diubah.
      • Penutupan mendatang: Untuk penutupan yang belum dimulai, Anda dapat mengubah waktu mulai jika diperlukan. Namun, pastikan event_id tetap sama untuk mempertahankan konsistensi.
  • Waktu berakhir:
    • Jika Anda tidak mengetahui waktu berakhirnya, biarkan kosong. Penutupan tanpa waktu berakhir akan diberi durasi default (saat ini 2 minggu), lalu masa berlakunya akan berakhir kecuali jika diperpanjang secara eksplisit dengan menentukan waktu berakhir baru. Anda dapat mengubah waktu berakhir setelah memublikasikan acara, tetapi hindari menetapkan waktu berakhir secara dinamis berdasarkan waktu saat ini.

Untuk mengetahui spesifikasi tag Spesifikasi Feed Insiden dan Penutupan (CIFS) yang lebih mendetail, lihat Spesifikasi CIFS.

Contoh penutupan

Contoh berikut menunjukkan satu penutupan jalan dalam format XML dan JSON.

Penutupan XML

Berikut adalah contoh feed yang berisi satu penutupan jalan dalam format 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>

Penutupan JSON

Berikut adalah contoh file feed yang berisi satu penutupan jalan dalam format 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"
      }
    }
  ]
}

Contoh berikut menunjukkan seluruh file feed penutupan jalan dalam format XML dan JSON.

File feed XML

Berikut adalah contoh file feed penutupan jalan lengkap dalam 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>

File feed JSON

Berikut adalah contoh file feed penutupan jalan lengkap dalam 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"
    }
  ]
}