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 dei dati e agli aggiornamenti all'interno di Insight di gestione stradale. In genere, il processo viene completato entro pochi minuti.

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

Stati delle route

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

  • STATE_UNSPECIFIED: lo stato di convalida di questa route non è impostato.
  • STATE_VALIDATING: la route è in fase di convalida.
  • STATE_RUNNING: la route ha superato la convalida ed è ora attiva. L'API raccoglie attivamente i dati e invia aggiornamenti periodici per questa route a BigQuery, Pub/Sub o entrambi.
  • STATE_DELETING: la route è stata contrassegnata per l'eliminazione e viene rimossa dal sistema.
  • STATE_INVALID: la route non ha superato la convalida in base a criteri specifici. Quando una route è in STATE_INVALID, la risposta include un campo validationError con i dettagli sul motivo per cui la convalida non è riuscita.

Errori di convalida

Quando il valore 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 questa route non è impostato.
  • VALIDATION_ERROR_ROUTE_OUTSIDE_JURISDICTION giurisdizione autorizzata del tuo progetto.
  • VALIDATION_ERROR_LOW_ROAD_USAGE: il percorso ha un utilizzo ridotto della strada, il che significa che non è possibile raccogliere dati sul traffico sufficienti per un'analisi significativa. Un percorso classificato come non valido a causa di un utilizzo ridotto della strada può tornare valido se il volume di traffico aumenta oltre una soglia predeterminata. Scopri di più in Percorso con utilizzo ridotto della strada.

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 un utilizzo ridotto della strada:

  • La pubblicazione dei dati in BigQuery continua: anche se un percorso è classificato come STATE_INVALID a causa di un utilizzo ridotto della strada, l'API continua a elaborare e pubblicare i dati disponibili per quel percorso in BigQuery.
  • Interruzione degli aggiornamenti di Pub/Sub: gli aggiornamenti periodici in tempo reale a Pub/Sub vengono interrotti se il valore state della route 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 volume di traffico basso, l'API genera un avviso all'interno della risorsa SelectedRoute.
    • Se il traffico ridotto persiste per quattro trimestri consecutivi, il valore state del percorso cambia in STATE_INVALID e gli aggiornamenti di Pub/Sub vengono interrotti.
  • La riconvalida è possibile: anche se un percorso è STATE_INVALID, rimane soggetto a valutazioni continue del traffico. Le valutazioni successive potrebbero riclassificare il percorso come valido (STATE_RUNNING) se il volume di traffico aumenta oltre una soglia predeterminata.
  • Stato del monitoraggio: puoi monitorare lo stato di convalida di un percorso tramite l'endpoint get, come descritto in Recupera i percorsi selezionati, o esaminando la tabella routes_status in BigQuery.

Risoluzione dei problemi relativi alle route non valide

Se la route state è STATE_INVALID, segui le linee guida per la risoluzione dei problemi successive 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 il percorso esistente e ricrealo, assicurandoti che tutti i suoi punti (origine, destinazione ed eventuali punti intermedi) rientrino nella giurisdizione del progetto autorizzato.

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