Informazioni sulla convalida delle route

Dopo aver creato un percorso, l'API Roads Selection esegue un processo di convalida. Questa convalida garantisce che il percorso sia adatto alla raccolta e agli aggiornamenti dei dati in Roads Management Insights. In genere, la procedura viene completata entro pochi minuti.

Puoi monitorare lo stato di convalida dei tuoi itinerari tramite il campo state nella risposta dell'API. Puoi verificarlo utilizzando l'endpoint get, come descritto in Recupera percorsi selezionati, o esaminando la tabella routes_status in BigQuery.

Stati della route

Il campo state in una risorsa SelectedRoute indica lo stato operativo e di convalida attuale. Il campo state può avere i seguenti valori:

  • STATE_UNSPECIFIED: Lo stato di convalida di questa rotta non è impostato.
  • STATE_VALIDATING: il percorso è in fase di convalida.
  • STATE_RUNNING: il percorso ha superato la convalida ed è ora attivo. L'API raccoglie attivamente i dati e invia aggiornamenti periodici per questo percorso a BigQuery, Pub/Sub o entrambi.
  • STATE_DELETING: Il percorso è stato contrassegnato per l'eliminazione e verrà rimosso dal sistema.
  • STATE_INVALID: la route non ha superato la convalida in base a criteri specifici. Quando un percorso è in STATE_INVALID, la risposta include un campo validationError con i dettagli sul motivo per cui la convalida non è andata a buon fine.

Errori di convalida

Quando il campo state di una risorsa SelectedRoute è STATE_INVALID, la risposta dell'API include un campo validationError. Questo campo fornisce un motivo specifico per l'errore di convalida.

Il campo validationError può avere i seguenti valori:

  • VALIDATION_ERROR_UNSPECIFIED: L'errore di convalida per questo percorso non è impostato.
  • VALIDATION_ERROR_ROUTE_OUTSIDE_JURISDICTION: Il percorso si trova al di fuori della giurisdizione autorizzata del tuo progetto.
  • VALIDATION_ERROR_LOW_ROAD_USAGE: La strada è poco trafficata, il che significa che non è possibile raccogliere dati sul traffico sufficienti per un'analisi significativa. Una route classificata come non valida a causa del basso utilizzo della strada può tornare valida se il volume di traffico aumenta al di sopra di una soglia predeterminata. Scopri di più in Percorso con strade a basso utilizzo.

Percorso con utilizzo ridotto di strade

I percorsi potrebbero essere contrassegnati con VALIDATION_ERROR_LOW_ROAD_USAGE se l'API determina che non sono disponibili dati sul traffico sufficienti per un'analisi coerente. Questo può accadere durante la convalida iniziale o durante le valutazioni in corso.

Ecco cosa aspettarsi per i percorsi con scarso utilizzo della strada:

  • La pubblicazione dei dati su BigQuery continua: anche se un percorso è classificato come STATE_INVALID a causa del basso utilizzo della strada, l'API continua a elaborare e pubblicare su BigQuery tutti i dati disponibili per quel percorso.
  • Interruzione degli aggiornamenti Pub/Sub: gli aggiornamenti periodici in tempo reale a Pub/Sub cessano se il state dell'itinerario cambia in STATE_INVALID.
  • Valutazioni trimestrali:l'API esegue valutazioni trimestrali di tutte le route attive per il volume di traffico.
    • Se durante una valutazione viene rilevato un traffico basso, l'API emette un avviso nella risorsa SelectedRoute.
    • Se il traffico ridotto persiste per quattro trimestri consecutivi, lo stato state dell'itinerario cambia in STATE_INVALID e gli aggiornamenti Pub/Sub si interrompono.
  • È possibile la riconvalida: anche se un percorso è STATE_INVALID, rimane soggetto a valutazioni del traffico in corso. Le valutazioni successive potrebbero riclassificare il percorso come valido (STATE_RUNNING) se il volume di traffico aumenta al di sopra di una soglia predeterminata.
  • Stato del monitoraggio:puoi monitorare lo stato di convalida di un percorso tramite l'endpoint get, come descritto in Recupera percorsi selezionati, o esaminando la tabella routes_status in BigQuery.

Risoluzione dei problemi relativi alle route non valide

Se il tuo percorso state è STATE_INVALID, segui le prossime linee guida per la risoluzione dei problemi in base al validationError che ricevi:

  • VALIDATION_ERROR_ROUTE_OUTSIDE_JURISDICTION: questo errore indica che il percorso definito si estende oltre l'area geografica autorizzata per il tuo progetto. Per risolvere il problema, elimina la route esistente e ricreala, assicurandoti che tutti i suoi punti (origine, destinazione e eventuali intermedi) si trovino all'interno della giurisdizione del progetto autorizzato.

  • VALIDATION_ERROR_LOW_ROAD_USAGE: questo errore indica che l'itinerario selezionato non dispone di dati sufficienti sull'utilizzo della strada per un'analisi e aggiornamenti significativi. Per risolvere il problema, elimina l'itinerario esistente e ricrealo, selezionando un'area con un utilizzo stradale o un "traffico" maggiore per la raccolta dei dati. Tieni presente che se il percorso presenta questo errore, il relativo stato può tornare a STATE_RUNNING se il traffico aumenta nel tempo, come descritto in Percorso con basso utilizzo della strada.