Monitorar o status e a integridade do feed

No Partner Hub do Waze, você pode monitorar a integridade dos seus feeds e garantir que o Waze receba e processe seus relatórios corretamente.

Você pode conferir o número total de eventos processados com sucesso, uma lista de eventos com falha e as mensagens de erro correspondentes, além de entender como extraímos suas informações de eventos, como ID, tipo, descrição e rua.

Como acessar o status e a integridade do feed

  • Faça login no Hub de parceiros.
  • Acesse a página Caixa de ferramentas → Feed de parceiro.
  • Na lista de feeds, selecione o que você quer acessar.

Observação:essa visualização só fica disponível no feed quando o status é Ao vivo, Ação necessária ou Pausado. Ela não está disponível para feeds com erros de rede ou conteúdo JSON ou XML inválido.

Como entender o status do feed

O status do feed será um dos seguintes:

  • Ao vivo:o feed está ativo, e o Waze está processando seus eventos válidos.
  • Solicitação pendente:um novo feed que está sendo configurado, definido ou avaliado pelas nossas equipes. Nossas equipes vão ativar o feed ou entrar em contato por e-mail com feedback e modificações necessárias.
  • Ação necessária:confira sua caixa de entrada para ver um e-mail da nossa equipe com feedback sobre seu feed e as modificações necessárias para que ele seja publicado.
  • Pausado:o feed está inativo, e o Waze não está mais processando seus eventos.
  • Não aprovado:o feed não atendeu aos nossos requisitos e foi rejeitado.

Entender a integridade do feed

Clique no feed relevante para acessar o status de integridade.

Na parte de cima, você encontra uma visão geral do número total de eventos no feed, além do número de erros, eventos válidos e eventos ignorados.

  • Eventos válidos:eventos que nosso sistema consegue processar.
  • Erros:são os eventos que nosso sistema não conseguiu analisar ou inserir.
  • Eventos pulados:são eventos que nossa equipe decidiu pular do seu feed. Esses eventos não serão injetados no mapa do Waze.
    • Entre em contato com nossa equipe para entender por que determinados eventos são ignorados. Clique no ponto de interrogação no canto superior direito → Entre em contato.

Clique na guia Erros para rolar pelos eventos que exigem sua atenção e correções.
Um erro será exibido para cada evento nessa guia.

Entender os erros de feed

Todos os eventos que não foram processados, além das mensagens de erro e motivos relevantes, são listados nesta página.

Confira algumas mensagens de erro comuns que você pode encontrar:

  • Não foi possível encontrar uma rota que corresponda à polilinha fornecida. Isso pode ocorrer devido a uma incompatibilidade de rua ou direção ou porque a polilinha fornecida não é precisa o suficiente.
    • Exemplo: a polilinha dos eventos abaixo muda de direção ou abrange várias ruas.
      imagem da polilinha usada em contexto
      imagem da polilinha usada em contexto
    • Para resolver esse problema, verifique se a polilinha de cada evento segue estas diretrizes: ela só pode cobrir segmentos da mesma rua e precisa ser o mais parecida possível com a geometria da via.
    • Saiba como estruturar e moldar sua polilinha aqui.
  • Não é possível determinar a direção do trânsito porque o evento tem um único ponto {lat}, {lon} e o segmento correspondente permite o tráfego nas duas direções.
    • Exemplo: a via abaixo (US-64) permite o tráfego nos dois sentidos, mas a polilinha fornecida tem um único ponto, e nosso sistema não consegue identificar qual sentido do tráfego é afetado.
      imagem da polilinha usada em contexto
    • Saiba como compartilhar corretamente polyline e direction para eventos em vias de mão dupla aqui.
  • Não foi possível encontrar um segmento para este evento perto do ponto lat, lon que esteja a 50 metros.
    • O sistema não conseguiu identificar segmentos perto dos pontos da polilinha.
    • Exemplo:
      imagem de polilinha de ponto usada em contexto
  • A polilinha fornecida começa e termina com as mesmas coordenadas lat, lon
    • Esse erro é retornado quando o evento é compartilhado com uma polilinha circular, que nosso sistema não aceita. Isso acontece quando os pontos de início e fim do evento são idênticos (para polilinhas que usam pelo menos três pontos), impedindo que nosso sistema determine o trecho da via afetado.
    • Exemplo: a polilinha do evento abaixo é circular, o que a torna inválida. Para resolver isso, crie eventos separados com polilinhas diferentes para cada trecho de via ou direção.
      imagem da polilinha usada em contexto
  • INCIDENT_{field} é inválido.
    • Esse erro indica que um campo obrigatório está ausente ou formatado incorretamente.
    • Exemplos:
      • INCIDENT_STREET é inválido
      • INCIDENT_TYPE é inválido
      • INCIDENT_POLYLINE é inválido
    • Consulte a página Especificação CIFS para ver uma lista completa dos campos "Obrigatório". Se o evento que você está analisando tiver esse erro, mesmo com entrada, entre em contato com nossa equipe de suporte para receber mais ajuda.