Справочные материалы

На этой странице вы найдете руководство по таблицам BigQuery, которые используются для обучения моделей, в том числе их схемы и описания полей. Вы также узнаете, как устроены данные, и познакомитесь с основными понятиями, такими как снимки, объекты и наблюдения. Кроме того, мы расскажем, как использовать таблицы.

Названия таблиц начинаются с префикса, указывающего на тип товара (cropped_, full_frame_ или pano_). В наборе данных будут только таблицы для продуктов, включенных в ваши подписки. Таблицы, названия которых заканчиваются на _all, содержат данные из всех снимков, а таблицы, названия которых заканчиваются на _latest, – только из последнего снимка.

Основные понятия

  • Снимок. Фиксированная, неизменяемая копия набора данных в определенный момент времени.
  • Объект. Объект в реальном мире, например дорожный знак или столб. Объекты доступны для обрезанных и полнокадровых товаров.
  • Наблюдение. Изображение, полученное в результате события съемки. Для кадрированных и полнокадровых продуктов наблюдение – это обнаружение объекта, которое содержит метаданные, такие как время съемки изображения и положение камеры. Для панорамных снимков наблюдение – это отдельный кадр круговой панорамы, не связанный с объектом.

snapshots

Снимок – это фиксированная, неизменяемая копия набора данных в определенный момент времени. Таблица снимков содержит метаданные, связанные со снимками, и позволяет получить общее представление о временном состоянии данных.

Название столбца Тип Описание
snapshot_id STRING Уникальный идентификатор снимка. Используется в качестве ключа для объединения таблиц.
subscription_id STRING Уникальный идентификатор подписки.
creation_time ВРЕМЕННЫЕ МЕТКИ Временная метка, указывающая, когда был создан снимок. Временная метка в формате ISO 8601, например 2019-09-25 17:26:27.757171 UTC.
product_types ARRAY<STRING> Типы товаров, связанные со снимком.
Допустимые значения: SV_CROPPED_ASSETS, SV_FULL_FRAME_ASSETS и SV_PANO.

cropped_observations_all

Таблица cropped_observations_all содержит наблюдения за обрезанными объектами из всех снимков. С помощью этой таблицы можно выявлять различия в наблюдениях между снимками.

Название столбца Тип Описание
snapshot_id STRING Уникальный идентификатор снимка, в котором было собрано это наблюдение.
asset_id STRING Уникальный идентификатор объекта, связанного с этим наблюдением.
asset_type STRING Основная классификация объекта.
Допустимые значения: ASSET_CLASS_ROAD_SIGN, ASSET_CLASS_UTILITY_POLE и ASSET_CLASS_MAINTENANCE_COVER.
location STRUCT Структура, содержащая координаты широты и долготы в виде чисел с плавающей запятой. Место, где было сделано наблюдение.
detection_time ВРЕМЕННЫЕ МЕТКИ Последнее наблюдение capture_time для указанного объекта. Временная метка в формате ISO 8601, например 2019-09-25 17:26:27.757171 UTC.
observation_id STRING Строка, которая уникальным образом идентифицирует наблюдение.
bbox STRUCT Структура структур, содержащая координаты x/y, выравнивающие граничную рамку объекта.
camera_pose STRUCT Положение камеры (широта, долгота, высота) и углы Эйлера. Структура, содержащая числа с плавающей запятой для широты/долготы, высоты (в метрах), тангажа, курса и крена (в градусах).
capture_time ВРЕМЕННЫЕ МЕТКИ Временная метка, указывающая, когда было зафиксировано наблюдение. Временная метка в формате ISO 8601, например 2019-09-25 17:26:27.757171 UTC.
pano_id STRING Уникальный идентификатор панорамного изображения с углом обзора 360 градусов. Это значение может быть нулевым или отсутствовать. Если он есть, его можно использовать в качестве ключа доступа с Google Maps Street View Static API.
gcs_uri STRING URI Google Cloud Storage, где размещено изображение.
map_url STRING URL Google Карт, на которых показано местоположение объекта.

cropped_assets_all

В таблице cropped_assets_all содержатся кадрированные объекты из всех снимков. С помощью этой таблицы можно выявлять различия в объектах между снимками.

