Entender a validação de rotas

Depois de criar um trajeto, 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 geralmente é concluído em alguns minutos.

É possível monitorar o status de validação dos trajetos pelo state campo na resposta da API. Para isso, use o endpoint get, conforme descrito em Receber trajetos selecionados, ou examine a tabelaroutes_status no BigQuery.

Estados do trajeto

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 desse trajeto não está definido.
  • STATE_VALIDATING: o trajeto está sendo validado.
  • STATE_RUNNING: o trajeto foi validado e agora está ativo. A API está coletando dados ativamente e enviando atualizações periódicas desse trajeto para o BigQuery, o Pub/Sub ou ambos.
  • STATE_DELETING: o trajeto foi marcado para exclusão e está sendo removido do sistema.
  • STATE_INVALID: o trajeto falhou na validação com base em critérios específicos. Quando um trajeto 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 desse trajeto não está definido.
  • VALIDATION_ERROR_ROUTE_OUTSIDE_JURISDICTION: o trajeto está fora da jurisdição autorizada do projeto.
  • VALIDATION_ERROR_LOW_ROAD_USAGE: a rota tem baixo uso da via, o que significa que informações de trânsito insuficientes podem ser coletadas para uma análise significativa. Um trajeto classificado como inválido devido ao baixo uso da via poderá se tornar válido novamente se o volume de tráfego aumentar acima de um limite predeterminado. Saiba mais em Trajeto de baixo uso da via.

Trajeto de baixo uso da via

Os trajetos podem ser sinalizados 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 trajetos com baixo 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 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 do trajeto mudar para STATE_INVALID.
  • Avaliações trimestrais:a API realiza avaliações trimestrais de todos os trajetos ativos 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, a state mudará para STATE_INVALID e as atualizações do Pub/Sub serão interrompidas.
  • A revalidação é possível:mesmo que um trajeto seja STATE_INVALID, ele ainda está sujeito a avaliações de tráfego contínuas. As avaliações subsequentes poderão reclassificar o trajeto como válido (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 um trajeto pelo endpoint get, conforme descrito em Receber trajetos selecionados, ou examinando a tabela routes_status no BigQuery.

Como solucionar problemas de trajetos inválidos

Se o state do trajeto 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 o trajeto definido se estende além da área geográfica autorizada para o projeto. Para corrigir isso, exclua o trajeto atual e crie-o novamente, 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 o trajeto selecionado não tem dados de uso da via suficientes para análises e atualizações significativas. Para corrigir isso, exclua o trajeto atual e crie-o novamente, selecionando uma área com maior uso da via ou "movimento" para coleta de dados. Se o trajeto tiver esse erro, o status dele poderá mudar de volta para STATE_RUNNING se o tráfego aumentar com o tempo, conforme descrito em Trajeto de baixo uso da via.