Los datos de rutas acumulados se refieren a los datos que puedes crear con el tiempo para las rutas seleccionadas. Comenzarás a recibir datos una vez que crees una ruta con la API de Roads Selection. 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 de rutas 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
Para acceder a los 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 las siguientes configuraciones:
- Habilita la API de BigQuery. Para obtener instrucciones, consulta Consulta un conjunto de datos públicos con la consola de Google Cloud.
- Habilita la API de Analytics Hub. Consulta la API de Analytics Hub.
- 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:
- Suscriptor de Analytics Hub (
roles/analyticshub.subscriber) - Usuario de BigQuery (
roles/bigquery.user)
- Suscriptor de Analytics Hub (
Suscríbete a tu intercambio de datos
Los datos de rutas se comparten contigo a través de un intercambio de datos privados 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:
- 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.
- En la consola de Google Cloud, revisa los detalles del intercambio de datos.
- Haz clic en el botón Suscribirse en el cuadro de diálogo.
- 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 de rutas acumulados de las rutas seleccionadas se alojan en un conjunto de datos de BigQuery aislado de un proyecto de nube propiedad de Google. Se comparten contigo a través de un intercambio de datos privados creado exclusivamente para ti en el uso compartido de BigQuery (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 de BigQuery compartido incluye algunas tablas de BigQuery que Google define y crea. A continuación, se muestran los detalles de cada tabla.
Tabla historical_travel_time
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 |
| display_name | 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 | Duración de la ruta con información sobre el tráfico |
| static_duration_in_seconds | NULLABLE | FLOAT | Duración de la ruta sin información sobre el tráfico |
| route_geometry | NULLABLE | GEOGRAPHY | Geometría de polilínea de la ruta con información sobre el tráfico |
Comportamientos y datos 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 lote.
- 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 el vencimiento.
Tabla recent_roads_data
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. Este es el esquema en BigQuery:
| Nombre | Modo | Tipo | Descripción |
|---|---|---|---|
| selected_route_id | NULLABLE | STRING | selected_route_id de la ruta |
| display_name | 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 | Duración de la ruta con información sobre el tráfico |
| static_duration_in_seconds | NULLABLE | FLOAT | Duración de la ruta sin información sobre el tráfico |
| route_geometry | NULLABLE | GEOGRAPHY | Geometría de polilínea de la ruta con información sobre el tráfico |
| speed_reading_intervals | REPEATED | RECORD | 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 | Geometría de este intervalo |
| speed_reading_intervals.speed | NULLABLE | STRING | Clasificación de la velocidad para este intervalo. Valores posibles: NORMAL, SLOW, TRAFFIC_JAM |
Comportamientos y datos 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 lote.
- 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 el vencimiento.
Tabla routes_status
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 datos. Este es el esquema en BigQuery:
| Nombre | Modo | Tipo | Descripción |
|---|---|---|---|
| selected_route_id | NULLABLE | STRING | selected_route_id de la ruta |
| display_name | 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 | Hora en la 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 datos de la tabla
- En esta tabla, solo se incluyen las rutas en 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.