Informações sobre vias interditadas

Use o feed de parceiros do Waze para informar interdições planejadas ou em tempo real de vias, de forma automática e flexível.

As interdições planejadas enviadas ao Waze aparecem no editor de mapa. Elas também são exibidas no app durante o período em que ocorrem.

Informe a interdição apenas quando ela ocorrer em todas as faixas da via. Caso contrário, descreva as faixas afetadas no elemento de impacto na faixa.

Para que as vias interditadas apareçam corretamente no mapa, sigas as diretrizes abaixo e as especificações CIFS.

Se o feed não obedecer às especificações CIFS, mas incluir todos os dados obrigatórios, talvez seja processado pelo Waze. Envie o feed pelo Partner Hub para validação e feedback.

Quando os dados estão incompletos ou são incompatíveis, a interdição não aparece automaticamente no mapa. Ela é enviada à comunidade de editores como "problema no mapa" para análise, aprovação ou rejeição manual.

Compartilhar uma interdição

1. Especifique a tag de interdição

Para mapear a via interditada, especifique ROAD_CLOSED como entrada de tag do elemento type.

2. Estruture a interdição

Para compartilhar com o Waze, especifique uma polyline (obrigatória) e uma direction (solicitada).

  • Polilinhas são sequências de coordenadas que seguem a geometria da via e descrevem o trecho interditado.
  • A ordem das coordenadas informa o sentido afetado do tráfego.
  • direction indica se a interdição vale para um ou ambos os sentidos.

Interdições em vias de mão única:

  • A ordem dos pontos na polilinha tem que corresponder ao sentido do tráfego.
  • Para evitar ambiguidade e superar diferenças de mapeamento, especifique ONE_DIRECTION até mesmo em vias de mão única.

Interdições em vias de mão dupla:

  • Se a interdição afetar apenas um sentido do tráfego, a ordem das coordenadas na polilinha informa qual deve ser interditado.
  • Se afetar os dois, compartilhe a polilinha e, no campo de sentido, indique BOTH_DIRECTIONS.

No caso de uma polilinha indo do ponto A até o B, a interdição vai afetar o sentido do tráfego de acordo com o sentido e o tipo de via, conforme mostrado abaixo:

Uma imagem explicando o comportamento da polilinha e do sentido.

3. Molde a polilinha

  • Quanto mais próxima da geometria da via for a polilinha, melhor o Waze poderá correspondê-la e processar a interdição.
    Forneça vários pontos para cada segmento entre as coordenadas de início e fim. Informar duas coordenadas pode ser suficiente para segmentos curtos ou retos, mas costuma causar falhas de processamento.
    O caso a seguir segue corretamente o formato da via:

    Imagem da polilinha usada em contexto.
    Este caso não reflete bem a geometria da via, já que só fornece as coordenadas de início e fim:

    Imagem da polilinha usada em contexto.

  • O Waze usa a polilinha para aplicar o evento a um ou mais segmentos no mapa. A interdição pode ser maior ou menor que a polilinha, já que o Waze fecha segmentos inteiros segundo a configuração no mapa.
  • Todo o segmento será interditado mesmo que você especifique apenas uma parte dele.
  • É recomendado que os pontos de início e fim de uma interdição estejam a pelo menos 30 metros de distância.
  • O comprimento da polilinha não deve exceder 20 km.

4. Verifique se a interdição obedece a estas diretrizes:

  • Nomes das ruas
    • Apenas uma rua ou via pode ser afetada no mapa do Waze. As coordenadas de início e fim precisam ter o mesmo nome de rua. É provável que uma interdição com diferentes nomes de ruas não seja processada, mesmo com uma polilinha exata.
    • O Waze tenta corresponder a rua fornecida com nomes principais e alternativos no mapa do local informado. Uma correspondência total ou parcial ajuda a identificar a via a ser interditada, especialmente quando há várias possibilidades.
      • Exemplo: I-95S, I-95 sentido sul e JFK Memorial Highway são correspondências da mesma via.
    • Para que os nomes de rua e via que você informa correspondam aos do mapa, use a API Reverse Geocoding ou confira o editor de mapa do Waze.
  • Os feeds de interdições só podem ser criados para estes tipos de vias:
    • Autoestradas
    • Rodovias
    • Ruas municipais
    • Rampas
    • Vias particulares
  • Não é possível informar interdições em vias para pedestres.
  • Horário de início:
    • ​É necessário informar quando a interdição começa.
    • Caso não saiba, use um carimbo de data/hora do alerta inicial.
    • Modificações no horário de início:
      • Interdições em andamento: não é possível alterar o horário de início de uma interdição depois que ele já passou, ou seja, quando a interdição está acontecendo.
      • Interdições futuras: se a interdição ainda não começou, você pode modificar o horário de início se necessário, mas não altere o event_id para manter a consistência.
  • Horário de término:
    • Se não souber, deixe em branco. Interdições sem essa informação recebem uma duração padrão (atualmente, duas semanas) e vão expirar se não forem estendidas com um novo horário de término. É possível modificar o horário de término depois de publicar o evento, mas evite defini-lo de forma dinâmica com base no horário atual.

Para mais detalhes sobre as tags da Especificação do feed de interdições e incidentes (CIFS, na sigla em inglês), confira Especificação CIFS.

Exemplos de interdição

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

Interdição em formato XML

Confira a seguir um exemplo de feed que contém uma única via interditada no formato 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>

Interdição em formato JSON

Confira a seguir um exemplo de feed que contém uma única via interditada no formato 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"
      }
    }
  ]
}

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 arquivo completo de feed de vias interditadas em 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>

Arquivo de feed em formato JSON

Este é um exemplo de um arquivo completo de feed de vias interditadas em 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"
    }
  ]
}