Dados acumulados de vias

Os dados de vias acumulados são aqueles que você pode criar ao longo do tempo para os trajetos selecionados. Você começa a receber dados assim que cria um trajeto com a API Roads Selection. Esses dados podem ser usados para análise aprofundada, 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 estradas 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 Analytics Hub.
  3. Conceda os papéis necessários do IAM. 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

Seus dados de vias são compartilhados com você por 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 assinar seus dados:

  1. Clique no link de assinatura fornecido pelo parceiro do Google. Esse link vai levar você diretamente para a 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 assinatura for concluída, o conjunto de dados vinculado vai aparecer no painel Explorador 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 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 meio de uma troca de dados privada criada exclusivamente para você no BigQuery Sharing (Analytics Hub). Para acessar os dados, é preciso se inscrever na troca de dados e criar 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 abaixo os detalhes de cada tabela.

historical_travel_time tabela

Veja a seguir 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 de quando os dados do trajeto são calculados.
duration_in_seconds NULLABLE FLOAT A duração do trajeto considerando o trânsito. Omitido (NULL) quando has_road_closure é true.
static_duration_in_seconds NULLABLE FLOAT A duração do trajeto sem considerar o trânsito
route_geometry NULLABLE GEOGRAPHY A geometria da polilinha do trajeto que considera o trânsito.
road_segment_ids REPEATED STRING Os trechos da via ao longo do trajeto, representados como IDs de lugar
has_road_closure NULLABLE BOOLEANO Se há uma via interditada no trajeto. Quando true, duration_in_seconds é omitido (NULL) porque o trajeto é intransitável. Um valor NULL indica que as informações de via interditada são indeterminadas.

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áfego mais recentes gravados em lote.
  • Depois que uma nova rota é criada na API Roads Selection, pode levar até 1 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.
  • Os trechos de via ao longo do trajeto seguem a ordem topológica e estão sempre conectados.
  • A flag has_road_closure é consistente com o status de via totalmente interditada no Google Maps.

recent_roads_data tabela

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

Diferente de historical_travel_time, essa tabela também contém intervalos de leitura de velocidade baseados em deslocamento (speed_reading_offsets) e intervalos de leitura de velocidade legados baseados em coordenadas (speed_reading_intervals). Veja 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 de quando os dados do trajeto são calculados.
duration_in_seconds NULLABLE FLOAT A duração do trajeto considerando o trânsito. Omitido (NULL) quando has_road_closure é true.
static_duration_in_seconds NULLABLE FLOAT A duração do trajeto sem considerar o trânsito
route_geometry NULLABLE GEOGRAPHY A geometria da polilinha do trajeto que considera o trânsito.
speed_reading_intervals REPEATED RECORD Intervalos de leitura de velocidade legados com base em coordenadas. Pode deixar de ser preenchido a partir de 9 de novembro de 2026. Use speed_reading_offsets. Consulte Intervalos de leitura de velocidade.
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 desse 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 esse 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 de velocidade com base em deslocamento que representam a densidade do trânsito ao longo do trajeto. Cada intervalo é demarcado pelo deslocamento de distância do início do trajeto. Omitido quando has_road_closure é true. Consulte Intervalos de leitura de velocidade.
speed_reading_offsets.start_offset NULLABLE INTEGER O deslocamento de distância do início do trajeto em metros para o início do intervalo (inclusivo)
speed_reading_offsets.end_offset NULLABLE INTEGER A distância em metros do início do trajeto 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)
has_road_closure NULLABLE BOOLEANO Se há uma via interditada no trajeto. Quando true, duration_in_seconds e speed_reading_offsets são omitidos porque o trajeto é intransitável. Um valor NULL indica que as informações de via interditada são indeterminadas.

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áfego mais recentes gravados em lote.
  • Depois que uma nova rota é criada na API Roads Selection, pode levar até 1 hora para que os dados fiquem disponíveis nessa tabela.
  • Depois que um trajeto é excluído da API Roads Selection, nenhum dado novo é gravado nessa tabela para o trajeto. No entanto, os dados históricos permanecem até a expiração.
  • 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 registradas 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 a partir de 9 de novembro de 2026. Use speed_reading_offsets.
  • A flag has_road_closure é consistente com o status de via totalmente interditada no Google Maps.

routes_status tabela

A tabela contém os metadados e as informações de status das rotas selecionadas. O objetivo é oferecer uma maneira mais fácil de visualizar todas as rotas e status. Ela pode ser mesclada com as outras duas tabelas 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 momento em que o trajeto observou pela primeira vez um baixo uso da via durante a revalidação. Está associado a VALIDATION_ERROR_LOW_ROAD_USAGE.
route_attributes NULLABLE STRING Atributos personalizados para a rota selecionada
dynamic_routing NULLABLE BOOLEANO Indica se o trajeto é dinâmico (true) ou fixo (false). Consulte dynamicRouting.
origem NULLABLE GEOGRAPHY Waypoint de origem do trajeto
destino NULLABLE GEOGRAPHY Ponto de passagem de destino do trajeto
intermediários REPEATED GEOGRAPHY Waypoints intermediários do trajeto
static_route_geometry NULLABLE GEOGRAPHY A geometria da polilinha da rota estática calculada sem trânsito em tempo real dos waypoints.
road_segment_ids REPEATED STRING Os trechos da via ao longo do trajeto estático calculado sem trânsito em tempo real, representados como IDs de lugar.

Comportamentos e fatos da tabela

  • Somente as rotas com o 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 um novo trajeto é criado na API Roads Selection, pode levar até 1 hora para que ele apareça nessa tabela.
  • Depois que uma rota é excluída da API Roads Selection, pode levar até 1 hora para que ela seja removida dessa tabela.
  • Para trajetos fixos (dynamic_routing: false), os IDs de lugar em road_segment_ids são atualizados automaticamente para refletir as mudanças na rede de estradas do Google, mas ainda representam o mesmo trajeto. Para rotas dinâmicas (dynamic_routing: true), road_segment_ids não é atualizado.