Создать метаданные видео (Стационарный) (Инструменты Image Analyst)

Краткая информация

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

Использование

— Этот инструмент предназначен для архивных видеофайлов и не работает с потоковым видео в реальном времени.

Форматы видео, поддерживаемые в качестве входных данных для инструмента, перечислены в следующей таблице:


Описание	Расширение
Файл AOMedia Video 1	`.av1`
Audio Video Interleaved	`.avi`
HLS (Адаптивная скорость передачи данных (ABR))	`.m3u8`
Файл MOV	`.mov`
MPEG-2 Transport Stream	`.ts`
MPEG-2 Program Stream	`.ps`
M2TS Transport Stream	`.m2ts`
Файл MPEG	`.mpg`
Файл MPEG-2	`.mpg2`
Файл MPEG-2	`.mp2`
Файл MPEG	`.mpeg`
MPEG-4 Movie	`.mp4`
Файл MPEG-4	`.mpg4`
MPEG-Dash	`.mpd`
VLC (mpeg2)	`.mpeg2`
Файл VLC Media (mpeg4)	`.mpeg4`
Файл VLC Media (vob)	`.vob`
Файл Windows Media Video	`.wmv`

Чтобы вычислить и показать соответствующие угловые точки рамки кадра видео в виде контура кадра на карте, нужна информация о метаданных, которые указаны ниже с деталями в описании параметров. Если метаданные заполнены точно и полностью, инструмент вычислит углы кадра видео, размер, форму и расположение контура кадра видео, которое затем может быть показано на карте.

— Временная отметка

— Местоположение сенсора

— Угол относительной высоты сенсора (наклон)

— Угол относительного азимута

— Горизонтальное поле зрения

— Вертикальное поле зрения

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

— Производительность получаемого мультиплексированного видеофайла зависит от типа и качества информации о входном инструменте.

— Если единственные доступные данные для параметров инструмента — Start Time и Sensor Location, местоположения будут отображаться на карте, но контуров не будет. Некоторая функциональность, например, оцифровка объектов и измерение расстояния в видео, не поддерживается.

Подпись	Объяснение	Тип данных
Входной файл видео	Входной видеофайл, для которого будут генерироваться метаданные и преобразованы в геопространственный видеофайл. Поддерживаются следующие типы файлов: `.av1,`, `.avi`, `.h264`, `.h265`, `.mkv`, `.mov`, `.mp2`, `.mp4`, `.mpeg`, `.mpeg2`, `.mpeg4`, `.mpg`, `.mpg2`, `.mpg4`, `.ps`, `.ts`, `.vob` и `.wmv`.	File
Выходной видео файл	Имя выходного видео файла включает расширение файла (`.ts`).	File
Местоположение сенсора	Точечная функция, определяющая географическое положение сенсора.	Feature Layer
Время начала	Временная метка, связанная с первым кадром видео. Временная метка будет использоваться для выравнивания видеокадров с временными и пространственными данными.	Date
Выходной файл метаданных (Дополнительный)	Имя выходного видео файла включает расширение файла (`.csv`).	File
Наклон (Дополнительный)	Вертикальный угол в градусах между направлением сенсора и горизонтальной плоскостью. Положительные значения указывают на наклон вверх; Отрицательные — на наклон вниз.	Double
Относительный азимут (Дополнительный)	Горизонтальный угол сенсора измерялся по часовой стрелке от истинного севера.	Double
Горизонтальное поле зрения (Дополнительный)	Общая горизонтальная угловая площадь обзора сенсора, измеряемая в градусах.	Double
Вертикальное поле зрения (Дополнительный)	Общая вертикальная угловая площадь обзора сенсора, измеряемая в градусах.	Double
Дальность (Дополнительный)	Максимальный диапазон от сенсора до дальнего предела поля зрения.	Linear Unit

GenerateVideoMetadataStationary(in_video_file, out_video_file, sensor_location, start_time, {out_metadata_file}, {tilt}, {azimuth}, {horizontal_fov}, {vertical_fov}, {far_distance})

Имя	Объяснение	Тип данных
in_video_file	Входной видеофайл, для которого будут генерироваться метаданные и преобразованы в геопространственный видеофайл. Поддерживаются следующие типы файлов: `.av1,`, `.avi`, `.h264`, `.h265`, `.mkv`, `.mov`, `.mp2`, `.mp4`, `.mpeg`, `.mpeg2`, `.mpeg4`, `.mpg`, `.mpg2`, `.mpg4`, `.ps`, `.ts`, `.vob` и `.wmv`.	File
out_video_file	Имя выходного видео файла включает расширение файла (`.ts`).	File
sensor_location	Точечная функция, определяющая географическое положение сенсора.	Feature Layer
start_time	Временная метка, связанная с первым кадром видео. Временная метка будет использоваться для выравнивания видеокадров с временными и пространственными данными.	Date
out_metadata_file (Дополнительный)	Имя выходного видео файла включает расширение файла (`.csv`).	File
tilt (Дополнительный)	Вертикальный угол в градусах между направлением сенсора и горизонтальной плоскостью. Положительные значения указывают на наклон вверх; Отрицательные — на наклон вниз.	Double
azimuth (Дополнительный)	Горизонтальный угол сенсора измерялся по часовой стрелке от истинного севера.	Double
horizontal_fov (Дополнительный)	Общая горизонтальная угловая площадь обзора сенсора, измеряемая в градусах.	Double
vertical_fov (Дополнительный)	Общая вертикальная угловая площадь обзора сенсора, измеряемая в градусах.	Double
far_distance (Дополнительный)	Максимальный диапазон от сенсора до дальнего предела поля зрения.	Linear Unit

Пример кода

GenerateVideoMetadataStationary, пример 1 (окно Python)

Этот пример создаёт видеофайл с геопространственной информацией для стационарного сенсора.

import arcpy
arcpy.env.workspace = "C:/iapyexamples/data"

arcpy.ia.GenerateVideoMetadataStationary(r"C:\\test\\camera_vid.MP4", 
                                         r"C:\\test\\video_export.ts",
                                         r"Generate Video Metadata (Stationary) Sensor Location (Points)",
                                         r"12/30/2025 1:48:58 PM", r"C:\\test\\metadata_export.csv",
                                         -10, 270, 45, 45, "250 Meters")

GenerateVideoMetadataStationary, пример 2 (автономный скрипт)

Этот пример создаёт видеофайл с геопространственной информацией для стационарного сенсора.

# Name: GenerateVideoMetadata_sample2.py
# Description: Creates a geospatially enabled video file from a 
#              pre-recorded video without metadata. The telemetry 
#              data is generated using user input information 
#              such as horizontal field of view, location, far 
#              distance and video start time.
# Requirements: Image Analyst extension

# Import system modules
import arcpy

# Set local variables
in_video_file = "C:\\test\\camera_vid.MP4"
out_video_file = "C:\\test\\video_export.ts"
sensor_location = "Generate Video Metadata (Stationary) Sensor Location (Points)"
start_time = "12/30/2025 1:48:58 PM"
out_metadata_file = "C:\\test\\metadata_export.csv"
tilt = -10
azimuth = 270
horizontal_fov = 45
vertical_fov = 45
far_distance = "250 Meters"

# Run Generate Video Metadata
arcpy.ia.GenerateVideoMetadataStationary(in_video_file, out_video_file, sensor_location,
                                         start_time, out_metadata_file, tilt, azimuth, 
                                         horizontal_fov, vertical_fov, far_distance)

Параметры среды

Этот инструмент не использует параметры среды геообработки.

Информация о лицензировании