Entender a validação de rotas

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

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

Estados da rota

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

  • STATE_UNSPECIFIED: o estado de validação dessa rota não está definido.
  • STATE_VALIDATING: a rota está sendo validada.
  • STATE_RUNNING: a rota foi aprovada na validação e agora está ativa. A API está coletando dados ativamente e enviando atualizações periódicas dessa 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 falhou na validação com base em critérios específicos. Quando uma rota está em STATE_INVALID, a resposta inclui um validationError campo 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 na validação.

O campo validationError pode ter os seguintes valores:

  • VALIDATION_ERROR_UNSPECIFIED: o erro de validação dessa rota não está definido.
  • VALIDATION_ERROR_ROUTE_OUTSIDE_JURISDICTION: a rota está fora da jurisdição autorizada do projeto.
  • VALIDATION_ERROR_LOW_ROAD_USAGE: a rota tem baixo uso de estradas, o que significa que informações de trânsito insuficientes podem ser coletadas para uma análise significativa. Uma rota classificada como inválida devido ao baixo uso de estradas poderá 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 estradas.

Rota de baixo uso de estradas

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

Confira o que esperar de rotas com baixo uso de estradas:

  • A publicação de dados no BigQuery continua:mesmo que uma rota seja classificada como STATE_INVALID devido ao baixo uso de estradas, a API continua processando e publicando todos os dados disponíveis para essa rota no BigQuery.
  • As atualizações do Pub/Sub são interrompidas:as atualizações periódicas em tempo real do Pub/Sub cessam 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 for detectado tráfego baixo durante uma avaliação, a API emitirá um aviso no SelectedRoute recurso.
    • Se o tráfego baixo persistir por quatro trimestres consecutivos, o state mudará 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 ainda está 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 solucionar problemas de rotas inválidas

Se o state da rota for STATE_INVALID, siga as próximas diretrizes de solução de problemas com base no validationError recebido:

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

  • VALIDATION_ERROR_LOW_ROAD_USAGE: esse erro significa que a rota selecionada não tem dados de uso de estradas suficientes para análises e atualizações significativas. Para corrigir isso, exclua a rota atual e crie-a novamente, selecionando uma área com maior uso de estradas ou "movimento" para coleta de dados. Se a rota tiver esse erro, o status dela poderá mudar de volta para STATE_RUNNING se o tráfego aumentar com o tempo, conforme descrito em Rota de baixo uso de estradas.