Informações sobre vias interditadas

É possível fornecer ao Waze informações de interdições programadas e em tempo real usando um feed. As programadas aparecem no editor de mapa do Waze e mostram os horários de início e término. Entretanto, elas só são exibidas enquanto a interdição está acontecendo.

As informações sobre interdições com dados (como horários de início e término, nome das ruas ou rotas) faltantes ou incorretos são adicionadas como alertas de interdição no mapa.

Esses problemas são indicados pelo seguinte ícone no editor de mapa do Waze:

Nessas situações, é necessário que um editor de mapa com nível mais alto na comunidade aceite ou rejeite a informação. Após a revisão e aprovação, os dados aparecerão no mapa. No entanto, sua organização não será associada ao alerta de interdição.

Para garantir que os nomes das ruas que você informar correspondam às informações do mapa, use a API Reverse Geocoding, já que as entradas sobre veículos em movimento ou incidentes com informações incorretas não serão exibidas no mapa.

Diretrizes de mapeamento das interdições

Para mapear uma via interditada, informe as tags necessárias no feed de interdições. Mapeie o bloqueio de acordo com as seguintes diretrizes:

  • No Waze, as interdições são criadas em cruzamentos, bifurcações e junções de vias. Não é possível mapear uma via interditada apenas em um trecho.

    O caso abaixo foi criado corretamente:

    O exemplo a seguir não está correto, porque usa parte de um trecho que não inclui um cruzamento, uma bifurcação ou uma junção:

  • A polilinha precisa ser semelhante à geometria da via. Os pontos não podem estar a mais de 50 metros de distância. A polilinha não precisa corresponder exatamente ao alinhamento da via, mas a forma geral deve ser mantida.

    O caso a seguir segue corretamente o formato da via:

    O exemplo abaixo ignora o desenho da via:

  • As interdições afetam apenas o nome de uma rua. Os pontos de início e término precisam ter o mesmo nome de rua. Não é possível usar trechos com mais de um nome de rua, mesmo que uma polilinha seja aplicada.
  • Só é possível criar feeds de interdições para os seguintes tipos de via:
    • Autoestradas
    • Rodovias
    • Ruas municipais
    • Rampas

    Os tipos abaixo não são suportados:

    • Vias particulares
    • Entradas de estacionamentos
    • Vias para pedestres e 4x4
  • As interdições não podem ter menos de 35 metros de comprimento.

Elementos da interdição

Use os elementos da tabela a seguir para criar uma interdição no seu arquivo de feed. A ordem deles não importa para o mecanismo de análise do arquivo.

Elemento Obrigatório Entrada da tag Descrição
incident id Obrigatório Texto livre

Código exclusivo para um único evento com pelo menos três caracteres alfanuméricos.


<incident id="LND11DEayKr">...</incident>
polyline Obrigatório lat lon

Coordenadas de latitude e longitude descrevendo a localização do incidente com pelo menos seis dígitos após o ponto decimal para aumentar a precisão.


<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 Obrigatório Texto livre

Especifica o nome da via em que o evento está ocorrendo. Precisa ter pelo menos 2 caracteres alfanuméricos.


<street>NW 12th St</street>
type Obrigatório ROAD_CLOSED

Descreve o alerta. No caso de interdições, ROAD_CLOSED é o único tipo usado. O elemento "subtypes" informa os motivos do bloqueio.


<type>ROAD_CLOSED</type>
starttime Obrigatório yyyy-MM-dd'T'HH:mm:ss+HH:mm

Especifique os valores de data e hora de início da interdição no formato ISO8601, incluindo o deslocamento do fuso horário. Os valores de segundos são opcionais.


<starttime>2016-04-07T09:00:00+01:00</starttime>
endtime Obrigatório yyyy-MM-dd'T'HH:mm:ss+HH:mm

Especifique os valores de data e hora de término no formato ISO8601, incluindo o deslocamento do fuso horário. Os valores de segundos são opcionais.


<endtime>2016-04-07T23:00:00+01:00</endtime>
description Obrigatório Texto livre

Motivo da interdição em até 40 caracteres. Uma descrição maior será aceita, mas não será exibida corretamente no app Waze.


<description>I-95 All NB lanes closed btwn
    Exits 184 and 186.</description>
direction Obrigatório BOTH_DIRECTIONS ou ONE_DIRECTION

Se você informar dois ou mais pontos, a direção precisará incluir estes valores: ONE_DIRECTION ou BOTH_DIRECTIONS.


<direction>BOTH_DIRECTIONS</direction>
reference Obrigatório Texto livre

Identifica a organização de onde as informações vieram. O nome da referência pode ter no máximo 10 letras maiúsculas ou 12 letras minúsculas.


<reference>ORGNAME</reference>
schedule Opcional <dayname>hh:mm-hh:mm</dayname>

Agrupa todas as datas e horas de início e término do incidente.


<schedule>
      <monday>09:00-11:00,17:00-21:00</monday>
      <thursday>09:00-11:00,17:00-21:00</thursday>
      <friday>09:00-11:00,17:00-21:00</friday>
      <saturday>00:00-05:00</saturday>
      <sunday>09:00-18:00</sunday>
    </schedule>
subtype Opcional ROAD_CLOSED_HAZARD ROAD_CLOSED_CONSTRUCTION ROAD_CLOSED_EVENT

Identifica o motivo da interdição da via, que pode ser:

  • Uma via fechada devido a um perigo
  • Uma via fechada devido à uma obra
  • Uma via fechada devido a um evento

<subtype>ROAD_CLOSED_EVENT</subtype>

Exemplos de interdição

Os exemplos a seguir mostram uma única via interditada nos formatos XML e JSON.

Interdição em formato XML

Este é um exemplo de uma única via interditada em XML.

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

Interdição em formato JSON

Este é um exemplo de uma única via interditada em JSON.

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

Os exemplos a seguir mostram um arquivo inteiro de feed de interdições nos formatos XML e JSON.

Arquivo de feed em XML

Este é um exemplo de um arquivo completo de feed de interdições de vias em XML.

    <?xml version="1.0" ?>
    <incidents xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:noNamespaceSchemaLocation="http://www.gstatic.com/road-incidents/incidents_feed.xsd">
      <incidents>
        <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>
          <location>
            <street>N Liberty St</street>
            <direction>BOTH_DIRECTIONS</direction>
            <polyline>42.1601432984533 -119.3525208937842 42.1781676611244
      -119.35679623266</polyline>
          </location>
          <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>
          <location>
            <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>
          </location>
          <starttime>2017-04-18T00:01:00-04:00</starttime>
          <endtime>2017-12-31T23:59:00-05:00</endtime>
        </incident>
    </incidents>

Arquivo de feed em formato JSON

Este é um exemplo de um arquivo completo de feed de interdições de vias em 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",
          "location": {
            "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",
          "location": {
            "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"
        }
      ]
    }