Generar metadatos de vídeo (estáticos) (Herramientas de Image Analyst)

Resumen

Crea un archivo de vídeo habilitado geoespacialmente a partir de un vídeo pregrabado sin metadatos. Los datos de telemetría se generan utilizando información adicional como el campo de visión horizontal, la ubicación, la distancia lejana y la hora de inicio del vídeo.

Uso

Esta herramienta se ha diseñado para archivos de vídeo archivados y no funciona con transmisiones de vídeo en directo.

Los formatos de vídeo admitidos como entrada de la herramienta figuran en la tabla siguiente:


Descripción	Extensión
Archivo de vídeo 1 AOMedia	`.av1`
Archivo intercalado de audio y vídeo	`.avi`
HLS (velocidad de bits adaptable [ABR])	`.m3u8`
Archivo MOV	`.mov`
Flujo de transmisión de MPEG-2	`.ts`
Flujo de programa de MPEG-2	`.ps`
Flujo de transmisión de M2TS	`.m2ts`
Archivo MPEG	`.mpg`
Archivo MPEG-2	`.mpg2`
Archivo MPEG-2	`.mp2`
Archivo MPEG	`.mpeg`
Película MPEG-4	`.mp4`
Archivo MPEG-4	`.mpg4`
MPEG-Dash	`.mpd`
VLC (mpeg2)	`.mpeg2`
Archivo de medios VLC (mpeg4)	`.mpeg4`
Archivo de medios VLC (vob)	`.vob`
Archivo de vídeo multimedia de Windows	`.wmv`

Para calcular y visualizar los puntos de esquina relativos de la huella de la imagen de vídeo como un contorno de cuadro en el mapa, necesita la información de metadatos esenciales que se indican a continuación y se detallan en la descripción del parámetro. Cuando los metadatos sean completos y precisos, la herramienta calculará las esquinas del cuadro de vídeo y el tamaño, la forma y la posición del contorno del cuadro de vídeo que puede visualizarse a continuación en un mapa.

Marca de hora
Ubicación del sensor
Ángulo de elevación relativa del sensor (inclinación)
Ángulo azimutal relativo
Campo de visión horizontal
Campo de visión vertical

Estos son los metadatos mínimos necesarios para calcular la transformación entre vídeo y mapa, mostrar la huella de vídeo en el mapa y habilitar otras funciones, como digitalizar y marcar en el vídeo y el mapa.

El rendimiento del archivo de vídeo multiplexado resultante depende del tipo y la calidad de la información de la herramienta de entrada.
- Si los únicos datos disponibles para los parámetros de la herramienta son Start Time y Sensor Location, la ubicación aparecerá en el mapa, pero no habrá huellas. Algunas funcionalidades no se admitirán, por ejemplo, la digitalización de entidades y la medición de distancias en el vídeo.

Etiqueta	Explicación	Tipo de datos
Archivo de vídeo de entrada	Archivo de vídeo de entrada para el que se generarán metadatos y se convertirá en un archivo de vídeo geoespacial. Los siguientes tipos de archivo son compatibles: `.av1,` `.avi`, `.h264`, `.h265`, `.mkv`, `.mov`, `.mp2`, `.mp4`, `.mpeg`, `.mpeg2`, `.mpeg4`, `.mpg`, `.mpg2`, `.mpg4`, `.ps`, `.ts`, `.vob` y `.wmv`.	File
Archivo de video de salida	Nombre del archivo de vídeo de salida (`.ts`), incluida la extensión del archivo.	File
Ubicación del sensor	Entidad de punto que identifica la posición geográfica del sensor.	Feature Layer
Hora de inicio	Marca de tiempo asociada al primer fotograma del vídeo. La marca de tiempo se utilizará para alinear los fotogramas del vídeo con los datos temporales y espaciales.	Date
Archivo de metadatos de salida (Opcional)	Nombre del archivo de metadatos de salida (`.csv`), incluida la extensión del archivo.	File
Inclinación (Opcional)	Ángulo vertical, en grados, entre la dirección en que se apunta el sensor y el plano horizontal. Los valores positivos indican una inclinación hacia arriba; los valores negativos indican una inclinación hacia abajo.	Double
Acimut relativo (Opcional)	Ángulo horizontal del sensor medido en el sentido de las agujas del reloj desde el norte verdadero.	Double
Campo horizontal de visión (Opcional)	Extensión angular horizontal total de la vista del sensor, medida en grados.	Double
Campo de visión vertical (Opcional)	Extensión angular vertical total de la vista del sensor, medida en grados.	Double
Distancia lejana (Opcional)	Alcance máximo desde el sensor hasta el límite más lejano del campo de visión.	Linear Unit

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

Nombre	Explicación	Tipo de datos
in_video_file	Archivo de vídeo de entrada para el que se generarán metadatos y se convertirá en un archivo de vídeo geoespacial. Los siguientes tipos de archivo son compatibles: `.av1,` `.avi`, `.h264`, `.h265`, `.mkv`, `.mov`, `.mp2`, `.mp4`, `.mpeg`, `.mpeg2`, `.mpeg4`, `.mpg`, `.mpg2`, `.mpg4`, `.ps`, `.ts`, `.vob` y `.wmv`.	File
out_video_file	Nombre del archivo de vídeo de salida (`.ts`), incluida la extensión del archivo.	File
sensor_location	Entidad de punto que identifica la posición geográfica del sensor.	Feature Layer
start_time	Marca de tiempo asociada al primer fotograma del vídeo. La marca de tiempo se utilizará para alinear los fotogramas del vídeo con los datos temporales y espaciales.	Date
out_metadata_file (Opcional)	Nombre del archivo de metadatos de salida (`.csv`), incluida la extensión del archivo.	File
tilt (Opcional)	Ángulo vertical, en grados, entre la dirección en que se apunta el sensor y el plano horizontal. Los valores positivos indican una inclinación hacia arriba; los valores negativos indican una inclinación hacia abajo.	Double
azimuth (Opcional)	Ángulo horizontal del sensor medido en el sentido de las agujas del reloj desde el norte verdadero.	Double
horizontal_fov (Opcional)	Extensión angular horizontal total de la vista del sensor, medida en grados.	Double
vertical_fov (Opcional)	Extensión angular vertical total de la vista del sensor, medida en grados.	Double
far_distance (Opcional)	Alcance máximo desde el sensor hasta el límite más lejano del campo de visión.	Linear Unit

Muestra de código

Ejemplo 1 de GenerateVideoMetadataStationary (ventana en Python)

Este ejemplo crea un archivo de vídeo con información geoespacial para un sensor estacionario.

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")

Ejemplo 2 de GenerateVideoMetadataStationary (script independiente)

Este ejemplo crea un archivo de vídeo con información geoespacial para un sensor estacionario.

# 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)

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.

Información de licenciamiento

Basic: Requiere Image Analyst
Standard: Requiere Image Analyst
Avanzado: Requiere Image Analyst

Generar metadatos de vídeo (estáticos) (Herramientas de Image Analyst)

Resumen

Uso

Parámetros

Entornos

Información de licenciamiento

Temas relacionados