Kapalı yol bilgileri

Planlanmış ve gerçek zamanlı kapalı yol bilgilerini otomatik olarak ve geniş ölçekte sağlamak için Waze İş Ortağı feed'ini kullanabilirsiniz.

Waze'e gönderdiğiniz planlı kapatmalar Waze Harita Düzenleyici'de ve kapatmanın gerçekleştiği gerçek zamanda Waze uygulamasında gösterilir.

Trafiğe kapalı yol bilgisini yalnızca yoldaki tüm şeritlerin kapalı olması durumunda sağlayın. Kapatmanız yalnızca şeritlerin bir kısmını etkiliyorsa şerit etkisi öğesinde etkilenen şeritleri açıklayın.

Kapalı yolların haritada doğru şekilde görünmesi için aşağıdaki yönergeleri ve CIFS özelliklerini uygulamanız gerekir.

Feed'iniz CIFS spesifikasyonlarına uymuyorsa ancak gerekli tüm verileri içeriyorsa Waze yine de feed'inizi işleyebilir. Doğrulama ve geri bildirim için feed'inizi İş Ortağı Merkezi üzerinden gönderin.

Eksik veya uyumlu olmayan veriler olması durumunda, kapatılmalar haritada otomatik olarak görünmez. Bunun yerine, manuel olarak incelenmek, onaylanma veya reddedilmek üzere "harita sorunu" olarak Düzenleyiciler Topluluğumuza gönderilir.

Kapanış paylaşma

1. Kapanış etiketini belirtme

Kapalı yolları haritaya eklemek için type öğesinin etiket girişi olarak ROAD_CLOSED değerini belirtin.

2. Kapanışınızı yapılandırma

Kapalı yolları Waze ile paylaşmak için polyline (zorunlu) ve direction (istek) değerlerini belirtin.

  • Çoklu çizgiler, yol geometrisini izleyen ve kapalı olması gereken yol bölümünü tanımlayan koordinat dizileridir.
  • Çoklu çizgideki koordinatların sırası, hangi trafik yönünün etkilendiğini bize bildirir.
  • direction, kapanış işleminin trafiğin bir yönünü mü yoksa her iki yönünü mü etkilediğini belirtir.

Tek yönlü yollarda kapalılık için:

  • Çoklu çizgideki noktaların sırası, trafik yönüyle eşleşmelidir.
  • Belirsizlikleri önlemek ve eşleme farklılıklarını gidermek için tek yönlü yollar için bile ONE_DIRECTION belirtmeniz önerilir.

İki yönlü yollarda kapalı yollar için:

  • Kapatılma yalnızca bir yönü etkiliyorsa: Çoklu çizgideki koordinatların sırası, hangi trafik yönünün kapatılacağını bize bildirir.
  • Kapatılma her iki yönü de etkiliyorsa: Poli çizgiyi paylaşın ve yön alanında BOTH_DIRECTIONS değerini belirtin.

A noktasından B noktasına uzanan bir çok çizgi için kapatma, aşağıdaki gibi yöne ve yol türüne bağlı olarak trafik yönünü etkiler:

Çoklu çizgi ve yön davranışını açıklayan bir resim.

3. Çoklu çizginizi şekillendirme

  • Çoklu çizgi, yolun geometrisine ne kadar yakınsa Waze'in doğru eşleştirip kapatma işlemini gerçekleştirme olasılığı o kadar yüksektir.
    Başlangıç ve bitiş koordinatları arasındaki her segment için birden fazla nokta sağlamanızı önemle tavsiye ederiz. Yalnızca 2 koordinat sağlamak kısa veya düz segmentler için yeterli olabilir ancak genellikle işleme hatalarına neden olur.
    Aşağıdaki çoklu çizgi, yolun genel şeklini doğru şekilde korur:

    Bağlamda kullanılan çoklu çizgi resmi.
    Aşağıdaki çoklu çizgi, yalnızca başlangıç ve bitiş koordinatlarını sağladığı için yol geometrisini net bir şekilde yansıtmıyor:

    Bağlamda kullanılan çoklu çizgi resmi.

  • Waze, etkinliği Waze haritasındaki bir veya daha fazla segmente uygulamak için sağladığınız çoklu çizgiyi kullanır. Waze yalnızca Waze haritasında yapılandırıldığı şekilde segmentlerin tamamını kapatabildiğinden, uygulanan kapatmanın poli çizgiden daha uzun veya biraz daha kısa olabileceğini unutmayın.
  • Kapatılacak segmentin yalnızca bir kısmını belirtirseniz segmentin tamamı kapatılır.
  • Kapatmanın başlangıç ve bitiş noktalarının en az 30 metre uzaklıkta olması önerilir.
  • Sağlanan çoklu çizginin uzunluğu 20 km'yi aşmamalıdır.

