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

После создания маршрута 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 с подробной информацией о причине ошибки проверки.

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

Если ресурс SelectedRoute имеет state 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 при увеличении трафика с течением времени, как описано в разделе «Маршрут с низкой загруженностью дорог» .