Накопленные данные о дорогах — это данные, которые вы можете накапливать с течением времени для выбранных вами маршрутов. Вы начинаете получать данные сразу после создания маршрута с помощью API выбора дорог. Эти данные затем можно использовать для глубокого анализа, стратегического планирования и понимания долгосрочного поведения маршрутов.
Накопленные данные о дорожном движении предоставляются в виде временных рядов, включая длительность поездки, интервалы измерения скорости (SRI) и геометрию маршрута для каждого маршрута. Эти данные хранятся и доступны через BigQuery.
Настройте BigQuery
Прежде чем получить доступ к данным о дорогах в BigQuery, необходимо настроить свой проект Google Cloud и подписаться на обмен данными.
Предпосылки
Убедитесь, что ваш проект и учетная запись Google Cloud имеют следующие конфигурации:
- Включите API BigQuery. Инструкции см. в статье «Выполнение запросов к публичному набору данных с помощью консоли Google Cloud» .
- Включите Analytics Hub API. См. Analytics Hub API .
- Назначьте необходимые роли 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 маршрута |
| отображаемое имя | ОБНУЛЯЕМЫЙ | НИТЬ | Отображаемое название маршрута |
| время_записи | ОБНУЛЯЕМЫЙ | МЕТКА ВРЕМЕНИ | Метка времени, когда вычисляются данные маршрута |
| длительность_в_секундах | ОБНУЛЯЕМЫЙ | ПЛАВАТЬ | Продолжительность маршрута с учетом дорожной ситуации |
| статическая_продолжительность_в_секундах | ОБНУЛЯЕМЫЙ | ПЛАВАТЬ | Продолжительность маршрута без учета дорожного движения |
| геометрия_маршрута | ОБНУЛЯЕМЫЙ | ГЕОГРАФИЯ | Полилинейная геометрия маршрута с учетом дорожного движения |
Поведение и факты таблиц
- Таблица разделена по дням, и для каждого раздела установлен срок действия 10 лет.
- Таблица обновляется каждый час последними данными о дорожном движении, записанными в пакетном режиме.
- После создания нового маршрута в API выбора дорог вам придется подождать до 1 часа, прежде чем данные появятся в этой таблице.
- После удаления маршрута из API выбора дорог новые данные по нему в эту таблицу не записываются. Однако исторические данные сохраняются до истечения срока действия.
таблица recent_roads_data
Примечание : эта таблица доступна только в том случае, если ваш контракт включает данные о дорогах в режиме реального времени .
В отличие от historical_travel_time , эта таблица также содержит данные SpeedReadingInterval . Вот схема в BigQuery:
| Имя | Режим | Тип | Описание |
|---|---|---|---|
| selected_route_id | ОБНУЛЯЕМЫЙ | НИТЬ | selected_route_id маршрута |
| отображаемое имя | ОБНУЛЯЕМЫЙ | НИТЬ | Отображаемое название маршрута |
| время_записи | ОБНУЛЯЕМЫЙ | МЕТКА ВРЕМЕНИ | Метка времени, когда вычисляются данные маршрута |
| длительность_в_секундах | ОБНУЛЯЕМЫЙ | ПЛАВАТЬ | Продолжительность маршрута с учетом дорожной ситуации |
| статическая_продолжительность_в_секундах | ОБНУЛЯЕМЫЙ | ПЛАВАТЬ | Продолжительность маршрута без учета дорожного движения |
| геометрия_маршрута | ОБНУЛЯЕМЫЙ | ГЕОГРАФИЯ | Полилинейная геометрия маршрута с учетом дорожного движения |
| интервалы_скорости_чтения | ПОВТОРЕННЫЙ | ЗАПИСЫВАТЬ | Интервалы, отображающие плотность движения на маршруте. См. оригинальное определение в Routes API. |
| интервалы_чтения_скорости.координаты_интервала | ПОВТОРЕННЫЙ | ГЕОГРАФИЯ | Геометрия для этого интервала |
| интервалы_чтения_скорости.скорость | ОБНУЛЯЕМЫЙ | НИТЬ | Классификация скорости для данного интервала. Возможные значения: NORMAL, SLOW, TRAFFIC_JAM. |
Поведение и факты таблиц
- Таблица разделена по дням, и для каждого раздела установлен срок действия 60 дней.
- Таблица обновляется каждый час последними данными о дорожном движении, записанными в пакетном режиме.
- После создания нового маршрута в API выбора дорог вам придется подождать до 1 часа, прежде чем данные появятся в этой таблице.
- После удаления маршрута из API выбора дорог новые данные по нему в эту таблицу записываться не будут. Однако исторические данные сохраняются до истечения срока действия.
таблица routes_status
Таблица содержит метаданные и информацию о статусе выбранных маршрутов. Она предназначена для упрощения просмотра всех маршрутов и их статусов. Её можно объединить с двумя другими таблицами для фильтрации данных. Вот схема в BigQuery:
| Имя | Режим | Тип | Описание |
|---|---|---|---|
| selected_route_id | ОБНУЛЯЕМЫЙ | НИТЬ | selected_route_id маршрута |
| отображаемое имя | ОБНУЛЯЕМЫЙ | НИТЬ | Отображаемое название маршрута |
| статус | ОБНУЛЯЕМЫЙ | НИТЬ | Статус маршрута |
| ошибка_проверки | ОБНУЛЯЕМЫЙ | НИТЬ | Ошибка проверки маршрута |
| low_road_usage_start_time | ОБНУЛЯЕМЫЙ | МЕТКА ВРЕМЕНИ | Время, когда на маршруте впервые было зафиксировано низкое использование дорог во время повторной проверки. Оно связано с ошибкой VALIDATION_ERROR_LOW_ROAD_USAGE. |
| атрибуты_маршрута | ОБНУЛЯЕМЫЙ | НИТЬ | Пользовательские атрибуты для выбранного маршрута |
Поведение и факты таблиц
- В эту таблицу включены только маршруты со статусом STATE_RUNNING или STATE_INVALID.
- Метаданные и статус маршрутов обновляются каждый час, непрерывно.
- После создания нового маршрута в API выбора дорог вам придется подождать до 1 часа, прежде чем маршрут появится в этой таблице.
- После удаления маршрута из API выбора дорог вам придется подождать до 1 часа, прежде чем выбранный маршрут будет удален из этой таблицы.