Configuração do feed

As informações a seguir ajudarão a configurar e exibir seus feeds corretamente.

Hospedagem de arquivos do feed

O sistema de aquisição de conteúdo do Waze captura automaticamente todos os arquivos novos ou modificados em um determinado diretório ou conjunto de diretórios. Para garantir que o Waze recupere os arquivos corretos do feed, siga as diretrizes abaixo ao disponibilizá-lo no servidor HTTP:

  • Crie o feed em um diretório de onde o Waze não captura conteúdo.
  • Quando o feed estiver concluído, crie um link simbólico em um diretório onde o Waze possa buscar conteúdo. O link precisa apontar para o feed recém-criado. Geralmente isso é feito com um comando $ ln -s source_file my_file. Você pode proteger seus arquivos com um nome de usuário e senha usando a autenticação BASIC ou DIGEST. No momento, não há suporte para o Gerenciador de LAN NT do Windows (NTLM, na sigla em inglês).
  • Transferimos os arquivos de feed usando HTTPS com um certificado SSL para garantir a transferência segura dos dados.
  • Informe a combinação de login e senha pelo portal do CCP.
  • O sistema de aquisição de conteúdo busca dados a cada cinco minutos. Se o feed for atualizado com uma frequência muito maior ou menor do que a cada cinco minutos, entre em contato com a equipe do Waze para ajustar os períodos de pesquisa e refletir o ciclo de atualização do seu feed.

Validação do XML

O Waze usa o seguinte esquema XML para definir a estrutura aceitável de um feed de especificações de incidentes e interdições: https://www.gstatic.com/road-incidents/incidents_feed.xsd.

Existem várias ferramentas disponíveis na Internet para ajudar a validar a estrutura dos feeds em XML. Estes são apenas alguns exemplos:

Alterações críticas no feed

Antes de fazer qualquer uma das mudanças abaixo, notifique a equipe do Waze preenchendo este formulário e editando sua solicitação no portal para identificar o feed atualizado.

  • Modificar, adicionar ou remover regiões ou países do feed
  • Atualizar o URL do feed ou qualquer credencial necessária para acessar as informações

Especificações de feed

Um único arquivo de feed pode fornecer informações sobre vários incidentes e interdições. Se você estiver informando mais de um evento, cada interdição ou incidente precisa ser detalhado em uma seção separada semelhante ao exemplo de interdição de via, e cada instância de interdição precisa de um código exclusivo. As seções precisam usar a hora e a data locais. As tabelas de parâmetros de cada tipo de feed classificam os elementos da seguinte maneira:

  • Obrigatório: o elemento precisa estar presente e preenchido para que o feed seja considerado válido.
  • Opcional: o elemento não precisa estar presente e preenchido para que o feed seja considerado válido.