Informazioni sulla convalida delle route

Dopo aver creato una route, l'API Roads Selection esegue un processo di convalida. Questa convalida garantisce che la route sia adatta alla raccolta dei dati e agli aggiornamenti in Insight di gestione stradale. In genere, il processo viene completato in pochi minuti.

Puoi monitorare lo stato di convalida delle route tramite il state campo nella risposta dell'API. Puoi verificarlo utilizzando l'endpoint get, come descritto in Recuperare le route selezionate, o esaminando la tabella routes_status in BigQuery.

Stati delle route

Il campo state di una risorsa SelectedRoute indica lo stato operativo e di convalida corrente. 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 convalida della route non è riuscita in base a criteri specifici. Quando una route è in STATE_INVALID, la risposta include un validationError campo con i dettagli sul motivo per cui la convalida non è riuscita.

Errori di convalida

Quando il 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: la route si trova al di fuori della giurisdizione autorizzata del tuo progetto.
  • VALIDATION_ERROR_LOW_ROAD_USAGE: la route ha un utilizzo stradale ridotto, 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 stradale potrebbe tornare a essere valida se il volume di traffico supera una soglia predeterminata. Scopri di più in Route con utilizzo stradale ridotto.

Route con utilizzo stradale ridotto

Le route potrebbero essere contrassegnate 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 le route con un utilizzo stradale ridotto:

  • La pubblicazione dei dati in BigQuery continua: anche se una route è classificata come STATE_INVALID a causa del basso utilizzo stradale, l'API continua a elaborare e pubblicare tutti i dati disponibili per quella route in BigQuery.
  • Gli aggiornamenti di Pub/Sub si interrompono: gli aggiornamenti periodici in tempo reale a Pub/Sub cessano se lo stato della route state cambia in STATE_INVALID.
  • Valutazioni trimestrali: l'API esegue valutazioni trimestrali del volume di traffico di tutte le route attive.
    • Se durante una valutazione viene rilevato un traffico ridotto, l'API emette un avviso nella risorsa SelectedRoute.
    • Se il traffico ridotto persiste per quattro trimestri consecutivi, lo state cambia in STATE_INVALID, e gli aggiornamenti di Pub/Sub si interrompono.
  • È possibile eseguire una nuova convalida: anche se una route è STATE_INVALID, rimane soggetta a valutazioni del traffico in corso. Le valutazioni successive potrebbero riclassificare la route come valida (STATE_RUNNING) se il volume di traffico supera una soglia predeterminata.
  • Monitoraggio dello stato: puoi monitorare lo stato di convalida di una route tramite l'endpoint get, come descritto in Recuperare le route selezionate, o esaminando la tabella routes_status in BigQuery.

Risoluzione dei problemi relativi alle route non valide

Se la tua route 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 la route definita 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 ed eventuali punti intermedi) si trovino all'interno della giurisdizione del progetto autorizzato.

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