Informações sobre vias interditadas

Você pode oferecer informações de interdições em tempo real e programadas ao Waze. As programadas aparecem no Editor de mapa do Waze e exibe o horário de início e término apenas enquanto a interdição está acontecendo.

A informações sobre bloqueios com informações faltantes ou incorretas, como horário de início e término, nome das ruas ou rotas são adicionadas como alertas de interdição no mapa.

Esses casos 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, as informações 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 sejam os mesmos do mapa, use a API Geocoding Reverse, já que as inserções 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 segmento.

    O caso abaixo foi criado corretamente:

    O exemplo a seguir não está correto, porque usa parte de um segmento 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 precisa 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 mais de um nome, mesmo que uma polilinha seja aplicada.
  • Os feeds de interdições podem ser criados somente 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

Um 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 que a precisão seja suficiente.


<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" lista 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. É possível adicionar um valor para os segundos, mas não é necessário.


<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. É possível adicionar um valor para os segundos, mas não é necessário.


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

O motivo da interdição em até 40 caracteres. Uma descrição maior será aceita, mas não será exibida corretamente no aplicativo 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 podem 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 formato 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"
    }
  ]
}