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 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:
- http://www.w3.org/XML/Schema#Tools
- http://www.xml.com/pub/a/2000/12/13/schematools.html
- http://xmlsoft.org/xmllint.html
Alterações críticas no feed
Antes de fazer qualquer uma das alterações 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.