Проверка маршрута

После создания маршрута Roads Selection 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 все доступные данные для этого маршрута.
• Прекращение обновлений издателя-подписчика. Периодические обновления издателя-подписчика в реальном времени прекращаются, если значение state маршрута меняется на STATE_INVALID.
• Ежеквартальные проверки. API ежеквартально проверяет все активные маршруты на объем трафика.
  • Если во время оценки обнаруживается низкий трафик, API выдает предупреждение в ресурсе SelectedRoute.
  • Если низкий трафик сохраняется в течение четырех кварталов подряд, значение state маршрута меняется на STATE_INVALID, а обновления издателя-подписчика прекращаются.
• Повторная проверка возможна. Даже если маршрут STATE_INVALID, он по-прежнему подлежит постоянной оценке трафика. При последующих проверках маршрут может быть классифицирован как действительный (STATE_RUNNING), если объем трафика превысит заданное пороговое значение.
• Отслеживание статуса. Вы можете отслеживать статус проверки маршрута через конечную точку get, как описано в разделе Получение выбранных маршрутов, или путем проверки таблицы routes_status в BigQuery.

Устранение неполадок с недопустимыми маршрутами

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

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

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