Datos de rutas acumulados

Los datos de rutas acumulados son los datos que puedes recopilar con el tiempo para las rutas seleccionadas. Comenzarás a recibir datos una vez que crees una ruta con la API de Roads Selection. Luego, estos datos se pueden usar para realizar análisis detallados, planificar estrategias y comprender el comportamiento a largo plazo de las rutas.

Los datos viales acumulados se proporcionan como datos de series temporales, que incluyen lo siguiente:

Configura BigQuery

Antes de acceder a tus datos de rutas en BigQuery, debes configurar tu proyecto de Google Cloud y suscribirte al intercambio de datos.

Requisitos previos

Asegúrate de que tu proyecto y cuenta de Google Cloud tengan la siguiente configuración:

  1. Habilita la API de BigQuery. Para obtener instrucciones, consulta Consulta un conjunto de datos públicos con la consola de Google Cloud.
  2. Habilita la API de Analytics Hub. Consulta la API de Analytics Hub.
  3. Otorga los roles de IAM necesarios. Asegúrate de que tu cuenta tenga los siguientes roles para realizar tareas de suscriptor y crear conjuntos de datos:
  4. Suscriptor de Analytics Hub (roles/analyticshub.subscriber)

Suscríbete a tu intercambio de datos

Tus datos de rutas se comparten contigo a través de un intercambio de datos privado en BigQuery (Analytics Hub). Recibirás un vínculo de suscripción específico de un socio de Google para acceder a tus datos. Este conjunto de datos cumple con la siguiente convención de nomenclatura:

historical_roads_data_PROJECT_NUMBER.

Para suscribirte a tus datos, haz lo siguiente:

  1. Haz clic en el vínculo de suscripción que te proporcionó tu socio de Google. Este vínculo te llevará directamente al intercambio de datos en la consola de Google Cloud.
  2. En la consola de Google Cloud, revisa los detalles del intercambio de datos.
  3. Haz clic en el botón Suscribirse en el diálogo.
  4. Cuando se complete la suscripción, el conjunto de datos vinculado aparecerá en el panel Explorador de BigQuery en la consola de Google Cloud. Ahora puedes usar los nombres de las tablas que se muestran en el panel Explorador para acceder a los datos en tus consultas en SQL.

Tablas de BigQuery

Los datos viales acumulados de las rutas seleccionadas se alojan en un conjunto de datos de BigQuery aislado de un proyecto de Cloud propiedad de Google. Se comparte contigo a través de un intercambio de datos privado creado exclusivamente para ti en BigQuery sharing (Analytics Hub). Para acceder a los datos, debes suscribirte al intercambio de datos y crear un conjunto de datos vinculado en tu proyecto de Google Cloud.

El conjunto de datos compartido de BigQuery incluye algunas tablas de BigQuery que Google define y crea. A continuación, se incluyen los detalles de cada tabla.

historical_travel_time tabla

A continuación, se muestra el esquema de la tabla historical_travel_time de BigQuery:

Nombre Modo Tipo Descripción
selected_route_id NULLABLE STRING selected_route_id de la ruta
nombre_visible NULLABLE STRING Nombre visible de la ruta
record_time NULLABLE TIMESTAMP Marca de tiempo en la que se calculan los datos de la ruta
duration_in_seconds NULLABLE FLOAT La duración de la ruta teniendo en cuenta el tráfico
static_duration_in_seconds NULLABLE FLOAT La duración de la ruta sin tener en cuenta el tráfico
route_geometry NULLABLE GEOGRAPHY Es la geometría de polilínea de la ruta que tiene en cuenta el tráfico.
road_segment_ids REPEATED STRING Los tramos de ruta a lo largo de la ruta, representados como IDs de lugar

Comportamientos y hechos de la tabla

  • La tabla se particiona por día y tiene un vencimiento de 10 años establecido para cada partición.
  • La tabla se actualiza cada hora con los datos de tráfico más recientes escritos en lotes.
  • Una vez que se cree una ruta nueva en la API de Roads Selection, espera hasta 1 hora para ver los datos disponibles en esta tabla.
  • Una vez que se borra una ruta de la API de Roads Selection, no se escriben datos nuevos en esta tabla para la ruta. Sin embargo, los datos históricos permanecen hasta su vencimiento.
  • Los tramos de ruta a lo largo de la ruta siguen un orden topológico y siempre están conectados.

recent_roads_data tabla

Nota: Esta tabla solo está disponible cuando tu contrato incluye Datos viales en tiempo real.

A diferencia de historical_travel_time, esta tabla también contiene intervalos de lectura rápida basados en el desplazamiento (speed_reading_offsets) y los intervalos de lectura rápida heredados basados en coordenadas (speed_reading_intervals). A continuación, se muestra el esquema en BigQuery:

