视频元数据至要素类 (Image Analyst)—ArcGIS Pro

摘要

可从兼容 FMV 的视频中提取平台、帧中心、帧轮廓和属性元数据。输出几何和属性将另存为要素类。

使用情况

该工具可将兼容 FMV 的视频元数据导出为要素类，并将所有元数据作为属性表中的字段。这些功能可用于传感器位置、视频帧轮廓和视频帧中心，以验证正确的数据覆盖范围、执行空间查询和执行属性查询，以快速查找感兴趣的视频帧。
该工具仅接受存档视频文件作为输入，而不接受实时视频流。
该工具要求使用兼容 FMV 的视频文件作为输入。如果视频不包含视频流中的元数据或者该流不包含元数据包，则该工具将失败。
该工具可以具有 4 种类型的输出，并且必须至少指定一种输出。如果所有 4 种输出均为空，则该工具将失败。

参数

标注	说明	数据类型
输入视频	兼容 FMV 的输入视频文件，其中包含视频数据每帧的基本元数据。受支持的视频文件类型包括 PS、TS、MPG、MPEG、MP2、MPG2、MPEG2、MP4、MPG4、MPEG4、H264、H265、VOB 和 M2TS。	File
输出元数据文件 (可选)	输出 .csv 或 .json 文件，其中包含有关特定时间的视频帧的元数据。元数据文件与视频多路复用器工具使用的格式相同。	File
输出飞行路径要素类 (可选)	要素类，其中包含传感器的飞行路径信息。	Feature Class
飞行路径要素类类型 (可选)	指定将用于飞行路径的要素类类型。点—将使用点要素类。折线—将使用折线要素类。这是默认设置。	String
输出图像路径要素类 (可选)	输出要素类，其中包含图像路径信息。	Feature Class
图像路径要素类类型 (可选)	指定将用于图像路径的要素类类型。如果您使用点输出，则每个视频帧图像的中心将显示在地图上。点—将使用点要素类。折线—将使用折线要素类。这是默认设置。	String
输出图像覆盖区要素类 (可选)	输出要素类，其中包含视频图像轨迹信息。	Feature Class
元数据捕获开始时间 (可选)	从视频开头的元数据记录开始时间。输入格式为 d.hh:mm:ss，默认开始时间为 0.00:00:00。此字段中不会使用元数据时间戳；将使用视频文件的时间。	Time Unit; Date
元数据捕获停止时间 (可选)	元数据记录结束时间。输入格式为 d.hh:mm:ss。如果未设置，则该值将默认为视频的结尾。此字段中不会使用元数据时间戳。	Time Unit; Date
要素之间的最小距离 (可选)	连续视频帧中要素之间的距离。如果留空，则将提取每个元数据要素并将其添加至要素类。	Linear Unit
要素之间的最短时间 (可选)	连续视频帧中要素之间的时间间隔。如果留空，则将提取每个元数据要素并将其添加至要素类。	Time Unit
输出 VMTI 要素数据集 (可选)	输出要素类，其中包含视频 VMTI 信息。	Feature Class

VideoMetadataToFeatureClass(in_video, {csv_file}, {flightpath}, {flightpath_type}, {imagepath}, {imagepath_type}, {footprint}, {start_time}, {stop_time}, {min_distance}, {min_time}, {vmti})

名称	说明	数据类型
in_video	兼容 FMV 的输入视频文件，其中包含视频数据每帧的基本元数据。受支持的视频文件类型包括 PS、TS、MPG、MPEG、MP2、MPG2、MPEG2、MP4、MPG4、MPEG4、H264、H265、VOB 和 M2TS。	File
csv_file (可选)	输出 .csv 或 .json 文件，其中包含有关特定时间的视频帧的元数据。元数据文件与视频多路复用器工具使用的格式相同。	File
flightpath (可选)	要素类，其中包含传感器的飞行路径信息。	Feature Class
flightpath_type (可选)	指定将用于飞行路径的要素类类型。 POINT—将使用点要素类。 POLYLINE—将使用折线要素类。这是默认设置。	String
imagepath (可选)	输出要素类，其中包含图像路径信息。	Feature Class
imagepath_type (可选)	指定将用于图像路径的要素类类型。如果您使用点输出，则每个视频帧图像的中心将显示在地图上。 POINT—将使用点要素类。 POLYLINE—将使用折线要素类。这是默认设置。	String
footprint (可选)	输出要素类，其中包含视频图像轨迹信息。	Feature Class
start_time (可选)	从视频开头的元数据记录开始时间。输入格式为 d.hh:mm:ss，默认开始时间为 0.00:00:00。此字段中不会使用元数据时间戳；将使用视频文件的时间。	Time Unit; Date
stop_time (可选)	元数据记录结束时间。输入格式为 d.hh:mm:ss。如果未设置，则该值将默认为视频的结尾。此字段中不会使用元数据时间戳。	Time Unit; Date
min_distance (可选)	连续视频帧中要素之间的距离。如果留空，则将提取每个元数据要素并将其添加至要素类。	Linear Unit
min_time (可选)	连续视频帧中要素之间的时间间隔。如果留空，则将提取每个元数据要素并将其添加至要素类。	Time Unit
vmti (可选)	输出要素类，其中包含视频 VMTI 信息。	Feature Class

代码示例

VideoMetadataToFeatureClass 示例 1（Python 窗口）

本示例将从兼容 FMV 的视频中提取并保存平台、帧中心、帧轮廓和属性元数据。

import arcpy
arcpy.ia.VideoMetadataToFeatureClass(
    r"C:\test\input_video.ts", r"C:\output\outmeta.csv",
    r"C:\test\meta.gdb\flight_path", "POLYLINE", r"C:\test\meta.gdb\image_path",
    "POINT", r"C:\test\meta.gdb\image_footprint")

VideoMetadataToFeatureClass 示例 2（独立脚本）

本示例将从兼容 FMV 的视频中提取并保存平台、帧中心、帧轮廓和属性元数据。

import arcpy

arcpy.CheckOutExtension("ImageAnalyst")

in_video = "c:\\test\\drone_vid.ts"
out_metadata = "c:\\output\\outmeta.csv"
flight_path = "C:\\test\\meta.gdb\\flight_path"
flight_path_type = "POLYLINE"
image_path = "C:\\test\\meta.gdb\\image_path"
image_path_type = "POINT"
image_footprint = "C:\\test\\meta.gdb\\image_footprint"
start_time = "1 Seconds"
stop_time = "60 Seconds"
distance_between = "2 Meters"
min_time_between = "20 Seconds"

arcpy.ia.VideoMetadataToFeatureClass(
    in_video, out_metadata, flight_path, flight_path_type, image_path,
    image_path_type, image_footprint, start_time, stop_time, distance_between,
    min_time_between)

环境

输出包含 Z 值

许可信息

Basic: 需要 Image Analyst
Standard: 需要 Image Analyst
Advanced: 需要 Image Analyst

摘要

使用情况

参数

代码示例

环境

许可信息

相关主题

在本主题中