Название столбца Тип Описание
asset_id STRING Уникальный идентификатор объекта.
snapshot_id STRING Уникальный идентификатор снимка, в котором был собран этот объект.
asset_type STRING Основная классификация объекта.
Допустимые значения: ASSET_CLASS_ROAD_SIGN, ASSET_CLASS_UTILITY_POLE и ASSET_CLASS_MAINTENANCE_COVER.
location STRUCT Структура, содержащая координаты широты и долготы в виде чисел с плавающей запятой, которые представляют приблизительное местоположение объекта.
detection_time ВРЕМЕННЫЕ МЕТКИ Последнее наблюдение capture_time для указанного объекта. Временная метка в формате ISO 8601, например 2019-09-25 17:26:27.757171 UTC.

cropped_observations_latest

Таблица cropped_observations_latest содержит наблюдения за обрезанными объектами только из последнего снимка.

Название столбца Тип Описание
snapshot_id STRING Уникальный идентификатор снимка, в котором было собрано это наблюдение.
asset_id STRING Уникальный идентификатор объекта, связанного с этим наблюдением.
asset_type STRING Основная классификация объекта.
Допустимые значения: ASSET_CLASS_ROAD_SIGN, ASSET_CLASS_UTILITY_POLE и ASSET_CLASS_MAINTENANCE_COVER.
location STRUCT Структура, содержащая координаты широты и долготы в виде чисел с плавающей запятой. Место, где было сделано наблюдение.
detection_time ВРЕМЕННЫЕ МЕТКИ Последнее наблюдение capture_time для указанного объекта. Временная метка в формате ISO 8601, например 2019-09-25 17:26:27.757171 UTC.
observation_id STRING Строка, которая уникальным образом идентифицирует наблюдение.
bbox STRUCT Структура структур, содержащая координаты x/y, выравнивающие граничную рамку объекта.
camera_pose STRUCT Положение камеры (широта, долгота, высота) и углы Эйлера. Структура, содержащая числа с плавающей запятой для широты/долготы, высоты (в метрах), тангажа, курса и крена (в градусах).
capture_time ВРЕМЕННЫЕ МЕТКИ Временная метка, указывающая, когда было зафиксировано наблюдение. Временная метка в формате ISO 8601, например 2019-09-25 17:26:27.757171 UTC.
pano_id STRING Уникальный идентификатор панорамного изображения с углом обзора 360 градусов. Это значение может быть нулевым или отсутствовать. Если он есть, его можно использовать в качестве ключа доступа с Google Maps Street View Static API.
gcs_uri STRING URI Google Cloud Storage, где размещено изображение.
map_url STRING URL Google Карт, на которых показано местоположение объекта.

cropped_assets_latest

В таблице cropped_assets_latest представлены только кадрированные объекты из последнего снимка.

Название столбца Тип Описание
asset_id STRING Уникальный идентификатор объекта.
snapshot_id STRING Уникальный идентификатор снимка, в котором был собран этот объект.
asset_type STRING Основная классификация объекта.
Допустимые значения: ASSET_CLASS_ROAD_SIGN, ASSET_CLASS_UTILITY_POLE и ASSET_CLASS_MAINTENANCE_COVER.
location STRUCT Структура, содержащая координаты широты и долготы в виде чисел с плавающей запятой, которые представляют приблизительное местоположение объекта.
detection_time ВРЕМЕННЫЕ МЕТКИ Последнее наблюдение capture_time для указанного объекта. Временная метка в формате ISO 8601, например 2019-09-25 17:26:27.757171 UTC.

full_frame_observations_all

Таблица full_frame_observations_all содержит наблюдения за объектами в полном кадре (без кадрирования) из всех снимков. С помощью этой таблицы можно выявлять различия в наблюдениях между снимками.