4. Kapanışınızın aşağıdaki yönergelere uyduğundan emin olun:

  • Sokak adları
    • Kapalı yollar, Waze haritasındaki yalnızca bir sokağı veya yolu etkileyebilir. Kapatmanın başlangıç ve bitiş koordinatları aynı sokak adına sahip olmalıdır. Farklı sokak adlarına yayılan bir kapalı yol bildirilirse tam bir poli çizgisi sağlansa bile işleme büyük olasılıkla başarısız olur.
    • Waze, belirttiğiniz sokak adını, bildirilen konumdaki Waze haritasındaki birincil veya alternatif yol adlarıyla eşleştirmeye çalışır. Tam veya kısmi eşleşme, özellikle birden fazla aday olduğunda hangi yolun kapatılacağını doğru şekilde belirlememize yardımcı olur.
      • Örnek: I-95S, I-95 Güney ve JFK Memorial Highway'ın tümü başarıyla aynı yola eşleştirilir.
    • Girişinizde belirttiğiniz sokak ve yol adlarının Waze haritasındakilerle eşleştiğinden emin olmak için Waze Ters Coğrafi Kodlama API'sini kullanın veya Waze Harita Düzenleyici'yi kontrol edin.
  • Feed kapatma işlemleri yalnızca aşağıdaki Waze yol türlerinde yapılabilir:
    • Otoyollar
    • Otoyollar
    • Şehir caddeleri
    • Rampalar
    • Özel yollar
  • Yaya yollarında kapalı yol bildirilemez.
  • Başlangıç zamanı:
    • ​Kapanış için bir başlangıç zamanı belirtmeniz gerekir.
    • Başlangıç zamanından emin değilseniz ilk raporun zaman damgasını kullanabilirsiniz.
    • Başlangıç zamanı değişiklikleri:
      • Etkin kapanışlar: Bir kapanış işleminin başlangıç zamanı geçtikten sonra (yani kapanış etkin olduğunda) başlangıç zamanı değiştirilmemelidir.
      • Gelecekteki kapanışlar: Henüz başlamamış kapanışlar için gerekirse başlangıç zamanını değiştirebilirsiniz. Ancak tutarlılığı korumak için lütfen event_id değerinin aynı kalmasını sağlayın.
  • Bitiş zamanı:
    • Bitiş saatini bilmiyorsanız alanı boş bırakın. Bitiş zamanı olmayan kapatmalara varsayılan bir süre (şu anda 2 hafta) atanır. Ardından, yeni bir bitiş zamanı belirtilerek açıkça uzatılmadığı sürece kapatma süresi sona erer. Etkinliği yayınladıktan sonra bitiş zamanını değiştirebilirsiniz ancak bitiş zamanlarını mevcut saate göre dinamik olarak ayarlamamaya çalışın.

Kapanış ve Olay Feed'i Spesifikasyonu (CIFS) etiketleriyle ilgili daha ayrıntılı spesifikasyonlar için CIFS spesifikasyonu başlıklı makaleyi inceleyin.

Kapanış örnekleri

Aşağıdaki örneklerde, tek bir yol kapatma işlemi XML ve JSON biçimlerinde gösterilmektedir.

XML kapatma

Aşağıda, XML biçiminde tek bir yol kapatma içeren bir feed örneği verilmiştir:

<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 kapatma

Aşağıda, JSON biçiminde tek bir yol kapatma içeren bir feed dosyası örneği verilmiştir:

{
  "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"
      }
    }
  ]
}

Aşağıdaki örneklerde, yol kapatma feed dosyası tamamıyla hem XML hem de JSON biçimlerinde gösterilmektedir.

XML feed dosyası

Aşağıda, XML biçiminde tam bir yol kapatma feed'i dosyası örneği verilmiştir:

<?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 feed dosyası

Aşağıda, JSON biçiminde eksiksiz bir yol kapatma feed'i dosyası örneği verilmiştir:

{
  "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"
    }
  ]
}