Informacje o weryfikacji trasy

Po utworzeniu trasy interfejs Roads Selection API przeprowadza proces weryfikacji. Ta weryfikacja zapewnia, że trasa nadaje się do zbierania danych i aktualizacji w ramach Statystyk dla Zarządców Dróg. Proces ten zwykle trwa kilka minut.

Stan weryfikacji tras możesz monitorować za pomocą pola state w odpowiedzi interfejsu API. Możesz to sprawdzić, korzystając z punktu końcowego get, zgodnie z opisem w sekcji Pobieranie wybranych tras, lub sprawdzając tabelę routes_status w BigQuery.

Stany trasy

Pole state w zasobie SelectedRoute wskazuje bieżący stan weryfikacji i stan operacyjny. Pole state może przyjmować te wartości:

• STATE_UNSPECIFIED: stan weryfikacji tej trasy nie jest ustawiony.
• STATE_VALIDATING: trasa jest weryfikowana.
• STATE_RUNNING: trasa przeszła weryfikację i jest aktywna. Interfejs API aktywnie zbiera dane i wysyła okresowe aktualizacje dotyczące tej trasy do BigQuery, Pub/Sub lub obu tych usług.
• STATE_DELETING: trasa została oznaczona do usunięcia i jest usuwana z systemu.
• STATE_INVALID: trasa nie przeszła weryfikacji na podstawie określonych kryteriów. Gdy trasa jest w stanie STATE_INVALID, odpowiedź zawiera validationError pole ze szczegółowymi informacjami o przyczynie niepowodzenia weryfikacji.

Błędy weryfikacji

Gdy SelectedRoute zasobu state ma wartość STATE_INVALID, odpowiedź interfejsu API zawiera pole validationError. To pole zawiera konkretny powód niepowodzenia weryfikacji.

Pole validationError może przyjmować te wartości:

• VALIDATION_ERROR_UNSPECIFIED: błąd weryfikacji tej trasy nie jest ustawiony.
• VALIDATION_ERROR_ROUTE_OUTSIDE_JURISDICTION: trasa znajduje się poza autoryzowaną jurysdykcją Twojego projektu.
• VALIDATION_ERROR_LOW_ROAD_USAGE: trasa ma niski poziom wykorzystania drogi, co oznacza, że nie można zebrać wystarczającej ilości danych o ruchu, aby przeprowadzić znaczącą analizę. Trasa sklasyfikowana jako nieprawidłowa z powodu niskiego poziomu wykorzystania drogi może ponownie stać się prawidłowa, jeśli natężenie ruchu wzrośnie powyżej określonego progu. Więcej informacji znajdziesz w sekcji Trasa o niskim poziomie wykorzystania drogi.

Trasa o niskim poziomie wykorzystania drogi

Trasy mogą być oznaczane jako VALIDATION_ERROR_LOW_ROAD_USAGE, jeśli interfejs API stwierdzi, że nie ma wystarczającej ilości danych o ruchu, aby przeprowadzić spójną analizę. Może się to zdarzyć podczas wstępnej weryfikacji lub podczas bieżących ocen.

Oto czego możesz się spodziewać w przypadku tras o niskim poziomie wykorzystania drogi:

• Publikowanie danych w BigQuery jest kontynuowane: nawet jeśli trasa jest sklasyfikowana jako STATE_INVALID z powodu niskiego poziomu wykorzystania drogi, interfejs API nadal przetwarza i publikuje w BigQuery wszystkie dostępne dane dotyczące tej trasy.
• Aktualizacje Pub/Sub są wstrzymywane: okresowe aktualizacje w czasie rzeczywistym w Pub/Sub są wstrzymywane, jeśli trasy state zmieni się na STATE_INVALID.
• Oceny kwartalne: interfejs API przeprowadza kwartalne oceny natężenia ruchu na wszystkich aktywnych trasach.
  • Jeśli podczas oceny zostanie wykryty niski poziom ruchu, interfejs API wyświetli ostrzeżenie w zasobie SelectedRoute.
  • Jeśli niski poziom ruchu utrzymuje się przez 4 kolejne kwartały, trasy state zmieni się na STATE_INVALID, a aktualizacje Pub/Sub zostaną wstrzymane.
• Możliwość ponownej weryfikacji: nawet jeśli trasa jest w stanie STATE_INVALID, nadal podlega bieżącym ocenom ruchu. Kolejne oceny mogą ponownie sklasyfikować trasę jako prawidłową (STATE_RUNNING), jeśli natężenie ruchu wzrośnie powyżej określonego progu.
• Monitorowanie stanu: stan weryfikacji trasy możesz monitorować za pomocą punktu końcowego get, zgodnie z opisem w sekcji Pobieranie wybranych tras, lub sprawdzając tabelę routes_status w BigQuery.

Rozwiązywanie problemów z nieprawidłowymi trasami

Jeśli trasa state ma wartość STATE_INVALID, postępuj zgodnie z tymi wskazówkami dotyczącymi rozwiązywania problemów na podstawie otrzymanego kodu validationError:

• VALIDATION_ERROR_ROUTE_OUTSIDE_JURISDICTION: ten błąd oznacza, że zdefiniowana trasa wykracza poza obszar geograficzny autoryzowany dla Twojego projektu. Aby rozwiązać ten problem, usuń istniejącą trasę i utwórz ją ponownie, upewniając się, że wszystkie jej punkty (początek, miejsce docelowe i punkty pośrednie) znajdują się w autoryzowanej jurysdykcji projektu.

• VALIDATION_ERROR_LOW_ROAD_USAGE: ten błąd oznacza, że wybrana trasa nie ma wystarczającej ilości danych o wykorzystaniu drogi, aby przeprowadzić znaczącą analizę i aktualizację. Aby rozwiązać ten problem, usuń istniejącą trasę i utwórz ją ponownie, wybierając obszar o większym wykorzystaniu drogi lub „natężeniu ruchu” do zbierania danych. Pamiętaj, że jeśli trasa ma ten błąd, jej stan może się zmienić z powrotem na STATE_RUNNING, jeśli natężenie ruchu wzrośnie z czasem, zgodnie z opisem w sekcji Trasa o niskim poziomie wykorzystania drogi.