Накопленные данные о дорогах — это данные, которые вы можете собирать с течением времени для выбранных вами маршрутов. Вы начинаете получать данные после создания маршрута с помощью API выбора дорог. Затем эти данные можно использовать для углубленного анализа, стратегического планирования и понимания долгосрочного поведения маршрутов.
Накопленные данные о дорожной ситуации предоставляются в виде временных рядов, включающих продолжительность поездок, интервалы измерения скорости (SRI) и геометрию маршрута для каждого маршрута. Эти данные хранятся и доступны через BigQuery.
Настройка BigQuery
Прежде чем получить доступ к данным о дорогах в BigQuery, необходимо настроить проект Google Cloud и подписаться на обмен данными.
Предварительные требования
Убедитесь, что ваш проект и учетная запись Google Cloud имеют следующие настройки:
- Включите API BigQuery. Инструкции см. в разделе «Запрос к общедоступному набору данных с помощью консоли Google Cloud» .
- Включите API Analytics Hub. См. раздел «API Analytics Hub» .
- Предоставьте необходимые роли IAM. Убедитесь, что ваша учетная запись имеет следующие роли для выполнения задач подписчика и создания наборов данных:
- Подписчик Analytics Hub (
roles/analyticshub.subscriber) - Пользователь BigQuery (
roles/bigquery.user)
- Подписчик Analytics Hub (
Подпишитесь на обмен данными
Данные о ваших дорогах передаются вам через частный обмен данными в BigQuery (Analytics Hub). Вы получите специальную ссылку для подписки от партнера Google, чтобы получить доступ к своим данным. Этот набор данных соответствует следующей системе именования:
historical_roads_data_PROJECT_NUMBER.
Чтобы подписаться на получение данных:
- Нажмите на ссылку подписки, предоставленную вашим партнером Google. Эта ссылка переведет вас непосредственно к обмену данными в консоли Google Cloud.
- В консоли Google Cloud проверьте сведения об обмене данными.
- Нажмите кнопку «Подписаться» в диалоговом окне.
- После завершения подписки связанный набор данных появится на панели BigQuery Explorer в консоли Google Cloud. Теперь вы можете использовать имена таблиц, отображаемые на панели Explorer, для доступа к данным в ваших SQL-запросах.
Таблицы BigQuery
Накопленные данные о дорогах по выбранным вами маршрутам хранятся в изолированном наборе данных BigQuery в облачном проекте Google. Они предоставляются вам через частный обмен данными, созданный специально для вас в рамках обмена данными BigQuery (Analytics Hub). Для доступа к данным необходимо подписаться на обмен данными и создать связанный набор данных в вашем проекте Google Cloud.
Общий набор данных BigQuery включает в себя несколько таблиц BigQuery, определенных и созданных Google. Ниже приведена подробная информация о каждой таблице.
таблица historical_travel_time
Ниже представлена схема таблицы BigQuery historical_travel_time :
| Имя | Режим | Тип | Описание |
|---|---|---|---|
| selected_route_id | НУЛЕВАЯ | НИТЬ | selected_route_id маршрута |
| отображаемое имя | НУЛЕВАЯ | НИТЬ | Отобразить название маршрута |
| время записи | НУЛЕВАЯ | ОТМЕТКА ВРЕМЕНИ | Отметка времени вычисления данных о маршруте. |
| длительность_в_секундах | НУЛЕВАЯ | ПЛАВАТЬ | Продолжительность маршрута с учетом дорожной ситуации. |
| static_duration_in_seconds | НУЛЕВАЯ | ПЛАВАТЬ | Продолжительность маршрута без учета дорожной ситуации. |
| маршрут_геометрия | НУЛЕВАЯ | ГЕОГРАФИЯ | Полилинейная геометрия маршрута с учетом дорожной ситуации |
Поведение и факты за столом
- Таблица разделена по дням, и для каждой секции установлен 10-летний срок действия.
- Таблица обновляется каждый час, при этом последние данные о трафике записываются пакетами.
- После создания нового маршрута в Roads Selection API следует ожидать, что данные в этой таблице появятся в течение часа.
- После удаления маршрута из API выбора дорог новые данные для этого маршрута в эту таблицу не записываются. Однако исторические данные сохраняются до истечения срока их действия.
таблица recent_roads_data
Примечание : Эта таблица доступна только в том случае, если ваш договор включает данные о состоянии дорог в режиме реального времени .
В отличие от historical_travel_time , эта таблица также содержит данные SpeedReadingInterval . Вот схема в BigQuery:
| Имя | Режим | Тип | Описание |
|---|---|---|---|
| selected_route_id | НУЛЕВАЯ | НИТЬ | selected_route_id маршрута |
| отображаемое имя | НУЛЕВАЯ | НИТЬ | Отобразить название маршрута |
| время записи | НУЛЕВАЯ | ОТМЕТКА ВРЕМЕНИ | Отметка времени вычисления данных о маршруте. |
| длительность_в_секундах | НУЛЕВАЯ | ПЛАВАТЬ | Продолжительность маршрута с учетом дорожной ситуации. |
| static_duration_in_seconds | НУЛЕВАЯ | ПЛАВАТЬ | Продолжительность маршрута без учета дорожной ситуации. |
| маршрут_геометрия | НУЛЕВАЯ | ГЕОГРАФИЯ | Полилинейная геометрия маршрута с учетом дорожной ситуации |
| интервалы_скорости_чтения | ПОВТОРЯЮЩИЙСЯ | ЗАПИСЫВАТЬ | Интервалы, представляющие плотность трафика на маршруте. См. исходное определение в API маршрутов. |
| интервалы_скорости_чтения.координаты_интервала | ПОВТОРЯЮЩИЙСЯ | ГЕОГРАФИЯ | Геометрия для этого интервала |
| speed_reading_intervals.speed | НУЛЕВАЯ | НИТЬ | Классификация скорости для данного интервала. Возможные значения: НОРМАЛЬНАЯ, МЕДЛЕННАЯ, ЗАТОР. |
Поведение и факты за столом
- Таблица разделена по дням, и для каждой секции установлен 60-дневный срок действия.
- Таблица обновляется каждый час, при этом последние данные о трафике записываются пакетами.
- После создания нового маршрута в Roads Selection API следует ожидать, что данные в этой таблице появятся в течение часа.
- После удаления маршрута из API выбора дорог новые данные для этого маршрута в эту таблицу записываться не будут. Однако исторические данные сохраняются до истечения срока их действия.
таблица routes_status
В таблице содержатся метаданные выбранных маршрутов и информация о их статусе. Она призвана упростить просмотр всех маршрутов и их статуса. Для фильтрации данных ее можно объединить с двумя другими таблицами. Вот схема в BigQuery:
| Имя | Режим | Тип | Описание |
|---|---|---|---|
| selected_route_id | НУЛЕВАЯ | НИТЬ | selected_route_id маршрута |
| отображаемое имя | НУЛЕВАЯ | НИТЬ | Отобразить название маршрута |
| статус | НУЛЕВАЯ | НИТЬ | Состояние маршрута |
| ошибка проверки | НУЛЕВАЯ | НИТЬ | Ошибка проверки маршрута |
| время начала использования низких дорог | НУЛЕВАЯ | ОТМЕТКА ВРЕМЕНИ | Время, когда во время повторной проверки маршрута впервые был зафиксирован низкий уровень использования дороги. Оно связано с ошибкой VALIDATION_ERROR_LOW_ROAD_USAGE. |
| route_attributes | НУЛЕВАЯ | НИТЬ | Пользовательские атрибуты для выбранного маршрута |
Поведение и факты за столом
- В эту таблицу включены только маршруты со статусом STATE_RUNNING или STATE_INVALID.
- Метаданные и статус маршрутов обновляются каждый час без перерыва.
- После создания нового маршрута в Roads Selection API, ожидайте, что потребуется до 1 часа, чтобы увидеть доступный маршрут в этой таблице.
- После удаления маршрута из Roads Selection API следует ожидать, что удаление выбранного маршрута из этой таблицы займет до 1 часа.