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 um trajeto com a API Roads Selection. Esses dados podem ser usados para análise detalhada, 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:

Configurar o BigQuery

Antes de acessar seus dados de vias no BigQuery, configure seu projeto na nuvem do Google Cloud e assine a 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 a API do Analytics Hub.
  3. Conceda os papéis necessários do IAM. Verifique se a sua conta tem as seguintes funções para realizar tarefas de assinante e criar conjuntos de dados:
  4. Assinante do Analytics Hub (roles/analyticshub.subscriber)

Inscrever-se na sua troca de dados

Seus dados de trânsito 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 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 Assinar na caixa de diálogo.
  4. Quando a assinatura é concluída, o conjunto de dados vinculado aparece no painel Explorador do BigQuery no console do Google Cloud. Agora você pode 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 na 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 abaixo 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 da polilinha da rota com reconhecimento de tráfego.
road_segment_ids REPEATED STRING Os trechos da via ao longo do trajeto, representados como IDs de lugar

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 as informações de trânsito mais recentes gravadas 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é o vencimento.
  • Os trechos de via ao longo do trajeto seguem a ordem topológica e estão sempre conectados.

recent_roads_data tabela

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

Diferente de historical_travel_time, essa tabela também contém intervalos de leitura rápida baseados em deslocamento (speed_reading_offsets) e intervalos de leitura rápida legados baseados em coordenadas (speed_reading_intervals). Este é 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 da polilinha da rota com reconhecimento de tráfego.
speed_reading_intervals REPEATED RECORD Intervalos legados de leitura dinâmica com base em coordenadas. Pode deixar de ser preenchido em 9 de novembro de 2026 ou depois. Use speed_reading_offsets. Consulte Intervalos de leitura dinâmica.
speed_reading_intervals.interval_coordinates REPEATED GEOGRAPHY Fluxos legados: Pode deixar de ser preenchido a partir de 9 de novembro de 2026. Use speed_reading_offsets. A geometria deste intervalo
speed_reading_intervals.speed NULLABLE STRING Fluxos legados: Pode deixar de ser preenchido a partir de 9 de novembro de 2026. Use speed_reading_offsets. A classificação da velocidade para este intervalo. Valores possíveis: NORMAL, SLOW, TRAFFIC_JAM. Nesse campo legado, os engarrafamentos intensos (vermelho escuro) também são informados como TRAFFIC_JAM. TRAFFIC_JAM_HEAVY nunca é usado.
road_segment_ids REPEATED STRING Os trechos da via ao longo do trajeto, representados como IDs de lugar
speed_reading_offsets REPEATED RECORD Intervalos de leitura rápida com base em deslocamento que representam a densidade do tráfego ao longo do trajeto. Cada intervalo é demarcado pelo deslocamento da distância do início do trajeto. Consulte Intervalos de leitura dinâmica.
speed_reading_offsets.start_offset NULLABLE INTEGER O deslocamento da distância desde o início do trajeto em metros para o início do intervalo (inclusivo).
speed_reading_offsets.end_offset NULLABLE INTEGER O deslocamento da distância desde o início da rota em metros até o fim do intervalo (exclusivo; igual ao start_offset do intervalo subsequente).
speed_reading_offsets.speed NULLABLE STRING A classificação da velocidade para esse intervalo, alinhada com as cores na camada de trânsito do Google Maps. Valores possíveis: NORMAL (verde), SLOW (amarelo), TRAFFIC_JAM (vermelho), TRAFFIC_JAM_HEAVY (vermelho escuro, disponível a partir de 8 de outubro de 2026)

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 as informações de trânsito mais recentes gravadas 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 na tabela dela. No entanto, os dados históricos permanecem até o vencimento.
  • Os trechos de via ao longo do trajeto seguem a ordem topológica e estão sempre conectados.
  • A coluna speed_reading_offsets é preenchida para linhas gravadas em ou após 8 de outubro de 2026. As linhas anteriores têm matrizes vazias.
  • A coluna legada speed_reading_intervals pode deixar de ser preenchida em 9 de novembro de 2026 ou depois dessa data. Use speed_reading_offsets.

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 unida às outras duas para filtragem de dados. Este é 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 observou pela primeira vez o baixo uso da via durante a 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 nesta tabela começa com STATUS_ em vez de STATE_. Caso contrário, ela é consistente com a API Roads Selection.

Comportamentos e fatos da tabela

  • Somente rotas com status STATUS_RUNNING ou STATUS_INVALID são incluídas nesta tabela.
  • Os metadados e o status das rotas são atualizados a cada hora, sem interrupção.
  • 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.