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 o trecho seja adequado para coleta de dados e atualizações nos insights do Gerenciamento de estradas. O processo normalmente é concluído em poucos minutos.

É possível monitorar o status de validação das suas rotas no campo state da 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 operacional e de validação atual. 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 na validação e agora está ativa. A API coleta dados ativamente e envia 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 não passou na validação 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. Este 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 para esta rota não está definido.
  • VALIDATION_ERROR_ROUTE_OUTSIDE_JURISDICTION: a rota está fora da jurisdição autorizada do seu projeto.
  • VALIDATION_ERROR_LOW_ROAD_USAGE: o uso da via é baixo, 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 de 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 avaliações contínuas.

Confira o que esperar em rotas com pouco uso da via:

  • 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 desse trajeto no BigQuery.
  • Interrupção das atualizações do Pub/Sub: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 vai emitir um aviso no recurso SelectedRoute.
    • Se o tráfego baixo persistir por quatro trimestres consecutivos, o state da rota mudará para STATE_INVALID, e as atualizações do Pub/Sub serão interrompidas.
  • É possível revalidar:mesmo que uma rota seja STATE_INVALID, ela continua sujeita a avaliações de trânsito 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 do 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.

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 a rota atual e crie outra, 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 outra, selecionando uma área com maior uso de vias ou "movimento" para coleta de dados. Se a sua 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 da via.