Informacje o weryfikacji trasy

Po utworzeniu trasy interfejs Roads Selection API przeprowadza proces weryfikacji. Ta weryfikacja zapewnia, że trasa nadaje się do zbierania i aktualizowania danych w statystykach zarządzania drogami. Zwykle trwa to kilka minut.

Stan weryfikacji tras możesz monitorować za pomocą pola state w odpowiedzi interfejsu API. Możesz to sprawdzić, używając punktu końcowego get, jak opisano w sekcji Pobieranie wybranych tras, lub badając tabelę routes_status w usłudze BigQuery.

Stany trasy

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

• STATE_UNSPECIFIED: stan weryfikacji tej trasy nie jest ustawiony.
• STATE_VALIDATING: trasa jest weryfikowana.
• STATE_RUNNING: trasa została zweryfikowana i jest teraz aktywna. Interfejs API aktywnie zbiera dane i okresowo wysyła aktualizacje dotyczące tej trasy do BigQuery lub Pub/Sub albo do 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 pole validationError ze szczegółowymi informacjami o tym, dlaczego weryfikacja się nie powiodła.

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 mieć te wartości:

• VALIDATION_ERROR_UNSPECIFIED: błąd weryfikacji tej trasy nie jest ustawiony.
• VALIDATION_ERROR_ROUTE_OUTSIDE_JURISDICTION: Trasa znajduje się poza autoryzowanym obszarem Twojego projektu.
• VALIDATION_ERROR_LOW_ROAD_USAGE: trasa jest mało uczęszczana, co oznacza, że nie można zebrać wystarczającej ilości danych o ruchu, aby przeprowadzić miarodajną analizę. Trasa uznana za nieprawidłową z powodu małego 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 sekcji Trasa z wykorzystaniem dróg o niskim natężeniu ruchu.

Trasa o niskim natężeniu ruchu

Trasy mogą być oznaczone symbolem 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 to nastąpić podczas wstępnej weryfikacji lub 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 zostanie sklasyfikowana jako STATE_INVALID z powodu niskiego natężenia ruchu, interfejs API nadal przetwarza i publikuje w BigQuery wszystkie dostępne dane dotyczące tej trasy.
• Zatrzymanie aktualizacji Pub/Sub: okresowe aktualizacje w czasie rzeczywistym w Pub/Sub zostaną zatrzymane, jeśli state trasy zmieni się na STATE_INVALID.
• Oceny kwartalne: interfejs API przeprowadza kwartalne oceny wszystkich aktywnych tras pod kątem natężenia ruchu.
  • Jeśli podczas oceny wykryjemy małe natężenie ruchu, interfejs API wygeneruje ostrzeżenie w zasobie SelectedRoute.
  • Jeśli niski ruch utrzymuje się przez 4 kolejne kwartały, stan trasy state zmienia się na STATE_INVALID, a aktualizacje Pub/Sub zostają zatrzymane.
• Ponowna weryfikacja jest możliwa: nawet jeśli trasa jest oznaczona jako STATE_INVALID, podlega ciągłej ocenie ruchu. Kolejne oceny mogą ponownie zaklasyfikować trasę jako prawidłową (STATE_RUNNING), jeśli natężenie ruchu na niej wzrośnie powyżej określonego progu.
• Stan monitorowania: stan weryfikacji trasy możesz monitorować za pomocą punktu końcowego get, jak opisano w artykule Pobieranie wybranych tras, lub sprawdzając tabelę routes_status w BigQuery.

Rozwiązywanie problemów z nieprawidłowymi trasami

Jeśli trasa state jest STATE_INVALID, postępuj zgodnie z poniższymi wskazówkami dotyczącymi rozwiązywania problemów w zależności od otrzymanego validationError:

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

• VALIDATION_ERROR_LOW_ROAD_USAGE: ten błąd oznacza, że wybrana trasa nie ma wystarczającej ilości danych o korzystaniu z dróg, aby można było przeprowadzić sensowną analizę i aktualizację. Aby to naprawić, usuń istniejącą trasę i utwórz ją ponownie, wybierając obszar o większym natężeniu ruchu lub „zajętości” na potrzeby zbierania danych. Pamiętaj, że jeśli Twoja trasa ma ten błąd, jej stan może wrócić do STATE_RUNNING, jeśli z czasem wzrośnie na niej ruch, jak opisano w sekcji Trasa o niskim natężeniu ruchu.