Entender a validação de rotas

Depois que você cria um trajeto, a API Roads Selection realiza um processo de validação. Essa validação garante que a rota seja adequada para a coleta de dados e atualizações no Dados do Gerenciamento de Estradas. O processo geralmente é concluído em alguns minutos.

É possível monitorar o status de validação das rotas pelo campo state na resposta da API. Para verificar isso, use o endpoint get, conforme descrito em Receber rotas selecionadas, ou examine a tabela routes_status no BigQuery.

Estados de rota

O campo state em um recurso SelectedRoute indica o status atual de validação e operação. O campo state pode ter os seguintes valores:

  • STATE_UNSPECIFIED: o estado de validação desta rota não está definido.
  • STATE_VALIDATING: a rota está sendo validada.
  • STATE_RUNNING: a rota passou pela validação e agora está ativa. A API está coletando dados ativamente e enviando atualizações periódicas para essa rota para o BigQuery, o Pub/Sub ou ambos.
  • STATE_DELETING: a rota foi marcada para exclusão e está sendo removida do sistema.
  • STATE_INVALID: a rota não foi validada com base em critérios específicos. Quando uma rota está em STATE_INVALID, a resposta inclui um campo validationError com detalhes sobre o motivo da falha na validação.

Erros de validação

Quando o state de um recurso SelectedRoute é STATE_INVALID, a resposta da API inclui um campo validationError. Esse campo fornece um motivo específico para a falha de validação.

O campo validationError pode ter os seguintes valores:

  • VALIDATION_ERROR_UNSPECIFIED: o erro de validação para essa rota não está definido.
  • VALIDATION_ERROR_ROUTE_OUTSIDE_JURISDICTION: o trajeto está fora da jurisdição autorizada do seu projeto.
  • VALIDATION_ERROR_LOW_ROAD_USAGE: o trajeto tem baixo uso da via, o que significa que não é possível coletar dados de trânsito suficientes para uma análise significativa. Uma rota classificada como inválida devido ao baixo uso da via pode se tornar válida novamente se o volume de tráfego aumentar acima de um limite predeterminado. Saiba mais em Rota de baixo uso de vias.

Rota com baixo uso da via

As rotas podem ser sinalizadas com VALIDATION_ERROR_LOW_ROAD_USAGE se a API determinar que não há dados de tráfego suficientes para uma análise consistente. Isso pode acontecer durante a validação inicial ou durante as avaliações contínuas.

Veja o que esperar de trajetos com pouco uso:

  • A publicação de dados no BigQuery continua: mesmo que um trajeto seja classificado como STATE_INVALID devido ao baixo uso da via, a API continua processando e publicando todos os dados disponíveis para esse trajeto no BigQuery.
  • As atualizações do Pub/Sub são interrompidas: as atualizações periódicas em tempo real do Pub/Sub são interrompidas se o state da rota mudar para STATE_INVALID.
  • Avaliações trimestrais: a API realiza avaliações trimestrais de todas as rotas ativas para o volume de tráfego.
    • Se um tráfego baixo for detectado durante uma avaliação, a API emitirá um aviso no recurso SelectedRoute.
    • Se o tráfego baixo persistir por quatro trimestres consecutivos, o state da rota será alterado para STATE_INVALID, e as atualizações do Pub/Sub serão interrompidas.
  • A revalidação é possível: mesmo que uma rota seja STATE_INVALID, ela permanece sujeita a avaliações de tráfego contínuas. As avaliações subsequentes podem reclassificar a rota como válida (STATE_RUNNING) se o volume de tráfego aumentar acima de um limite predeterminado.
  • Status de monitoramento: é possível monitorar o status de validação de uma rota pelo endpoint get, conforme descrito em Receber rotas selecionadas, ou examinando a tabela routes_status no BigQuery.

Como resolver problemas de rotas inválidas

Se a rota state for STATE_INVALID, siga as próximas diretrizes de solução de problemas com base no validationError que você receber:

  • VALIDATION_ERROR_ROUTE_OUTSIDE_JURISDICTION: esse erro indica que a rota definida se estende além da área geográfica autorizada para seu projeto. Para corrigir isso, exclua o trajeto atual e crie um novo, garantindo que todos os pontos (origem, destino e intermediários) estejam dentro da jurisdição do projeto autorizado.

  • VALIDATION_ERROR_LOW_ROAD_USAGE: esse erro significa que a rota selecionada não tem dados suficientes de uso da via para análises e atualizações significativas. Para corrigir isso, exclua a rota atual e crie uma nova, selecionando uma área com maior uso de estradas ou "movimentação" para a coleta de dados. Se a rota tiver esse erro, o status dela poderá voltar para STATE_RUNNING se o tráfego aumentar ao longo do tempo, conforme descrito em Rota de uso de estrada baixa.