Informasi penutupan jalan

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

Rencana penutupan jalan yang Anda kirim ke Waze akan muncul di Editor Peta Waze, dan akan muncul di aplikasi Waze pada saat penutupan sebenarnya.

Memberikan penutupan jalan hanya jika semua jalur di jalan ditutup. Jika penutupan Anda 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. Kirim feed Anda melalui Partner Hub untuk validasi dan masukan.

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

Membagikan penutupan

1. Tentukan tag penutupan

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

2. Buat struktur penutupan

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

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

Untuk penutupan di jalan satu arah:

  • Urutan titik dalam polyline harus sesuai dengan arah lalu lintas.
  • Untuk menghindari ambiguitas dan mengatasi perbedaan pemetaan, sebaiknya Anda menentukan 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 rute: bagikan polyline, dan di kolom arah, tunjukkan BOTH_DIRECTIONS.

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

Gambar yang menjelaskan perilaku polyline dan arah.

3. Membentuk polyline

  • Semakin dekat polyline menyerupai geometri jalan, semakin besar kemungkinan Waze dapat mencocokkannya dengan benar dan memproses penutupan.
    Sangat disarankan untuk memberikan beberapa titik di antara koordinat awal dan akhir bagi setiap segmen. Hanya memberikan 2 koordinat sudah cukup untuk segmen pendek atau lurus, tetapi sering kali menjadi penyebab kegagalan pemrosesan.
    Polyline berikut mempertahankan bentuk umum jalan dengan benar:

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

    Gambar polyline digunakan dalam konteks.

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

4. Pastikan penutupan Anda sesuai dengan panduan berikut:

  • Nama jalan
    • Penutupan hanya dapat memengaruhi satu jalan atau jalan di peta Waze. Koordinat awal dan akhir penutupan harus memiliki nama jalan yang sama. Penutupan yang dilaporkan yang mencakup berbagai nama jalan mungkin akan gagal diproses, meskipun polyline yang tepat disediakan.
    • Waze akan mencoba mencocokkan nama jalan yang Anda berikan dengan nama jalan utama atau alternatif pada peta Waze di lokasi yang dilaporkan. Kecocokan penuh atau sebagian akan membantu kami mengidentifikasi dengan benar jalan mana yang harus 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 nama jalan dan jalan yang Anda berikan di listingan cocok dengan nama di peta Waze, gunakan Reverse Geocoding API Waze atau periksa Editor Peta Waze.
  • Penutupan feed hanya dapat dilakukan pada jenis jalan Waze berikut:
    • Jalan Bebas Hambatan
    • Jalan raya
    • Jalan-Jalan Kota
    • Jalan Landai
    • Jalan pribadi
  • Jenis jalan Waze yang tidak dapat ditutup menggunakan feed mencakup hal berikut:
    • Jalan tempat parkir
    • Jalan off-road (4x4) dan jalan untuk pejalan kaki
  • Waktu mulai dan berakhir:
    • Waktu mulai: Anda harus memberikan waktu mulai untuk penutupan. Jika tidak yakin dengan waktu mulainya, Anda dapat menggunakan stempel waktu laporan awal, tetapi JANGAN ubah waktu mulai setelah memublikasikan peristiwa.
    • Waktu berakhir: Jika Anda tidak mengetahui waktu berakhir, kosongkan. Penutupan tanpa waktu berakhir akan diberi durasi default (saat ini 2 minggu), lalu akan berakhir masa berlakunya kecuali diperpanjang secara eksplisit dengan menentukan waktu berakhir yang baru. Anda dapat mengubah waktu berakhir setelah memublikasikan acara, tetapi jangan tetapkan waktu berakhir secara dinamis berdasarkan waktu saat ini.

    Untuk spesifikasi tag Closure and Incident Feed Specification (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>2016-04-07T09:00:00+01:00</starttime>
    <endtime>2016-04-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": "2016-04-07T09:00:00+01:00",
        "endtime": "2016-04-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>2017-07-04T13:31:17-04:00</creationtime>
      <updatetime>2017-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>2017-06-05T00:01:00-04:00</starttime>
      <endtime>2017-11-22T15:30:00-05:00</endtime>
    </incident>
    <incident id="zxf3kvmrpf">
      <creationtime>2017-08-04T13:31:30-04:00</creationtime>
      <updatetime>2017-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>2017-04-18T00:01:00-04:00</starttime>
      <endtime>2017-12-31T23:59:00-05:00</endtime>
    </incident>
</incidents>

    File feed JSON

    Berikut adalah contoh file feed penutupan jalan lengkap di JSON:

    {
  "incidents": [
    {
      "id": "3f4r45ff233",
      "creationtime": "2017-07-04T13:31:17-04:00",
      "updatetime": "2017-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": "2017-06-05T00:01:00-04:00",
      "endtime": "2017-11-22T15:30:00-05:00",
      "type": "ROAD_CLOSED"
    },
    {
      "id": "zxf3kvmrpf",
      "creationtime": "2017-08-04T13:31:30-04:00",
      "updatetime": "2017-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": "2017-04-18T00:01:00-04:00",
      "endtime": "2017-12-31T23:59:00-05:00"
    }
  ]
}