Dados acumulados de vias

Os dados acumulados de vias se referem aos dados que você pode criar ao longo do tempo para as rotas selecionadas. Você começa a receber dados assim que 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 acumulados de vias são fornecidos como dados de série temporal, que incluem duração da viagem, intervalos de leitura de velocidade (SRIs) e geometria da rota para cada uma delas. Esses dados são armazenados e acessados pelo BigQuery.

Configurar o BigQuery

Antes de acessar seus dados de vias no BigQuery, configure seu projeto do Google Cloud e assine a troca de dados.

Pré-requisitos

Verifique se o projeto 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 a API Analytics Hub.
  3. Conceda os papéis necessários do IAM. Verifique se sua conta tem os seguintes papéis para realizar tarefas de assinante e criar conjuntos de dados:

Inscrever-se na sua troca de dados

Seus dados de vias são compartilhados com você por uma troca de dados particular no BigQuery (Analytics Hub). Você vai receber um link de inscrição específico de um parceiro do Google para acessar seus dados. Este 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 seu 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 é possível usar os nomes das tabelas mostrados no painel "Explorador" 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 de nuvem do Google. Ele é compartilhado com você por uma troca de dados particular criada exclusivamente para você no BigQuery Sharing (Analytics Hub). Para acessar os dados, assine a troca de dados e crie um conjunto de dados vinculado no seu projeto do Google Cloud.

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

historical_travel_time tabela

Confira o esquema da tabela historical_travel_time do BigQuery:

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

Comportamentos e fatos da tabela

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

recent_roads_data tabela

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

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

Nome Modo Tipo Descrição
selected_route_id NULLABLE STRING selected_route_id do trajeto
display_name NULLABLE STRING Nome de exibição da rota
record_time NULLABLE TIMESTAMP O carimbo de data/hora em que os dados de rota são calculados
duration_in_seconds NULLABLE FLOAT A duração do trajeto considerando o trânsito
static_duration_in_seconds NULLABLE FLOAT A duração do trajeto sem considerar o trânsito
route_geometry NULLABLE GEOGRAPHY A geometria de polilinha da rota com reconhecimento de tráfego.
speed_reading_intervals REPEATED RECORD Intervalos que representam a densidade do tráfego ao longo do trajeto. 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 este intervalo. Valores possíveis: NORMAL, SLOW, TRAFFIC_JAM

Comportamentos e fatos da tabela

  • A tabela é particionada por dia e tem uma validade de 60 dias definida para cada partição.
  • A tabela é atualizada a cada hora com os dados de trânsito mais recentes gravados em lote.
  • Depois que uma nova rota é criada na API Roads Selection, aguarde até uma hora para que os dados fiquem disponíveis nessa tabela.
  • Depois que 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.

routes_status tabela

A tabela contém os metadados e as informações de status das rotas selecionadas. O objetivo é facilitar a visualização de todas as rotas e status. Ela pode ser mesclada com as outras duas para filtrar dados. Confira o esquema no BigQuery:

Nome Modo Tipo Descrição
selected_route_id NULLABLE STRING selected_route_id do trajeto
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 apresentou baixo uso da via pela primeira vez durante a revalidação. Ele está associado a VALIDATION_ERROR_LOW_ROAD_USAGE.
route_attributes NULLABLE STRING Atributos personalizados da rota selecionada

Comportamentos e fatos da tabela

  • Somente as rotas no status STATE_RUNNING ou STATE_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é uma hora para que ela apareça nessa tabela.
  • Depois que uma rota é excluída da API Roads Selection, aguarde até uma hora para que ela seja removida da tabela.