Routenvalidierung

Nachdem Sie eine Route erstellt haben, führt die Roads Selection API einen Validierungsprozess durch. Durch diese Validierung wird sichergestellt, dass die Route für die Datenerhebung und ‑aktualisierung in Roads Management Insights geeignet ist. Der Vorgang ist in der Regel innerhalb weniger Minuten abgeschlossen.

Sie können den Validierungsstatus Ihrer Routen über das state Feld in der API-Antwort beobachten. Sie können dies über den get Endpunkt prüfen, wie unter Ausgewählte Routen abrufen beschrieben, oder die routes_status Tabelle in BigQuery untersuchen.

Routenstatus

Das state Feld in einer SelectedRoute Ressource gibt den aktuellen Validierungs- und Betriebsstatus an. Das state Feld kann die folgenden Werte haben:

  • STATE_UNSPECIFIED: Der Validierungsstatus dieser Route ist nicht festgelegt.
  • STATE_VALIDATING: Die Route wird validiert.
  • STATE_RUNNING: Die Route hat die Validierung bestanden und ist jetzt aktiv. Die API erhebt aktiv Daten und sendet regelmäßig Updates für diese Route an BigQuery, Pub/Sub oder beides.
  • STATE_DELETING: Die Route wurde zur Löschung markiert und wird aus dem System entfernt.
  • STATE_INVALID: Die Route hat die Validierung aufgrund bestimmter Kriterien nicht bestanden. Wenn eine Route den Status STATE_INVALID hat, enthält die Antwort das validationError Feld mit Details dazu, warum die Validierung fehlgeschlagen ist.

Validierungsfehler

Wenn der state einer SelectedRoute-Ressource STATE_INVALID ist, enthält die API Antwort das Feld validationError. Dieses Feld enthält einen bestimmten Grund für den Validierungsfehler.

Das validationError Feld kann die folgenden Werte haben:

  • VALIDATION_ERROR_UNSPECIFIED: Der Validierungsfehler für diese Route ist nicht festgelegt.
  • VALIDATION_ERROR_ROUTE_OUTSIDE_JURISDICTION: Die Route liegt außerhalb des autorisierten Zuständigkeitsbereichs Ihres Projekts.
  • VALIDATION_ERROR_LOW_ROAD_USAGE: Die Route hat eine geringe Straßennutzung, was bedeutet, dass nicht genügend Verkehrsdaten für eine aussagekräftige Analyse erhoben werden können. Eine Route, die aufgrund einer geringen Straßennutzung als ungültig eingestuft wurde, kann wieder gültig werden, wenn das Verkehrsaufkommen einen bestimmten Schwellenwert übersteigt. Weitere Informationen finden Sie unter Route mit geringer Straßennutzung.

Route mit geringer Straßennutzung

Routen können mit VALIDATION_ERROR_LOW_ROAD_USAGE gekennzeichnet werden, wenn die API feststellt, dass nicht genügend Verkehrsdaten für eine konsistente Analyse vorhanden sind. Dies kann bei der ersten Validierung oder bei laufenden Auswertungen passieren.

Das passiert bei Routen mit geringer Straßennutzung:

  • Datenveröffentlichung in BigQuery wird fortgesetzt:Auch wenn eine Route aufgrund einer geringen Straßennutzung als STATE_INVALID eingestuft wird, verarbeitet und veröffentlicht die API alle verfügbaren Daten für diese Route weiterhin in BigQuery.
  • Pub/Sub-Updates werden beendet: Regelmäßige Echtzeit-Updates für Pub/Sub werden eingestellt, wenn sich der `state` der Route state in STATE_INVALID ändert.
  • Vierteljährliche Auswertungen:Die API führt vierteljährliche Auswertungen aller aktiven Routen in Bezug auf das Verkehrsaufkommen durch.
    • Wenn bei einer Auswertung wenig Traffic festgestellt wird, gibt die API eine Warnung in der SelectedRoute Ressource aus.
    • Wenn der Traffic vier aufeinanderfolgende Quartale lang gering ist, ändert sich der state in STATE_INVALID und Pub/Sub-Updates werden beendet.
  • Nevalidierung ist möglich:Auch wenn eine Route den Status STATE_INVALID hat, werden weiterhin Verkehrsdaten für sie erhoben. Bei nachfolgenden Auswertungen kann die Route wieder als gültig (STATE_RUNNING) eingestuft werden, wenn das Verkehrsaufkommen einen bestimmten Schwellenwert übersteigt.
  • Status beobachten: Sie können den Validierungsstatus einer Route über den get Endpunkt beobachten, wie unter Ausgewählte Routen abrufen beschrieben, oder die Tabelle routes_status in BigQuery untersuchen.

Fehlerbehebung bei ungültigen Routen

Wenn Ihre Route state STATE_INVALID ist, folgen Sie der Anleitung zur Fehlerbehebung für den jeweiligen validationError:

  • VALIDATION_ERROR_ROUTE_OUTSIDE_JURISDICTION: Dieser Fehler bedeutet, dass die definierte Route über das geografische Gebiet hinausgeht, das für Ihr Projekt autorisiert ist. Löschen Sie die vorhandene Route und erstellen Sie sie noch einmal. Achten Sie darauf, dass sich alle Punkte (Startpunkt, Ziel und alle Zwischenpunkte) innerhalb des autorisierten Zuständigkeitsbereichs Ihres Projekts befinden.

  • VALIDATION_ERROR_LOW_ROAD_USAGE: Dieser Fehler bedeutet, dass für die ausgewählte Route nicht genügend Daten zur Straßennutzung für aussagekräftige Analysen und Updates vorhanden sind. Löschen Sie die vorhandene Route und erstellen Sie die Route noch einmal. Wählen Sie dabei ein Gebiet mit höherer Straßennutzung oder höherer Auslastung für die Datenerhebung aus. Wenn dieser Fehler bei Ihrer Route auftritt, kann sich der Status der Route wieder in STATE_RUNNING ändern, wenn der Traffic im Laufe der Zeit zunimmt, wie unter Route mit geringer Straßennutzung beschrieben.