Накопленные данные о дорогах

Накопленные данные о дорогах – это данные, которые вы можете собирать с течением времени для выбранных маршрутов. Вы начнете получать данные после того, как создадите маршрут с помощью Roads Selection API. Эти данные можно использовать для углубленного анализа, стратегического планирования и понимания долгосрочного поведения маршрутов.

Накопленные данные о дорогах предоставляются в виде временных рядов, которые включают:

Как настроить BigQuery

Чтобы получить доступ к данным о дорогах в BigQuery, необходимо настроить проект Google Cloud и подписаться на обмен данными.

Требования

Убедитесь, что в вашем облачном проекте и аккаунте Google Cloud заданы следующие настройки:

  1. Включите BigQuery API. Инструкции приведены в статье Как отправить запрос к общедоступному набору данных с помощью консоли Google Cloud.
  2. Включите Analytics Hub API. Подробнее об API Центра Аналитики…
  3. Предоставьте необходимые роли IAM. Чтобы выполнять задачи подписчика и создавать наборы данных, у вашего аккаунта должны быть следующие роли:
  4. Подписчик Центра аналитики (roles/analyticshub.subscriber)

Как подписаться на обмен данными

Данные о дорогах предоставляются вам через частный обмен данными в BigQuery (Центр Аналитики). Вы получите от партнера Google специальную ссылку для доступа к данным. Этот набор данных соответствует следующим правилам именования:

historical_roads_data_PROJECT_NUMBER.

Чтобы подписаться на данные:

  1. Нажмите на ссылку для подписки, предоставленную Партнером Google. Эта ссылка ведет непосредственно к обмену данными в консоли Google Cloud.
  2. В консоли Google Cloud проверьте сведения об обмене данными.
  3. В диалоговом окне нажмите кнопку Подписаться.
  4. После завершения подписки связанный набор данных появится на панели Обозреватель BigQuery в консоли Google Cloud. Теперь вы можете использовать названия таблиц, показанные на панели "Проводник", чтобы получать доступ к данным в SQL-запросах.

Таблицы BigQuery

Собранные данные о дорогах для выбранных маршрутов хранятся в изолированном наборе данных BigQuery в облачном проекте, принадлежащем Google. Он предоставляется вам через частный обмен данными, созданный специально для вас в BigQuery (Центр Аналитики). Чтобы получить доступ к данным, вам нужно подписаться на обмен данными и создать связанный набор данных в своем облачном проекте Google Cloud.

В общем наборе данных BigQuery есть несколько таблиц BigQuery, которые определены и созданы Google. Ниже приведена информация о каждой таблице.

Таблица: historical_travel_time

Ниже приведена схема таблицы BigQuery historical_travel_time:

Название Режим Тип Описание
selected_route_id ДОПУСКАЕТ ЗНАЧЕНИЕ NULL STRING selected_route_id маршрута
display_name ДОПУСКАЕТ ЗНАЧЕНИЕ NULL STRING Отображаемое название маршрута.
record_time ДОПУСКАЕТ ЗНАЧЕНИЕ NULL ВРЕМЕННЫЕ МЕТКИ Временная метка, указывающая, когда были рассчитаны данные маршрута.
duration_in_seconds ДОПУСКАЕТ ЗНАЧЕНИЕ NULL FLOAT Продолжительность маршрута с учетом дорожной ситуации
static_duration_in_seconds ДОПУСКАЕТ ЗНАЧЕНИЕ NULL FLOAT Продолжительность маршрута без учета трафика
route_geometry ДОПУСКАЕТ ЗНАЧЕНИЕ NULL GEOGRAPHY Геометрия ломаной линии маршрута с учетом дорожной обстановки.
road_segment_ids ПОВТОРЯЕТСЯ STRING Сегменты дороги на маршруте, представленные в виде идентификаторов мест.

Факты и особенности работы с таблицами

  • Таблица разделена на разделы по дням, и для каждого раздела установлен срок действия 10 лет.
  • Таблица обновляется каждый час с помощью пакетной записи последних данных о трафике.
  • После создания нового маршрута в Roads Selection API данные появятся в этой таблице в течение часа.
  • После удаления маршрута из Roads Selection API в эту таблицу не будут записываться новые данные для него. Однако статистика сохраняется до истечения срока хранения.
  • Сегменты дороги на маршруте следуют в топологическом порядке и всегда соединены.

Таблица: recent_roads_data

Примечание. Эта таблица доступна, только если ваш договор включает данные о дорогах в реальном времени.

В отличие от таблицы historical_travel_time, в этой таблице также хранятся интервалы быстрого чтения на основе смещения (speed_reading_offsets) и устаревшие интервалы быстрого чтения на основе координат (speed_reading_intervals). Ниже приведена схема в BigQuery:

