Videometadaten generieren (Stationär) (Image Analyst Tools)

Zusammenfassung

Erstellt eine räumlich aktivierte Videodatei aus einem voraufgezeichneten Video ohne Metadaten. Die Telemetriedaten werden mithilfe zusätzlicher Informationen wie horizontalem Sichtfeld, Ort, weiter Entfernung und Startzeit des Videos generiert.

Verwendung

Dieses Werkzeug ist für archivierte Videodateien konzipiert und funktioniert nicht bei Live-Video-Streams.

Die als Eingabe für das Werkzeug unterstützten Videoformate sind in der folgenden Tabelle aufgeführt:


Beschreibung	Erweiterung
AOMedia Video 1-Datei	`.av1`
Audio Video Interleaved	`.avi`
HLS (Adaptive Bitrate [ABR])	`.m3u8`
MOV-Datei	`.mov`
MPEG-2-Transportstrom	`.ts`
MPEG-2-Programmstrom	`.ps`
M2TS-Transportstrom	`.m2ts`
MPEG-Datei	`.mpg`
MPEG-2-Datei	`.mpg2`
MPEG-2-Datei	`.mp2`
MPEG-Datei	`.mpeg`
MPEG-4-Film	`.mp4`
MPEG-4-Datei	`.mpg4`
MPEG-DASH	`.mpd`
VLC (mpeg2)	`.mpeg2`
VLC-Mediendatei (mpeg4)	`.mpeg4`
VLC-Mediendatei (vob)	`.vob`
Windows-Medien-Videodatei	`.wmv`

Um die relativen Eckpunkte des Videobild-Footprints zu berechnen und als Bildumriss auf der Karte anzuzeigen, benötigen Sie die essenziellen Metadateninformationen, die unten aufgeführt sind und in der Parameterbeschreibung näher erläutert werden. Wenn die Metadaten vollständig und genau sind, berechnet das Werkzeug die Ecken des Videobildes und die Größe, Form und Position des Videobildumrisses, der dann auf einer Karte angezeigt werden kann.

Zeitstempel
Sensorposition
Relativer Höhenwinkel des Sensors (Neigen)
Relativer Azimutwinkel
Horizontaler sichtbarer Bereich
Vertikaler sichtbarer Bereich

Dies sind die minimalen Metadaten, die erforderlich sind, um die Transformation zwischen Video und Karte zu berechnen, den Video-Footprint auf der Karte anzuzeigen und andere Funktionen wie die Digitalisierung und Markierung auf dem Video und der Karte zu ermöglichen.

Die Leistung der resultierenden Multiplexing-Videodatei hängt vom Typ und von der Qualität der Informationen des Werkzeugs für die Eingabe ab.
- Wenn als Werkzeugparameter nur Start Time und Sensor Location verfügbar sind, wird die Position auf der Karte angezeigt, es werden jedoch keine Footprints angezeigt. Einige Funktionen, wie z. B. die Digitalisierung von Features und die Messung von Entfernungen im Video, werden nicht unterstützt.

Beschriftung	Erläuterung	Datentyp
Eingabe-Videodatei	Die Eingabe-Videodatei, für die Metadaten generiert werden und die in eine räumliche Videodatei konvertiert wird. Die folgenden Dateitypen werden unterstützt: `.av1,` `.avi`, `.h264`, `.h265`, `.mkv`, `.mov`, `.mp2`, `.mp4`, `.mpeg`, `.mpeg2`, `.mpeg4`, `.mpg`, `.mpg2`, `.mpg4`, `.ps`, `.ts`, `.vob` und `.wmv`.	File
Ausgabe-Videodatei	Der Name der Ausgabe-Videodatei (`.ts`), einschließlich Dateierweiterung.	File
Sensorposition	Das Punkt-Feature, das die geographische Position des Sensors angibt.	Feature Layer
Startzeit	Der Zeitstempel, der mit dem ersten Bild des Videos verknüpft ist. Der Zeitstempel wird verwendet, um Videobilder mit zeitlichen und räumlichen Daten abzugleichen.	Date
Ausgabe-Metadatendatei (Optional)	Der Name der Ausgabe-Metadatendatei (`.csv`), einschließlich der Dateierweiterung.	File
Neigung (Optional)	Der vertikale Winkel in Grad zwischen der Ausrichtung der Sensorrichtung und der horizontalen Ebene. Positive Werte weisen auf eine Neigung nach oben hin, negative Werte auf eine Neigung nach unten.	Double
Relativer Azimuth (Optional)	Der horizontale Winkel des Sensors wird im Uhrzeigersinn von geographisch Nord gemessen.	Double
Horizontaler sichtbarer Bereich (Optional)	Die gesamte horizontale Winkelausdehnung der Sensor-Ansicht, gemessen in Grad.	Double
Vertikaler sichtbarer Bereich (Optional)	Die gesamte vertikale Winkelausdehnung der Sensor-Ansicht, gemessen in Grad.	Double
Maximale Sensordistanz (Optional)	Die maximale Reichweite vom Sensor bis zur äußersten Grenze des sichtbaren Bereichs.	Linear Unit

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

Name	Erläuterung	Datentyp
in_video_file	Die Eingabe-Videodatei, für die Metadaten generiert werden und die in eine räumliche Videodatei konvertiert wird. Die folgenden Dateitypen werden unterstützt: `.av1,` `.avi`, `.h264`, `.h265`, `.mkv`, `.mov`, `.mp2`, `.mp4`, `.mpeg`, `.mpeg2`, `.mpeg4`, `.mpg`, `.mpg2`, `.mpg4`, `.ps`, `.ts`, `.vob` und `.wmv`.	File
out_video_file	Der Name der Ausgabe-Videodatei (`.ts`), einschließlich Dateierweiterung.	File
sensor_location	Das Punkt-Feature, das die geographische Position des Sensors angibt.	Feature Layer
start_time	Der Zeitstempel, der mit dem ersten Bild des Videos verknüpft ist. Der Zeitstempel wird verwendet, um Videobilder mit zeitlichen und räumlichen Daten abzugleichen.	Date
out_metadata_file (Optional)	Der Name der Ausgabe-Metadatendatei (`.csv`), einschließlich der Dateierweiterung.	File
tilt (Optional)	Der vertikale Winkel in Grad zwischen der Ausrichtung der Sensorrichtung und der horizontalen Ebene. Positive Werte weisen auf eine Neigung nach oben hin, negative Werte auf eine Neigung nach unten.	Double
azimuth (Optional)	Der horizontale Winkel des Sensors wird im Uhrzeigersinn von geographisch Nord gemessen.	Double
horizontal_fov (Optional)	Die gesamte horizontale Winkelausdehnung der Sensor-Ansicht, gemessen in Grad.	Double
vertical_fov (Optional)	Die gesamte vertikale Winkelausdehnung der Sensor-Ansicht, gemessen in Grad.	Double
far_distance (Optional)	Die maximale Reichweite vom Sensor bis zur äußersten Grenze des sichtbaren Bereichs.	Linear Unit

Codebeispiel

GenerateVideoMetadataStationary: Beispiel 1 (Python-Fenster)

In diesem Beispiel wird eine Videodatei mit räumlichen Informationen für einen stationären Sensor erstellt.

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: Beispiel 2 (eigenständiges Skript)

In diesem Beispiel wird eine Videodatei mit räumlichen Informationen für einen stationären Sensor erstellt.

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

Umgebungen

Dieses Werkzeug verwendet keine Geoverarbeitungsumgebungen.

Lizenzierungsinformationen