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

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

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

Настройка BigQuery

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

Требования

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

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

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

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

historical_roads_data_PROJECT_NUMBER.

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

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

Таблицы BigQuery

Накопленные данные о дорогах на выбранных вами маршрутах хранятся в изолированном наборе данных BigQuery в облачном проекте, принадлежащем Google. Они передаются вам через частный обмен данными, созданный специально для вас в BigQuery Sharing (Центр анализа). Чтобы получить доступ к данным, вам нужно подписаться на обмен данными и создать связанный набор данных в облачном проекте 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 Продолжительность маршрута с учетом загруженности дорог. Пропущено (NULL), если has_road_closure – true.
static_duration_in_seconds ДОПУСКАЕТ ЗНАЧЕНИЕ NULL FLOAT Продолжительность маршрута без учета трафика.
route_geometry ДОПУСКАЕТ ЗНАЧЕНИЕ NULL GEOGRAPHY Геометрия ломаной линии маршрута с учетом загруженности дорог.
road_segment_ids ПОВТОРЯЕТСЯ STRING Сегменты дороги на маршруте, представленные в виде идентификаторов мест.
has_road_closure ДОПУСКАЕТ ЗНАЧЕНИЕ NULL BOOLEAN Есть ли на маршруте полностью перекрытый участок дороги. Если true, duration_in_seconds опускается (NULL), так как маршрут непроходим. Значение NULL указывает, что информация о перекрытии дороги не определена.

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

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

Таблица "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 Продолжительность маршрута с учетом загруженности дорог. Пропущено (NULL), если has_road_closure – true.
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 Интервалы скорости на основе смещения, представляющие плотность движения на маршруте. Каждый интервал определяется расстоянием от начала маршрута. Не указывается, если для параметра has_road_closure задано значение true. Подробнее об интервалах считывания скорости…
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 г.).
has_road_closure ДОПУСКАЕТ ЗНАЧЕНИЕ NULL BOOLEAN Есть ли на маршруте полностью перекрытый участок дороги. Если true, duration_in_seconds и speed_reading_offsets опущены, потому что маршрут непроходим. Значение NULL указывает на то, что информация о перекрытом участке дороги не определена.

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

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

Таблица "routes_status"

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

Название Режим Тип Описание
selected_route_id ДОПУСКАЕТ ЗНАЧЕНИЕ NULL STRING selected_route_id маршрута
display_name ДОПУСКАЕТ ЗНАЧЕНИЕ NULL STRING Отображаемое название маршрута.
status* ДОПУСКАЕТ ЗНАЧЕНИЕ NULL STRING Статус маршрута.
validation_error ДОПУСКАЕТ ЗНАЧЕНИЕ NULL STRING Ошибка проверки маршрута.
low_road_usage_start_time ДОПУСКАЕТ ЗНАЧЕНИЕ NULL ВРЕМЕННЫЕ МЕТКИ Время, когда на маршруте впервые было зафиксировано низкое использование дороги во время повторной проверки. Связано с VALIDATION_ERROR_LOW_ROAD_USAGE.
route_attributes ДОПУСКАЕТ ЗНАЧЕНИЕ NULL STRING Настраиваемые атрибуты для выбранного маршрута
dynamic_routing ДОПУСКАЕТ ЗНАЧЕНИЕ NULL BOOLEAN Указывает, является ли маршрут динамическим (true) или фиксированным (false). См. dynamicRouting.
происхождение ДОПУСКАЕТ ЗНАЧЕНИЕ NULL GEOGRAPHY Начальная путевая точка маршрута.
целевой аккаунт ДОПУСКАЕТ ЗНАЧЕНИЕ NULL GEOGRAPHY Пункт назначения маршрута.
промежуточные продукты ПОВТОРЯЕТСЯ GEOGRAPHY Промежуточные путевые точки маршрута.
static_route_geometry ДОПУСКАЕТ ЗНАЧЕНИЕ NULL GEOGRAPHY Геометрия ломаной линии статического маршрута, рассчитанного без учета загруженности дорог в реальном времени на основе путевых точек.
road_segment_ids ПОВТОРЯЕТСЯ STRING Сегменты дороги на статическом маршруте, рассчитанном без учета трафика в реальном времени, представленные в виде идентификаторов мест.

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

  • В эту таблицу включаются только маршруты со статусом STATUS_RUNNING или STATUS_INVALID.
  • Метаданные и статус маршрутов обновляются каждый час.
  • После создания нового маршрута в Roads Selection API он появится в этой таблице в течение часа.
  • После удаления маршрута из Roads Selection API может пройти до часа, прежде чем он исчезнет из этой таблицы.
  • Для фиксированных маршрутов (dynamic_routing: false) идентификаторы мест в road_segment_ids автоматически обновляются, чтобы отражать изменения в дорожной сети Google, но при этом представляют тот же маршрут. Для динамических маршрутов (dynamic_routing: true) road_segment_ids не обновляется.