Dados acumulados de vias

Os dados de vias acumulados se referem aos dados que você pode criar ao longo do tempo para as rotas selecionadas. Você começa a receber dados quando cria uma rota com a API Roads Selection. Esses dados podem ser usados para análises detalhadas, planejamento estratégico e compreensão do comportamento de longo prazo das rotas.

Os dados de vias acumulados são fornecidos como dados de séries temporais, que incluem:

  • Duração da viagem
  • Intervalos de leitura de velocidade (SRIs, na sigla em inglês)
  • Geometria do trajeto

Configurar o BigQuery

Antes de acessar os dados de vias no BigQuery, configure o projeto na nuvem do Google Cloud e inscreva-se na troca de dados.

Pré-requisitos

Verifique se o projeto na nuvem e a conta do Google Cloud têm as seguintes configurações:

  1. Ative a API BigQuery. Para instruções, consulte Consultar um conjunto de dados público com o console do Google Cloud.
  2. Ative a API Analytics Hub. Consulte Analytics Hub API.
  3. Conceda os papéis do IAM necessários. Verifique se a sua conta tem os seguintes papéis para realizar tarefas de assinante e criar conjuntos de dados:
  4. Assinante do Analytics Hub (roles/analyticshub.subscriber)

Inscrever-se na troca de dados

Os dados de vias são compartilhados com você por meio de uma troca de dados privada no BigQuery (Analytics Hub). Você vai receber um link de inscrição específico de um parceiro do Google para acessar seus dados. Esse conjunto de dados segue a seguinte convenção de nomenclatura:

historical_roads_data_PROJECT_NUMBER.

Para se inscrever nos seus dados:

  1. Clique no link de inscrição fornecido pelo parceiro do Google. Esse link vai levar você diretamente à troca de dados no console do Google Cloud.
  2. No console do Google Cloud, revise os detalhes da troca de dados.
  3. Clique no botão Inscrever-se na caixa de diálogo.
  4. Quando a inscrição for concluída, o conjunto de dados vinculado vai aparecer no painel Explorer do BigQuery no console do Google Cloud. Agora você pode usar os nomes das tabelas mostrados no painel Explorer para acessar os dados nas consultas SQL.

Tabelas do BigQuery

Os dados de vias acumulados das rotas selecionadas são hospedados em um conjunto de dados isolado do BigQuery de um projeto na nuvem de propriedade do Google. Eles são compartilhados com você por meio de uma troca de dados privada criada exclusivamente para você no BigQuery Sharing (Analytics Hub). Para acessar os dados, inscreva-se na troca de dados e crie um conjunto de dados vinculado no projeto do Google Cloud.

O conjunto de dados compartilhado do BigQuery inclui algumas tabelas do BigQuery definidas e criadas pelo Google. Confira os detalhes de cada tabela.

Tabela historical_travel_time

A seguir, confira o esquema da tabela historical_travel_time do BigQuery:

Nome Modo Tipo Descrição
selected_route_id NULLABLE STRING selected_route_id da rota
display_name NULLABLE STRING Nome de exibição da rota
record_time NULLABLE TIMESTAMP O carimbo de data/hora em que os dados da rota são calculados
duration_in_seconds NULLABLE FLOAT A duração da rota com reconhecimento de trânsito
static_duration_in_seconds NULLABLE FLOAT A duração da rota sem reconhecimento de trânsito
route_geometry NULLABLE GEOGRAPHY A geometria de polilinha da rota com reconhecimento de trânsito

Comportamentos e fatos da tabela

  • A tabela é particionada por dia e tem uma expiração de 10 anos definida para cada partição.
  • A tabela é atualizada a cada hora com as informações de trânsito mais recentes gravadas em lote.
  • Depois que uma nova rota é criada na API Roads Selection, aguarde até 1 hora para que os dados fiquem disponíveis nessa tabela.
  • Quando uma rota é excluída da API Roads Selection, nenhum novo dado é gravado nessa tabela para a rota. No entanto, os dados históricos permanecem até a expiração.

Tabela recent_roads_data

Observação: essa tabela só está disponível quando o contrato inclui dados de vias em tempo real.

Diferente de historical_travel_time, essa tabela também contém dados SpeedReadingInterval. Confira o esquema no BigQuery:

Nome Modo Tipo Descrição
selected_route_id NULLABLE STRING selected_route_id da rota
display_name NULLABLE STRING Nome de exibição da rota
record_time NULLABLE TIMESTAMP O carimbo de data/hora em que os dados da rota são calculados
duration_in_seconds NULLABLE FLOAT A duração da rota com reconhecimento de trânsito
static_duration_in_seconds NULLABLE FLOAT A duração da rota sem reconhecimento de trânsito
route_geometry NULLABLE GEOGRAPHY A geometria de polilinha da rota com reconhecimento de trânsito
speed_reading_intervals REPEATED RECORD Intervalos que representam a densidade do tráfego na rota. Consulte a definição original na API Routes
speed_reading_intervals.interval_coordinates REPEATED GEOGRAPHY A geometria desse intervalo
speed_reading_intervals.speed NULLABLE STRING A classificação da velocidade para esse intervalo. Valores possíveis: NORMAL, SLOW, TRAFFIC_JAM

Comportamentos e fatos da tabela

  • A tabela é particionada por dia e tem uma expiração de 60 dias definida para cada partição.
  • A tabela é atualizada a cada hora com as informações de trânsito mais recentes gravadas em lote.
  • Depois que uma nova rota é criada na API Roads Selection, aguarde até 1 hora para que os dados fiquem disponíveis nessa tabela.
  • Quando uma rota é excluída da API Roads Selection, nenhum novo dado é gravado nessa tabela para a rota. No entanto, os dados históricos permanecem até a expiração.

Tabela routes_status

A tabela contém os metadados e as informações de status das rotas selecionadas. Ela tem como objetivo fornecer uma maneira mais fácil de visualizar todas as rotas e o status. Ela pode ser unida às outras duas tabelas para filtragem de dados. Confira o esquema no BigQuery:

Nome Modo Tipo Descrição
selected_route_id NULLABLE STRING selected_route_id da rota
display_name NULLABLE STRING Nome de exibição da rota
status* NULLABLE STRING Status da rota
validation_error NULLABLE STRING Erro de validação da rota
low_road_usage_start_time NULLABLE TIMESTAMP O horário em que a rota observou pela primeira vez o baixo uso da via durante revalidação. Ele está associado a VALIDATION_ERROR_LOW_ROAD_USAGE.
route_attributes NULLABLE STRING Atributos personalizados para a rota selecionada

*O status da rota nessa tabela começa com STATUS_ em vez de STATE_. Caso contrário, ele é consistente com a API Roads Selection.

Comportamentos e fatos da tabela

  • Somente as rotas no status STATUS_RUNNING ou STATUS_INVALID são incluídas nessa tabela.
  • Os metadados e o status das rotas são atualizados a cada hora, sem parar.
  • Depois que uma nova rota é criada na API Roads Selection, aguarde até 1 hora para que a rota fique disponível nessa tabela.
  • Quando uma rota é excluída da API Roads Selection, aguarde até 1 hora para que a rota selecionada seja removida dessa tabela.