Название столбца Тип Описание
snapshot_id STRING Уникальный идентификатор снимка, в котором было собрано это наблюдение.
asset_id STRING Уникальный идентификатор объекта, связанного с этим наблюдением.
asset_type STRING Основная классификация объекта.
Допустимые значения: ASSET_CLASS_ROAD_SIGN, ASSET_CLASS_UTILITY_POLE и ASSET_CLASS_MAINTENANCE_COVER.
location STRUCT Структура, содержащая координаты широты и долготы в виде чисел с плавающей запятой. Место, где было сделано наблюдение.
detection_time ВРЕМЕННЫЕ МЕТКИ Последнее наблюдение capture_time для указанного объекта. Временная метка в формате ISO 8601, например 2019-09-25 17:26:27.757171 UTC.
observation_id STRING Строка, которая уникальным образом идентифицирует наблюдение.
bbox STRUCT Структура структур, содержащая координаты x/y, выравнивающие граничную рамку объекта.
camera_pose STRUCT Положение камеры (широта, долгота, высота) и углы Эйлера. Структура, содержащая числа с плавающей запятой для широты/долготы, высоты (в метрах), тангажа, курса и крена (в градусах).
capture_time ВРЕМЕННЫЕ МЕТКИ Временная метка, указывающая, когда было зафиксировано наблюдение. Временная метка в формате ISO 8601, например 2019-09-25 17:26:27.757171 UTC.
pano_id STRING Уникальный идентификатор панорамного изображения с углом обзора 360 градусов. Это значение может быть нулевым или отсутствовать. Если он есть, его можно использовать в качестве ключа доступа с Google Maps Street View Static API.
gcs_uri STRING URI Google Cloud Storage, где размещено изображение.
map_url STRING URL Google Карт, на которых показано местоположение объекта.

full_frame_assets_all

Таблица full_frame_assets_all содержит полнокадровые (необрезанные) объекты из всех снимков. С помощью этой таблицы можно выявлять различия в объектах между снимками.

Название столбца Тип Описание
asset_id STRING Уникальный идентификатор объекта.
snapshot_id STRING Уникальный идентификатор снимка, в котором был собран этот объект.
asset_type STRING Основная классификация объекта.
Допустимые значения: ASSET_CLASS_ROAD_SIGN, ASSET_CLASS_UTILITY_POLE и ASSET_CLASS_MAINTENANCE_COVER.
location STRUCT Структура, содержащая координаты широты и долготы в виде чисел с плавающей запятой, которые представляют приблизительное местоположение объекта.
detection_time ВРЕМЕННЫЕ МЕТКИ Последнее наблюдение capture_time для указанного объекта. Временная метка в формате ISO 8601, например 2019-09-25 17:26:27.757171 UTC.

full_frame_observations_latest

В таблице full_frame_observations_latest содержатся наблюдения за объектами в полнокадровом режиме (без кадрирования) только из последнего снимка.

Название столбца Тип Описание
snapshot_id STRING Уникальный идентификатор снимка, в котором было собрано это наблюдение.
asset_id STRING Уникальный идентификатор объекта, связанного с этим наблюдением.
asset_type STRING Основная классификация объекта.
Допустимые значения: ASSET_CLASS_ROAD_SIGN, ASSET_CLASS_UTILITY_POLE и ASSET_CLASS_MAINTENANCE_COVER.
location STRUCT Структура, содержащая координаты широты и долготы в виде чисел с плавающей запятой. Место, где было сделано наблюдение.
detection_time ВРЕМЕННЫЕ МЕТКИ Последнее наблюдение capture_time для указанного объекта. Временная метка в формате ISO 8601, например 2019-09-25 17:26:27.757171 UTC.
observation_id STRING Строка, которая уникальным образом идентифицирует наблюдение.
bbox STRUCT Структура структур, содержащая координаты x/y, выравнивающие граничную рамку объекта.
camera_pose STRUCT Положение камеры (широта, долгота, высота) и углы Эйлера. Структура, содержащая числа с плавающей запятой для широты/долготы, высоты (в метрах), тангажа, курса и крена (в градусах).
capture_time ВРЕМЕННЫЕ МЕТКИ Временная метка, указывающая, когда было зафиксировано наблюдение. Временная метка в формате ISO 8601, например 2019-09-25 17:26:27.757171 UTC.
pano_id STRING Уникальный идентификатор панорамного изображения с углом обзора 360 градусов. Это значение может быть нулевым или отсутствовать. Если он есть, его можно использовать в качестве ключа доступа с Google Maps Street View Static API.
gcs_uri STRING URI Google Cloud Storage, где размещено изображение.
map_url STRING URL Google Карт, на которых показано местоположение объекта.

