Datos de rutas acumulados

Los datos de ruta acumulados se refieren a los datos que puedes recopilar con el tiempo para las rutas que seleccionaste. 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, planificación estratégica y comprender el comportamiento a largo plazo de las rutas.

Los datos acumulados de las rutas 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 nombres:

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 cuadro de diálogo.
  4. Cuando se completa la suscripción, el conjunto de datos vinculado aparece 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 de ruta acumulados de las rutas seleccionadas se alojan en un conjunto de datos de BigQuery aislado de un proyecto de Google Cloud. 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 presentan los detalles de cada tabla.

historical_travel_time tabla

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

Nombre Modo Tipo Descripción
selected_route_id NULLABLE STRING selected_route_id de la ruta
nombre_visible NULLABLE STRING Es el nombre visible de la ruta.
record_time NULLABLE TIMESTAMP La marca de tiempo en la que se calculan los datos de la ruta
duration_in_seconds NULLABLE FLOAT Es la duración de la ruta según el tráfico. Se omite (NULL) cuando has_road_closure es true.
static_duration_in_seconds NULLABLE FLOAT La duración de la ruta sin tener en cuenta el tráfico
route_geometry NULLABLE GEOGRAPHY 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
has_road_closure NULLABLE BOOLEAN Si hay un cierre total de la ruta en el recorrido Cuando true, se omite duration_in_seconds (NULL) porque la ruta es intransitable. Un valor NULL indica que la información de la ruta cerrada no está determinada.

Comportamientos y hechos de las tablas

  • 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 crea 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 que se encuentran a lo largo de la ruta siguen un orden topológico y siempre están conectados.
  • La marca has_road_closure es coherente con el estado de ruta cerrada por completo en Google Maps.

recent_roads_data tabla

Nota: Esta tabla solo está disponible cuando tu contrato incluye datos de rutas en tiempo real.

A diferencia de historical_travel_time, esta tabla también contiene intervalos de lectura de velocidad basados en compensaciones (speed_reading_offsets) y los intervalos de lectura de velocidad basados en coordenadas heredados (speed_reading_intervals). 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 Es el nombre visible de la ruta.
record_time NULLABLE TIMESTAMP La marca de tiempo en la que se calculan los datos de la ruta
duration_in_seconds NULLABLE FLOAT Es la duración de la ruta según el tráfico. Se omite (NULL) cuando has_road_closure es true.
static_duration_in_seconds NULLABLE FLOAT La duración de la ruta sin tener en cuenta el tráfico
route_geometry NULLABLE GEOGRAPHY La geometría de polilínea de la ruta que tiene en cuenta el tráfico
speed_reading_intervals REPEATED RECORD Intervalos de lectura de velocidad basados en coordenadas heredados. Es posible que deje de completarse el 9 de noviembre de 2026 o después de esa fecha. Usa speed_reading_offsets en su lugar. Consulta Intervalos de lectura de velocidad.
speed_reading_intervals.interval_coordinates REPEATED GEOGRAPHY Heredado. Es posible que dejen de propagarse el 9 de noviembre de 2026 o después de esa fecha. Usa speed_reading_offsets en su lugar. La geometría de este intervalo
speed_reading_intervals.speed NULLABLE STRING Heredado. Es posible que dejen de completarse el 9 de noviembre de 2026 o después de esa fecha. Usa speed_reading_offsets en su lugar. Es la clasificación de la velocidad para este intervalo. Valores posibles: NORMAL, SLOW, TRAFFIC_JAM. En este campo heredado, los embotellamientos de tráfico pesado (rojo oscuro) también se informan 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 Son intervalos de lectura de velocidad basados en el desplazamiento que representan la densidad del tráfico en la ruta. Cada intervalo se delimita por el desplazamiento de distancia desde el inicio de la ruta. Se omite cuando has_road_closure es true. Consulta Intervalos de lectura de velocidad.
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 posterior).
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)
has_road_closure NULLABLE BOOLEAN Si hay un cierre total de la ruta en el recorrido Cuando true, duration_in_seconds y speed_reading_offsets se omiten porque la ruta es intransitable. Un valor NULL indica que no se determinó la información de la ruta cerrada.

Comportamientos y hechos de las tablas

  • 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 crea 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 que se encuentran 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 heredada speed_reading_intervals deje de propagarse a partir del 9 de noviembre de 2026. Usa speed_reading_offsets en su lugar.
  • La marca has_road_closure es coherente con el estado de ruta cerrada por completo en Google Maps.

routes_status tabla

La tabla contiene los metadatos de las rutas seleccionadas y la información de estado. 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 Es el 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 hora en que se observó por primera vez un uso bajo de la ruta durante la revalidación. Se asocia con VALIDATION_ERROR_LOW_ROAD_USAGE.
route_attributes NULLABLE STRING Atributos personalizados para la ruta seleccionada
dynamic_routing NULLABLE BOOLEAN Indica si la ruta es dinámica (true) o fija (false). Consulta dynamicRouting.
origin NULLABLE GEOGRAPHY Es el punto de referencia de origen de la ruta.
destino NULLABLE GEOGRAPHY Es el punto de referencia de destino de la ruta.
intermedias REPEATED GEOGRAPHY Son los puntos de referencia intermedios de la ruta.
static_route_geometry NULLABLE GEOGRAPHY Es la geometría de polilínea de la ruta estática calculada sin información sobre el tráfico en tiempo real a partir de los puntos de referencia.
road_segment_ids REPEATED STRING Son los tramos de ruta a lo largo de la ruta estática calculada sin tráfico en tiempo real, representados como IDs de lugar.

Comportamientos y hechos de las tablas

  • 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 crea una ruta nueva en la API de Roads Selection, espera hasta 1 hora para ver la ruta disponible en esta tabla.
  • Una vez que se borra una ruta de la API de Roads Selection, espera hasta 1 hora para que se quite la ruta seleccionada de esta tabla.
  • En el caso de las rutas fijas (dynamic_routing: false), los IDs de lugar en road_segment_ids se actualizan automáticamente para reflejar los cambios en la red de rutas de Google, sin dejar de representar la misma ruta. Para las rutas dinámicas (dynamic_routing: true), road_segment_ids no se actualiza.