Comprende la validación de rutas

Después de crear una ruta, la API de Roads Selection realiza un proceso de validación. Esta validación garantiza que la ruta sea adecuada para la recopilación y actualización de datos en Insights de Administración vial. Por lo general, el proceso se completa en unos minutos.

Puedes supervisar el estado de validación de tus rutas a través del campo state en la respuesta de la API. Puedes verificarlo con el extremo get, como se describe en Cómo obtener rutas seleccionadas, o bien examinando la tabla routes_status en BigQuery.

Estados de la ruta

El campo state en un recurso SelectedRoute indica su estado operativo y de validación actual. El campo state puede tener los siguientes valores:

  • STATE_UNSPECIFIED: No se estableció el estado de validación de esta ruta.
  • STATE_VALIDATING: Se está validando la ruta.
  • STATE_RUNNING: La ruta pasó la validación correctamente y ahora está activa. La API recopila datos de forma activa y envía actualizaciones periódicas sobre esta ruta a BigQuery, Pub/Sub o ambos.
  • STATE_DELETING: La ruta se marcó para su eliminación y se está quitando del sistema.
  • STATE_INVALID: La ruta no pasó la validación según criterios específicos. Cuando una ruta está en STATE_INVALID, la respuesta incluye un campo validationError con detalles sobre por qué falló la validación.

Errores de validación

Cuando el campo state de un recurso SelectedRoute es STATE_INVALID, la respuesta de la API incluye un campo validationError. En este campo, se proporciona un motivo específico del error de validación.

El campo validationError puede tener los siguientes valores:

  • VALIDATION_ERROR_UNSPECIFIED: No se estableció el error de validación para esta ruta.
  • VALIDATION_ERROR_ROUTE_OUTSIDE_JURISDICTION: La ruta está fuera de la jurisdicción autorizada de tu proyecto.
  • VALIDATION_ERROR_LOW_ROAD_USAGE: La ruta tiene un uso vial bajo, lo que significa que no se pueden recopilar datos de tráfico suficientes para realizar un análisis significativo. Una ruta clasificada como no válida debido al bajo uso de la ruta puede volver a ser válida si el volumen de tráfico aumenta por encima de un umbral predeterminado. Obtén más información en Ruta con poco uso de la vía.

Ruta con poco uso de la vía

Es posible que las rutas se marquen con VALIDATION_ERROR_LOW_ROAD_USAGE si la API determina que no hay suficientes datos de tráfico para realizar un análisis coherente. Esto puede ocurrir durante la validación inicial o durante las evaluaciones continuas.

Esto es lo que puedes esperar de las rutas con poco uso de la vía:

  • La publicación de datos en BigQuery continúa: Incluso si una ruta se clasifica como STATE_INVALID debido al bajo uso de la vía, la API sigue procesando y publicando los datos disponibles para esa ruta en BigQuery.
  • Se detienen las actualizaciones de Pub/Sub: Las actualizaciones periódicas en tiempo real de Pub/Sub cesan si el state de la ruta cambia a STATE_INVALID.
  • Evaluaciones trimestrales: La API realiza evaluaciones trimestrales de todas las rutas activas para determinar el volumen de tráfico.
    • Si se detecta poco tráfico durante una evaluación, la API emite una advertencia en el recurso SelectedRoute.
    • Si el tráfico bajo persiste durante cuatro trimestres consecutivos, el state de la ruta cambia a STATE_INVALID y se detienen las actualizaciones de Pub/Sub.
  • Es posible la revalidación: Incluso si una ruta es STATE_INVALID, sigue sujeta a evaluaciones de tráfico continuas. Las evaluaciones posteriores pueden volver a clasificar la ruta como válida (STATE_RUNNING) si su volumen de tráfico aumenta por encima de un umbral predeterminado.
  • Estado de supervisión: Puedes supervisar el estado de validación de una ruta a través del extremo get, como se describe en Cómo obtener rutas seleccionadas, o bien examinando la tabla routes_status en BigQuery.

Soluciona problemas relacionados con rutas no válidas

Si el state de tu ruta es STATE_INVALID, sigue los próximos lineamientos para solucionar problemas según el validationError que recibas:

  • VALIDATION_ERROR_ROUTE_OUTSIDE_JURISDICTION: Este error indica que la ruta definida se extiende más allá del área geográfica autorizada para tu proyecto. Para solucionar este problema, borra la ruta existente y vuelve a crearla. Asegúrate de que todos sus puntos (origen, destino y cualquier punto intermedio) se encuentren dentro de la jurisdicción del proyecto autorizado.

  • VALIDATION_ERROR_LOW_ROAD_USAGE: Este error significa que la ruta seleccionada no tiene suficientes datos de uso de la vía para realizar actualizaciones y análisis significativos. Para solucionar este problema, borra la ruta existente y vuelve a crearla. Para ello, selecciona un área con mayor uso de la ruta o "actividad" para la recopilación de datos. Ten en cuenta que, si tu ruta tiene este error, su estado puede volver a ser STATE_RUNNING si el tráfico aumenta con el tiempo, como se describe en Ruta con poco uso de la vía.