Datos de rutas acumulados

Los datos viales acumulados hacen referencia a 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 la duración del viaje, los intervalos de lectura de velocidad (SRI) y la geometría de la ruta para cada ruta. Estos datos se almacenan y se accede a ellos a través de BigQuery.

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:

Suscríbete a tu intercambio de datos

Tus datos viales 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 cuadro de 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 de 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 Es la 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.

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.

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 datos de SpeedReadingInterval. 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 Es la 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 que representan la densidad del tráfico en la ruta. Consulta la definición original en la API de Routes
speed_reading_intervals.interval_coordinates REPEATED GEOGRAPHY La geometría de este intervalo
speed_reading_intervals.speed NULLABLE STRING Es la clasificación de la velocidad para este intervalo. Valores posibles: NORMAL, SLOW, TRAFFIC_JAM

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.

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. 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
estado 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 ruta durante la revalidación. Se asocia con VALIDATION_ERROR_LOW_ROAD_USAGE.
route_attributes NULLABLE STRING Atributos personalizados para la ruta seleccionada

Comportamientos y hechos de la tabla

  • En esta tabla, solo se incluyen las rutas con el estado STATE_RUNNING o STATE_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, deberás esperar hasta 1 hora para que esté disponible en esta tabla.
  • Una vez que se borra una ruta de la API de Roads Selection, espera hasta 1 hora para ver que se quite la ruta seleccionada de esta tabla.