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 Feld state in der API-Antwort im Blick behalten. Sie können dies mit dem Endpunkt get prüfen, wie unter Ausgewählte Routen abrufen beschrieben, oder indem Sie die Tabelle routes_status in BigQuery untersuchen.
Routenstatus
Das Feld state in einer SelectedRoute-Ressource gibt den aktuellen Validierungs- und Betriebsstatus an. Das Feld state 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 erfolgreich bestanden und ist jetzt aktiv. Die API erfasst aktiv Daten und sendet regelmäßig Aktualisierungen für diese Route an BigQuery, Pub/Sub oder beides.STATE_DELETING: Die Route wurde zum Löschen markiert und wird aus dem System entfernt.STATE_INVALID: Die Route hat die Validierung anhand bestimmter Kriterien nicht bestanden. Wenn eine Route den StatusSTATE_INVALIDhat, enthält die Antwort einvalidationError-Feld mit Details dazu, warum die Validierung fehlgeschlagen ist.
Validierungsfehler
Wenn der state einer SelectedRoute-Ressource STATE_INVALID ist, enthält die API-Antwort ein validationError-Feld. Dieses Feld enthält einen spezifischen Grund für den Validierungsfehler.
Das Feld validationError kann die folgenden Werte haben:
VALIDATION_ERROR_UNSPECIFIED: Der Validierungsfehler für diese Route ist nicht festgelegt.VALIDATION_ERROR_ROUTE_OUTSIDE_JURISDICTION: Die Route befindet sich außerhalb der autorisierten Gerichtsbarkeit Ihres Projekts.VALIDATION_ERROR_LOW_ROAD_USAGE: Die Route wird wenig genutzt, d. h., es können nicht genügend Verkehrsdaten für eine aussagekräftige Analyse erhoben werden. Eine Route, die aufgrund geringer Straßennutzung als ungültig eingestuft wurde, kann wieder gültig werden, wenn das Verkehrsaufkommen einen vordefinierten Schwellenwert überschreitet. Weitere Informationen
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. Das kann bei der ersten Validierung oder bei laufenden Bewertungen passieren.
Das erwartet Sie bei Routen mit geringer Straßennutzung:
- Datenveröffentlichung in BigQuery wird fortgesetzt: Auch wenn eine Route aufgrund geringer Straßennutzung als
STATE_INVALIDeingestuft wird, verarbeitet die API weiterhin alle verfügbaren Daten für diese Route und veröffentlicht sie in BigQuery. - Pub/Sub-Updates werden beendet: Regelmäßige Echtzeit-Updates für Pub/Sub werden beendet, wenn sich der
stateder Route inSTATE_INVALIDändert. - Vierteljährliche Bewertungen: Die API führt vierteljährliche Bewertungen aller aktiven Routen auf Traffic-Volumen durch.
- Wenn während einer Bewertung wenig Traffic erkannt wird, gibt die API eine Warnung in der Ressource
SelectedRouteaus. - Wenn der Traffic vier aufeinanderfolgende Quartale lang niedrig bleibt, ändert sich der
stateder Route inSTATE_INVALIDund Pub/Sub-Updates werden eingestellt.
- Wenn während einer Bewertung wenig Traffic erkannt wird, gibt die API eine Warnung in der Ressource
- Eine erneute Validierung ist möglich: Auch wenn eine Route
STATE_INVALIDist, wird sie weiterhin auf Traffic geprüft. Bei nachfolgenden Bewertungen kann die Route als gültig (STATE_RUNNING) eingestuft werden, wenn das Trafficvolumen einen vordefinierten Schwellenwert überschreitet. - Monitoring-Status: Sie können den Validierungsstatus einer Route über den Endpunkt
getüberwachen, wie unter Ausgewählte Routen abrufen beschrieben, oder indem Sie die Tabelleroutes_statusin BigQuery prüfen.
Fehlerbehebung bei ungültigen Routen
Wenn die Route state den Wert STATE_INVALID hat, folgen Sie den nächsten Schritten zur Fehlerbehebung, je nachdem, welchen validationError Sie erhalten:
VALIDATION_ERROR_ROUTE_OUTSIDE_JURISDICTION: Dieser Fehler weist darauf hin, dass die definierte Route über das für Ihr Projekt autorisierte geografische Gebiet hinausgeht. Löschen Sie dazu die vorhandene Route und erstellen Sie sie neu. Achten Sie darauf, dass sich alle Punkte (Start, Ziel und alle Zwischenstopps) im Zuständigkeitsbereich Ihres autorisierten 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 eine aussagekräftige Analyse und Aktualisierungen vorhanden sind. Löschen Sie dazu die vorhandene Route und erstellen Sie sie neu. Wählen Sie für die Datenerhebung einen Bereich mit höherer Straßennutzung oder „Auslastung“ aus. Wenn dieser Fehler bei Ihrer Route auftritt, kann sich der Status der Route wieder in STATE_RUNNING ändern, wenn das Verkehrsaufkommen im Laufe der Zeit zunimmt, wie unter Route mit geringer Straßennutzung beschrieben.