Название Режим Тип Описание
selected_route_id ДОПУСКАЕТ ЗНАЧЕНИЕ NULL STRING selected_route_id маршрута
display_name ДОПУСКАЕТ ЗНАЧЕНИЕ NULL STRING Отображаемое название маршрута.
record_time ДОПУСКАЕТ ЗНАЧЕНИЕ NULL ВРЕМЕННЫЕ МЕТКИ Временная метка, указывающая, когда были рассчитаны данные маршрута.
duration_in_seconds ДОПУСКАЕТ ЗНАЧЕНИЕ NULL FLOAT Продолжительность маршрута с учетом дорожной ситуации
static_duration_in_seconds ДОПУСКАЕТ ЗНАЧЕНИЕ NULL FLOAT Продолжительность маршрута без учета трафика
route_geometry ДОПУСКАЕТ ЗНАЧЕНИЕ NULL GEOGRAPHY Геометрия ломаной линии маршрута с учетом дорожной обстановки.
speed_reading_intervals ПОВТОРЯЕТСЯ RECORD Устаревшие интервалы для быстрого чтения на основе координат. Может перестать заполняться 9 ноября 2026 г. или позже. Используйте вместо него speed_reading_offsets. Подробнее об интервалах скорочтения…
speed_reading_intervals.interval_coordinates ПОВТОРЯЕТСЯ GEOGRAPHY Устаревшая версия. Может перестать заполняться 9 ноября 2026 г. или позже. Используйте вместо него speed_reading_offsets. Геометрия для этого интервала
speed_reading_intervals.speed ДОПУСКАЕТ ЗНАЧЕНИЕ NULL STRING Устаревшая версия. Может перестать заполняться 9 ноября 2026 г. или позже. Используйте вместо него speed_reading_offsets. Классификация скорости для этого интервала. Возможные значения: NORMAL, SLOW, TRAFFIC_JAM. В этом устаревшем поле серьезные пробки (темно-красный цвет) также обозначаются как TRAFFIC_JAM, а значение TRAFFIC_JAM_HEAVY не используется.
road_segment_ids ПОВТОРЯЕТСЯ STRING Сегменты дороги на маршруте, представленные в виде идентификаторов мест.
speed_reading_offsets ПОВТОРЯЕТСЯ RECORD Интервалы скорости, основанные на смещении, которые представляют плотность трафика на маршруте. Каждый интервал ограничен смещением расстояния от начала маршрута. Подробнее об интервалах скорочтения…
speed_reading_offsets.start_offset ДОПУСКАЕТ ЗНАЧЕНИЕ NULL INTEGER Смещение от начала маршрута в метрах для начала интервала (включительно).
speed_reading_offsets.end_offset ДОПУСКАЕТ ЗНАЧЕНИЕ NULL INTEGER Смещение в метрах от начала маршрута до конца интервала (не включительно; равно значению start_offset следующего интервала).
speed_reading_offsets.speed ДОПУСКАЕТ ЗНАЧЕНИЕ NULL STRING Классификация скорости для этого интервала, соответствующая цветам на слое трафика Google Карт. Возможные значения: NORMAL (зеленый), SLOW (желтый), TRAFFIC_JAM (красный), TRAFFIC_JAM_HEAVY (темно-красный, доступно с 8 октября 2026 г.).

Факты и особенности работы с таблицами

  • Таблица разделена на разделы по дням, и для каждого раздела установлен срок действия 60 дней.
  • Таблица обновляется каждый час с помощью пакетной записи последних данных о трафике.
  • После создания нового маршрута в Roads Selection API данные появятся в этой таблице в течение часа.
  • После удаления маршрута из Roads Selection API в таблицу больше не будут записываться новые данные для этого маршрута. Однако статистика сохраняется до истечения срока хранения.
  • Сегменты дороги на маршруте следуют в топологическом порядке и всегда соединены.
  • Столбец speed_reading_offsets заполняется для строк, записанных 8 октября 2026 г. или позже. В более ранних строках массивы пустые.
  • Столбец устаревшей версии speed_reading_intervals может перестать заполняться 9 ноября 2026 г. или позднее. Вместо нее следует использовать speed_reading_offsets.

Таблица: routes_status

В таблице содержатся метаданные выбранных маршрутов и информация об их статусе. Он позволяет легко просматривать все маршруты и их статус. Ее можно объединить с двумя другими таблицами для фильтрации данных. Вот схема в BigQuery:

Название Режим Тип Описание
selected_route_id ДОПУСКАЕТ ЗНАЧЕНИЕ NULL STRING selected_route_id маршрута
display_name ДОПУСКАЕТ ЗНАЧЕНИЕ NULL STRING Отображаемое название маршрута.
Статус* ДОПУСКАЕТ ЗНАЧЕНИЕ NULL STRING Статус маршрута.
validation_error ДОПУСКАЕТ ЗНАЧЕНИЕ NULL STRING Ошибка проверки маршрута
low_road_usage_start_time ДОПУСКАЕТ ЗНАЧЕНИЕ NULL ВРЕМЕННЫЕ МЕТКИ Время, когда во время повторной проверки маршрута впервые было отмечено низкое использование дороги. Она связана с ошибкой VALIDATION_ERROR_LOW_ROAD_USAGE.
route_attributes ДОПУСКАЕТ ЗНАЧЕНИЕ NULL STRING Настраиваемые атрибуты для выбранного маршрута

*Статус маршрута в этой таблице начинается с STATUS_, а не с STATE_. В остальном он соответствует Roads Selection API.

Факты и особенности работы с таблицами

  • В эту таблицу включены только маршруты со статусом STATUS_RUNNING или STATUS_INVALID.
  • Метаданные и статус маршрутов обновляются каждый час.
  • После создания нового маршрута в Roads Selection API может пройти до часа, прежде чем он появится в этой таблице.
  • После удаления маршрута из Roads Selection API может пройти до часа, прежде чем он исчезнет из этой таблицы.