Nombre Modo Tipo Descripción
selected_route_id NULLABLE STRING selected_route_id de la ruta
nombre_visible NULLABLE STRING Nombre visible de la ruta
record_time NULLABLE TIMESTAMP Marca de tiempo en la que se calculan los datos de la ruta
duration_in_seconds NULLABLE FLOAT La duración de la ruta teniendo en cuenta el tráfico
static_duration_in_seconds NULLABLE FLOAT La duración de la ruta sin tener en cuenta el tráfico
route_geometry NULLABLE GEOGRAPHY Es la geometría de polilínea de la ruta que tiene en cuenta el tráfico.
speed_reading_intervals REPEATED RECORD Son intervalos de lectura rápida heredados basados en coordenadas. Es posible que deje de completarse el 9 de noviembre de 2026 o después de esa fecha. En su lugar, usa speed_reading_offsets. Consulta los intervalos de lectura rápida.
speed_reading_intervals.interval_coordinates REPEATED GEOGRAPHY Heredado. Es posible que deje de completarse a partir del 9 de noviembre de 2026. En su lugar, usa speed_reading_offsets. La geometría de este intervalo
speed_reading_intervals.speed NULLABLE STRING Heredado. Es posible que deje de completarse a partir del 9 de noviembre de 2026. En su lugar, usa speed_reading_offsets. Clasificación de la velocidad para este intervalo. Valores posibles: NORMAL, SLOW, TRAFFIC_JAM. En este campo heredado, los embotellamientos graves (rojo oscuro) también se registran como TRAFFIC_JAM; nunca se usa TRAFFIC_JAM_HEAVY.
road_segment_ids REPEATED STRING Los tramos de ruta a lo largo de la ruta, representados como IDs de lugar
speed_reading_offsets REPEATED RECORD Intervalos de lectura de velocidad basados en el desplazamiento que representan la densidad del tráfico en toda la ruta. Cada intervalo está demarcado por el desplazamiento de distancia desde el inicio de la ruta. Consulta los intervalos de lectura rápida.
speed_reading_offsets.start_offset NULLABLE INTEGER Es el desplazamiento de distancia desde el inicio de la ruta en metros para el inicio del intervalo (inclusive).
speed_reading_offsets.end_offset NULLABLE INTEGER Es el desplazamiento de distancia desde el inicio de la ruta en metros para el final del intervalo (exclusivo; equivale al start_offset del intervalo subsiguiente).
speed_reading_offsets.speed NULLABLE STRING Es la clasificación de la velocidad para este intervalo, alineada con los colores de la capa de tráfico de Google Maps. Valores posibles: NORMAL (verde), SLOW (amarillo), TRAFFIC_JAM (rojo), TRAFFIC_JAM_HEAVY (rojo oscuro, disponible a partir del 8 de octubre de 2026)

Comportamientos y hechos de la tabla

  • La tabla se particiona por día y tiene un vencimiento de 60 días establecido para cada partición.
  • La tabla se actualiza cada hora con los datos de tráfico más recientes escritos en lotes.
  • Una vez que se cree una ruta nueva en la API de Roads Selection, espera hasta 1 hora para ver los datos disponibles en esta tabla.
  • Una vez que se borra una ruta de la API de Roads Selection, no se escribirán datos nuevos en esta tabla para la ruta. Sin embargo, los datos históricos permanecen hasta su vencimiento.
  • Los tramos de ruta a lo largo de la ruta siguen un orden topológico y siempre están conectados.
  • La columna speed_reading_offsets se completa para las filas registradas a partir del 8 de octubre de 2026. Las filas anteriores tienen arrays vacíos.
  • Es posible que la columna speed_reading_intervals heredada deje de propagarse a partir del 9 de noviembre de 2026. Usa speed_reading_offsets en su lugar.

routes_status tabla

La tabla contiene los metadatos y la información de estado de las rutas seleccionadas. Su objetivo es proporcionar una forma más sencilla de ver todas las rutas y el estado. Se puede unir con las otras dos tablas para filtrar los datos. Este es el esquema en BigQuery:

Nombre Modo Tipo Descripción
selected_route_id NULLABLE STRING selected_route_id de la ruta
nombre_visible NULLABLE STRING Nombre visible de la ruta
status* NULLABLE STRING Estado de la ruta
validation_error NULLABLE STRING Error de validación de la ruta
low_road_usage_start_time NULLABLE TIMESTAMP Es la fecha y hora en que la ruta observó por primera vez un uso bajo de la vía durante la revalidación. Se asocia con VALIDATION_ERROR_LOW_ROAD_USAGE.
route_attributes NULLABLE STRING Atributos personalizados para la ruta seleccionada

*El estado de la ruta en esta tabla comienza con STATUS_ en lugar de STATE_. De lo contrario, es coherente con la API de Roads Selection.

Comportamientos y hechos de la tabla

  • En esta tabla, solo se incluyen las rutas con el estado STATUS_RUNNING o STATUS_INVALID.
  • Los metadatos y el estado de las rutas se actualizan cada hora, sin interrupciones.
  • Una vez que se cree una ruta nueva en la API de Roads Selection, espera hasta 1 hora para verla disponible en esta tabla.
  • Una vez que se borra una ruta de la API de Roads Selection, es posible que debas esperar hasta 1 hora para que se quite la ruta seleccionada de esta tabla.