Esta página foi traduzida pela API Cloud Translation.

Informações sobre vias interditadas

Você pode usar o feed de parceiros do Waze para informar sobre vias interditadas planejadas e em tempo real de forma automática e em grande escala.

As interdições planejadas que você envia ao Waze aparecem no editor de mapa e no aplicativo do Waze durante o horário exato da interdição.

Forneça vias interditadas somente caso todas as faixas da via estejam fechadas. Se a interdição afetar apenas algumas faixas, descreva-as no elemento de impacto da faixa.

Para que as vias interditadas apareçam no mapa com precisão, siga as diretrizes abaixo e as especificações de CIFS.

Se o feed não estiver em conformidade com as especificações da CIFS, mas incluir todos os dados necessários, o Waze ainda poderá processá-lo. Envie seu feed pelo Hub de parceiros para validação e feedback.

No caso de dados incompletos ou incompatíveis, as interdições não vão aparecer automaticamente no mapa, mas vão ser enviadas à nossa comunidade de editores como um "problema no mapa" para revisão, aprovação ou rejeição manual.

Compartilhando uma interdição

1. Especificar tag de interdição

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

2. Estruture a interdição

Para compartilhar uma interdição com o Waze, especifique um polyline (obrigatório) e um direction (solicitado).

As polilinhas são sequências de coordenadas que seguem a geometria da via e descrevem o trecho da via que deve ser fechado.
A ordem das coordenadas na polilinha nos informa qual direção do trânsito é afetada.
direction indica se a interdição se aplica a uma ou às duas direções de trânsito.

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

A ordem dos pontos na polilinha precisa corresponder à direção do trânsito.
Para evitar ambiguidade e diferenças de mapeamento, é recomendável especificar ONE_DIRECTION mesmo em vias de mão única.

Para interdições em vias de mão dupla:

Se a interdição afetar apenas uma direção: a ordem das coordenadas na polilinha nos informa em qual direção do trânsito fechar.
Se a interdição afetar as duas direções: compartilhe a polilinha e, no campo de direção, indique BOTH_DIRECTIONS.

Para uma polilinha que se estende do ponto A ao ponto B, a interdição vai afetar a direção do trânsito com base na direção e no tipo de via, conforme mostrado abaixo:

Uma imagem explicando o comportamento das polilinhas e da direção.

3. Moldar a polilinha

Quanto mais próxima ela se parecer com a geometria da via, maior é a probabilidade de o Waze fazer a correspondência correta e processar a interdição.
É altamente recomendável fornecer vários pontos para cada segmento entre as coordenadas inicial e final. Fornecer apenas duas coordenadas pode ser suficiente para segmentos curtos ou retos, mas normalmente é a causa de falhas de processamento.
O caso a seguir segue corretamente o formato da via:

A polilinha a seguir não reflete claramente a geometria da via, já que fornece apenas as coordenadas de início e fim:
O Waze usa a polilinha fornecida para aplicar o evento a um ou mais segmentos no mapa do Waze. A interdição aplicada pode ser mais longa ou um pouco menor do que a polilinha, já que o Waze só pode fechar segmentos inteiros, conforme configurado no mapa do Waze.
Se você especificar apenas uma parte do trecho para interdição, todo o trecho será fechado.
Recomendamos que os pontos de início e término de uma interdição estejam a pelo menos 30 metros de distância.
O comprimento de uma interdição não deve exceder 20 km.

4. Verifique se a interdição está de acordo com estas diretrizes:

Nomes das ruas
- As interdições afetam apenas uma rua ou via no mapa do Waze. As coordenadas de início e término precisam ter o mesmo nome de rua. Uma interdição informada que abrange diferentes nomes de rua provavelmente não será processada, mesmo que uma polilinha exata seja fornecida.
- O Waze vai tentar fazer a correspondência entre o nome da rua informado e os nomes principais ou alternativos no mapa do Waze no local informado. Uma correspondência completa ou parcial nos ajuda a identificar corretamente qual estrada fechar, especialmente quando há vários candidatos.
  - Exemplo: I-95S, I-95 Southbound e JFK Memorial Highway seriam todos combinados com a mesma estrada.
- Para garantir que os nomes da rua e da estrada fornecidos na sua página de detalhes correspondam aos do mapa do Waze, use a API Reverse Geocoding ou verifique o editor de mapa do Waze.
Os feeds de interdições podem ser criados somente para os seguintes tipos de via do Waze:
- Autoestradas
- Rodovias
- Ruas municipais
- Rampas
- Vias particulares
Os tipos de via do Waze que não podem ser interditadas usando um feed incluem os seguintes:
- Vias de estacionamento
- Estradas off-road (4x4) e para pedestres

Horários de início e término:

Horário de início: você precisa informar o horário de início de uma interdição. Se você não tiver certeza do horário de início, use o carimbo de data/hora do relatório inicial, mas NÃO modifique esse horário após publicar o evento.
Horário de término: se você não souber o horário de término, deixe em branco. As interdições que não tiverem um horário de término terão uma duração padrão (no momento, duas semanas) e expirarão, a menos que sejam explicitamente prolongadas especificando um novo horário. Você pode modificar o horário de término após a publicação do evento, mas evite configurar horários de término dinamicamente com base no horário atual.

Para especificações mais detalhadas das 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.

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

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

Arquivo de feed em formato JSON

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