Informacje o weryfikacji trasy

Po utworzeniu trasy interfejs Roads Selection API przeprowadza proces weryfikacji. Ta weryfikacja gwarantuje, że trasa jest odpowiednia do zbierania danych i aktualizacji w ramach Statystyk dla Zarządców Dróg. Proces zwykle kończy się w ciągu kilku minut.

Stan weryfikacji tras możesz sprawdzać w polu state w odpowiedzi interfejsu API. Możesz to sprawdzić, korzystając z punktu końcowego get, jak opisano w sekcji Pobieranie wybranych tras, lub sprawdzając tabelę routes_status w BigQuery.

Stany tras

Pole state w zasobie SelectedRoute wskazuje jego bieżący stan weryfikacji i status działalności. Pole state może mieć te wartości:

• STATE_UNSPECIFIED: stan weryfikacji tej trasy nie jest ustawiony.
• STATE_VALIDATING: trasa jest sprawdzana.
• STATE_RUNNING: trasa została zweryfikowana i jest teraz 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. Jeśli trasa jest w stanie STATE_INVALID, odpowiedź zawiera pole validationError ze szczegółowymi informacjami o tym, dlaczego weryfikacja się nie powiodła.

Błędy weryfikacji

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

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

• VALIDATION_ERROR_UNSPECIFIED: błąd weryfikacji tej trasy nie jest ustawiony.
• VALIDATION_ERROR_ROUTE_OUTSIDE_JURISDICTION: Trasa znajduje się poza jurysdykcją, w której Twój projekt jest autoryzowany.
• VALIDATION_ERROR_LOW_ROAD_USAGE: trasa jest rzadko używana, co oznacza, że nie można zebrać wystarczającej ilości danych o ruchu, aby przeprowadzić miarodajną analizę. Trasa sklasyfikowana jako nieprawidłowa z powodu niskiego natężenia ruchu może ponownie stać się prawidłowa, jeśli natężenie ruchu wzrośnie powyżej określonego progu. Więcej informacji znajdziesz w artykule Trasa z uwzględnieniem dróg o małym natężeniu ruchu.

Trasa o niskim wykorzystaniu dróg

Trasy mogą być oznaczone flagą VALIDATION_ERROR_LOW_ROAD_USAGE, jeśli interfejs API stwierdzi, że nie ma wystarczającej ilości danych o natężeniu 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 natężeniu ruchu:

• Publikowanie danych w BigQuery jest kontynuowane: nawet jeśli trasa jest klasyfikowana jako STATE_INVALID z powodu niskiego wykorzystania drogi, interfejs API nadal przetwarza i publikuje w BigQuery wszystkie dostępne dane dotyczące tej trasy.
• Zatrzymanie aktualizacji Pub/Sub: okresowe aktualizacje Pub/Sub w czasie rzeczywistym zostaną zatrzymane, jeśli state trasy zmieni się na STATE_INVALID.
• Kwartalne oceny: interfejs API przeprowadza kwartalne oceny wszystkich aktywnych tras pod kątem natężenia ruchu.
  • Jeśli podczas oceny zostanie wykryty niski ruch, interfejs API wyświetli ostrzeżenie w zasobie SelectedRoute.
  • Jeśli niski ruch utrzymuje się przez 4 kolejne kwartały, state trasy zmienia się na STATE_INVALID, a aktualizacje Pub/Sub zostają zatrzymane.
• Możliwa jest ponowna weryfikacja: nawet jeśli trasa jest STATE_INVALID, nadal podlega bieżącej ocenie ruchu. Kolejne oceny mogą zmienić klasyfikację trasy na prawidłową (STATE_RUNNING), jeśli natężenie ruchu wzrośnie powyżej określonego progu.
• Stan monitorowania: stan weryfikacji trasy możesz monitorować za pomocą punktu końcowego get, jak opisano 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 to STATE_INVALID, postępuj zgodnie z instrukcjami rozwiązywania problemów na podstawie otrzymanego komunikatu validationError:

• VALIDATION_ERROR_ROUTE_OUTSIDE_JURISDICTION: ten błąd oznacza, że zdefiniowana trasa wykracza poza obszar geograficzny dozwolony w Twoim projekcie. Aby rozwiązać ten problem, usuń istniejącą trasę i utwórz ją ponownie, upewniając się, że wszystkie jej punkty (początkowy, docelowy i pośrednie) znajdują się w jurysdykcji autoryzowanego projektu.

• VALIDATION_ERROR_LOW_ROAD_USAGE: ten błąd oznacza, że wybrana trasa nie ma wystarczających danych o korzystaniu z dróg, aby można było przeprowadzić analizę i wprowadzić aktualizacje. Aby rozwiązać ten problem, usuń istniejącą trasę i utwórz ją ponownie, wybierając obszar o większym natężeniu ruchu lub „zatłoczeniu” na potrzeby zbierania danych. Pamiętaj, że jeśli Twoja trasa ma ten błąd, jej stan może zmienić się z powrotem na STATE_RUNNING, jeśli ruch z czasem wzrośnie, jak opisano w sekcji Trasa o niskim wykorzystaniu drogi.