Понять проверку маршрута

После создания маршрута API выбора дорог выполняет процесс проверки. Эта проверка гарантирует, что маршрут подходит для сбора данных и обновления в Roads Management Insights. Обычно процесс завершается в течение нескольких минут.

Вы можете отслеживать статус проверки ваших маршрутов через поле state в ответе API. Проверить это можно с помощью конечной точки get , как описано в разделе «Получение выбранных маршрутов» , или изучив таблицу routes_status в BigQuery.

состояния маршрута

Поле state в ресурсе SelectedRoute указывает на его текущий статус проверки и работоспособности. Поле state может принимать следующие значения:

• STATE_UNSPECIFIED : Состояние проверки этого маршрута не задано.
• STATE_VALIDATING : Маршрут проходит проверку.
• STATE_RUNNING : Маршрут успешно прошёл проверку и теперь активен. API активно собирает данные и отправляет периодические обновления для этого маршрута в BigQuery, Pub/Sub или в оба сервиса.
• STATE_DELETING : Маршрут помечен для удаления и удаляется из системы.
• STATE_INVALID : Маршрут не прошел проверку по определенным критериям. Если маршрут находится в STATE_INVALID , ответ содержит поле validationError с подробным описанием причины сбоя проверки.

Ошибки проверки

Когда state ресурса SelectedRoute равно STATE_INVALID , ответ API включает поле validationError . Это поле указывает конкретную причину сбоя проверки.

Поле validationError может принимать следующие значения:

• VALIDATION_ERROR_UNSPECIFIED : Ошибка проверки для этого маршрута не задана.
• VALIDATION_ERROR_ROUTE_OUTSIDE_JURISDICTION : Маршрут находится за пределами разрешенной юрисдикции вашего проекта.
• VALIDATION_ERROR_LOW_ROAD_USAGE : Маршрут имеет низкую интенсивность движения, что означает, что для проведения содержательного анализа невозможно собрать недостаточно данных о трафике. Маршрут, классифицированный как недействительный из-за низкой интенсивности движения, может снова стать действительным, если объем трафика превысит заданный порог. Подробнее см. в разделе «Маршруты с низкой интенсивностью движения» .

Маршрут с низким уровнем использования дорог

Маршруты могут быть помечены как VALIDATION_ERROR_LOW_ROAD_USAGE если API определит, что данных о трафике недостаточно для корректного анализа. Это может произойти во время первоначальной проверки или в ходе текущих оценок.

Вот чего следует ожидать на маршрутах с низкой интенсивностью движения:

• Публикация данных в BigQuery продолжается: даже если маршрут классифицируется как STATE_INVALID из-за низкой загруженности дорог, API продолжает обрабатывать и публиковать все доступные данные для этого маршрута в BigQuery.
• Обновления Pub/Sub прекращаются: периодические обновления Pub/Sub в режиме реального времени прекращаются, если state маршрута изменяется на STATE_INVALID .
• Ежеквартальные оценки: API проводит ежеквартальные оценки объема трафика по всем активным маршрутам.
  • Если в процессе оценки обнаруживается низкий уровень трафика, API выдает предупреждение в ресурсе SelectedRoute .
  • Если низкий трафик сохраняется в течение четырех кварталов подряд, state маршрута меняется на STATE_INVALID , и обновления Pub/Sub прекращаются.
• Повторная проверка возможна: даже если маршрут находится в STATE_INVALID , он по-прежнему подлежит текущей оценке трафика. Последующие оценки могут переклассифицировать маршрут как действительный ( STATE_RUNNING ), если объем трафика превысит заданный порог.
• Отслеживание статуса: Вы можете отслеживать статус проверки маршрута через конечную точку get , как описано в разделе «Получение выбранных маршрутов» , или путем просмотра таблицы routes_status в BigQuery.

Устранение неполадок, связанных с недействительными маршрутами.

Если state вашего маршрута — STATE_INVALID , следуйте следующим рекомендациям по устранению неполадок в зависимости от полученной validationError :

• VALIDATION_ERROR_ROUTE_OUTSIDE_JURISDICTION : Эта ошибка указывает на то, что определенный маршрут выходит за пределы географической зоны, разрешенной для вашего проекта. Для исправления этой ошибки удалите существующий маршрут и создайте его заново, убедившись, что все его точки (начальная, конечная и любые промежуточные) находятся в пределах юрисдикции вашего разрешенного проекта.

• VALIDATION_ERROR_LOW_ROAD_USAGE : Эта ошибка означает, что для выбранного маршрута недостаточно данных об использовании дорог для проведения содержательного анализа и обновления. Чтобы исправить это, удалите существующий маршрут и создайте его заново, выбрав для сбора данных участок с более высокой интенсивностью движения или «загруженностью» дорог. Обратите внимание, что если ваш маршрут имеет эту ошибку, его статус может вернуться к STATE_RUNNING, если интенсивность движения со временем увеличится, как описано в разделе «Маршруты с низкой интенсивностью движения» .