full_frame_assets_latest

В таблице full_frame_assets_latest представлены только полнокадровые (необрезанные) объекты из последнего снимка.

Название столбца Тип Описание
asset_id STRING Уникальный идентификатор объекта.
snapshot_id STRING Уникальный идентификатор снимка, в котором был собран этот объект.
asset_type STRING Основная классификация объекта.
Допустимые значения: ASSET_CLASS_ROAD_SIGN, ASSET_CLASS_UTILITY_POLE и ASSET_CLASS_MAINTENANCE_COVER.
location STRUCT Структура, содержащая координаты широты и долготы в виде чисел с плавающей запятой, которые представляют приблизительное местоположение объекта.
detection_time ВРЕМЕННЫЕ МЕТКИ Последнее наблюдение capture_time для указанного объекта. Временная метка в формате ISO 8601, например 2019-09-25 17:26:27.757171 UTC.

pano_observations_all

Таблица pano_observations_all содержит панорамные наблюдения (полные сцены) из всех снимков. В отличие от наблюдений за объектами, панорамные наблюдения содержат метаданные камеры на уровне кадра и пространственную ориентацию для событий съемки на 360 градусов, а не локализованные обнаружения объектов. С помощью этой таблицы можно выявлять различия в панорамных наблюдениях между снимками.

Название столбца Тип Описание
capture_id STRING Уникальный идентификатор, представляющий одно событие панорамной съемки.
observation_id STRING Уникальный идентификатор отдельного кадра, который является частью панорамного снимка с углом обзора 360 градусов.
snapshot_id STRING Уникальный идентификатор снимка, в котором было собрано это наблюдение.
capture_location STRUCT Структура, содержащая координаты широты и долготы в виде чисел с плавающей запятой, представляющих центроид транспортного средства на момент наблюдения.
capture_time ВРЕМЕННЫЕ МЕТКИ Временная метка, указывающая, когда было зафиксировано наблюдение. Временная метка в формате ISO 8601, например 2019-09-25 17:26:27.757171 UTC.
camera_pose STRUCT Положение камеры (широта, долгота, высота) и углы Эйлера. Структура, содержащая числа с плавающей запятой для широты/долготы, высоты (в метрах), тангажа, курса и крена (в градусах).
gcs_uri STRING URI Google Cloud Storage, где размещено изображение.
map_url STRING URL Google Карт, на которых показано место съемки.
pano_id STRING Уникальный идентификатор панорамного изображения с углом обзора 360 градусов. Это значение может быть нулевым или отсутствовать. Если он есть, его можно использовать в качестве ключа доступа с Google Maps Street View Static API.

pano_observations_latest

Таблица pano_observations_latest содержит панорамные наблюдения (полная сцена) только из последнего снимка.

Название столбца Тип Описание
capture_id STRING Уникальный идентификатор, представляющий одно событие панорамной съемки.
observation_id STRING Уникальный идентификатор отдельного кадра, который является частью панорамного снимка с углом обзора 360 градусов.
snapshot_id STRING Уникальный идентификатор снимка, в котором было собрано это наблюдение.
capture_location STRUCT Структура, содержащая координаты широты и долготы в виде чисел с плавающей запятой, представляющих центроид транспортного средства на момент наблюдения.
capture_time ВРЕМЕННЫЕ МЕТКИ Временная метка, указывающая, когда было зафиксировано наблюдение. Временная метка в формате ISO 8601, например 2019-09-25 17:26:27.757171 UTC.
camera_pose STRUCT Положение камеры (широта, долгота, высота) и углы Эйлера. Структура, содержащая числа с плавающей запятой для широты/долготы, высоты (в метрах), тангажа, курса и крена (в градусах).
gcs_uri STRING URI Google Cloud Storage, где размещено изображение.
map_url STRING URL Google Карт, на которых показано место съемки.
pano_id STRING Уникальный идентификатор панорамного изображения с углом обзора 360 градусов. Это значение может быть нулевым или отсутствовать. Если он есть, его можно использовать в качестве ключа доступа с Google Maps Street View Static API.

Устаревшие таблицы