生成视频元数据（静态） (影像分析工具)

汇总

根据不含元数据的预录制视频创建支持地理空间的视频文件。遥测数据是通过水平视域、位置、远距离和视频开始时间等额外信息生成的。

用法

此工具适用于存档的视频文件，不适用于实时视频流。

下表列出了支持作为工具输入的视频格式：


描述	扩展名
AOMedia Video 1 文件	`.av1`
音频视频交错格式	`.avi`
HLS（自适应比特率 (ABR)）	`.m3u8`
MOV 文件	`.mov`
MPEG-2 传输流	`.ts`
MPEG-2 程序流	`.ps`
M2TS 传输流	`.m2ts`
MPEG 文件	`.mpg`
MPEG-2 文件	`.mpg2`
MPEG-2 文件	`.mp2`
MPEG 文件	`.mpeg`
MPEG-4 影片	`.mp4`
MPEG-4 文件	`.mpg4`
MPEG-Dash	`.mpd`
VLC (mpeg2)	`.mpeg2`
VLC 媒体文件 (mpeg4)	`.mpeg4`
VLC 媒体文件 (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)

环境

此工具不使用任何地理处理环境。

许可信息

基本: 需要 Image Analyst
标准: 需要 Image Analyst
高级: 需要 Image Analyst

生成视频元数据（静态） (影像分析工具)

汇总

用法

参数

环境

许可信息

相关主题