Générer des métadonnées vidéo (capteur fixe) (Outils Image Analyst)

Résumé

Crée un fichier vidéo de type géospatial à partir d’une vidéo préenregistrée sans métadonnées. Les données télémétriques sont générées à partir d’informations supplémentaires telles que le champ de vision horizontal, la localisation, la distance lointaine et l’heure de début de la vidéo.

Utilisation

Cet outil a été conçu pour les fichiers vidéo archivés et ne fonctionne pas avec les flux vidéo en direct.

Les formats vidéo pris en charge en entrée de l’outil sont répertoriés dans le tableau suivant :


Description	Extension
Fichier AOMedia Video 1	`.av1`
Fichier AVI (Audio Video Interleave)	`.avi`
HLS (à débit adaptatif [Adaptive Bitrate ou ABR])	`.m3u8`
Fichier MOV	`.mov`
Flux de transport MPEG-2	`.ts`
Flux de programme MPEG-2	`.ps`
Flux de transport M2TS	`.m2ts`
Fichier MPEG	`.mpg`
Fichier MPEG-2	`.mpg2`
Fichier MPEG-2	`.mp2`
Fichier MPEG	`.mpeg`
Film MPEG-4	`.mp4`
Fichier MPEG-4	`.mpg4`
MPEG-Dash	`.mpd`
VLC (mpeg2)	`.mpeg2`
Fichier média VLC (mpeg4)	`.mpeg4`
Fichier média VLC (vob)	`.vob`
Fichier Windows Media Video	`.wmv`

Pour calculer et afficher les points d’angle relatifs de l’emprise de l’image vidéo en tant que contour de l’image sur la carte, vous avez besoin des informations de métadonnées essentielles répertoriées ci-dessous et présentées plus en détail dans la description des paramètres : Une fois les métadonnées complètes et précises, l’outil calcule les angles de l’image vidéo et donc la taille, la forme et la position du contour de l’image vidéo, qui peut alors s’afficher sur la carte.
- Horodatage
- Localisation du capteur
- Angle d’élévation relatif du capteur (inclinaison)
- Angle azimutal relatif du capteur
- Champ de vision horizontal
- Champ de vision vertical
Il s’agit des métadonnées minimales requises pour calculer la transformation entre la vidéo et la carte, pour afficher l’emprise de la vidéo sur la carte et pour activer d’autres fonctionnalités telles que la numérisation et le marquage de la vidéo et de la carte.
Les performances du fichier vidéo multiplexé obtenu dépendent du type et de la qualité des informations de l’outil en entrée.
- Si les seules données disponibles pour les paramètres de l’outil sont Start Time et Sensor Location, la localisation est affichée sur la carte, mais les emprises ne sont pas représentées. Certaines fonctions, comme la numérisation des entités et la mesure de la distance dans la vidéo, ne sont pas prises en charge.

Etiqueter	Explication	Type de données
Fichier vidéo en entrée	Fichier vidéo en entrée pour lequel les métadonnées seront générées et converties en fichier vidéo géospatial. Les types de fichiers suivants sont pris en charge : `.av1,` `.avi`, `.h264`, `.h265`, `.mkv`, `.mov`, `.mp2`, `.mp4`, `.mpeg`, `.mpeg2`, `.mpeg4`, `.mpg`, `.mpg2`, `.mpg4`, `.ps`, `.ts`, `.vob` et `.wmv`.	File
Fichier vidéo en sortie	Nom du fichier vidéo en sortie (`.ts`), avec son extension.	File
Localisation du capteur	Entité ponctuelle qui identifie la position géographique du capteur.	Feature Layer
Heure de début	Horodatage associé à la première image de la vidéo. L’horodatage est utilisé pour aligner les images de la vidéo avec les données temporelles et spatiales.	Date
Fichier de métadonnées en sortie (Facultatif)	Nom du fichier de métadonnées en sortie (`.csv`), avec son extension.	File
Inclinaison (Facultatif)	Angle vertical, en degrés, entre la direction dans laquelle le capteur est orienté et le plan horizontal. Les valeurs positives indiquent une inclinaison vers le haut. Les valeurs négatives indiquent une inclinaison vers le bas.	Double
Azimut relatif (Facultatif)	Angle horizontal du capteur mesuré dans le sens horaire à partir du nord géographique.	Double
Champ de vision horizontal (Facultatif)	Étendue angulaire horizontale totale de la vue du capteur, mesurée en degrés.	Double
Champ de vision vertical (Facultatif)	Étendue angulaire verticale totale de la vue du capteur, mesurée en degrés.	Double
Distance lointaine (Facultatif)	Plage maximale depuis le capteur jusqu’à la limite lointaine du champ de vision.	Linear Unit

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

Nom	Explication	Type de données
in_video_file	Fichier vidéo en entrée pour lequel les métadonnées seront générées et converties en fichier vidéo géospatial. Les types de fichiers suivants sont pris en charge : `.av1,` `.avi`, `.h264`, `.h265`, `.mkv`, `.mov`, `.mp2`, `.mp4`, `.mpeg`, `.mpeg2`, `.mpeg4`, `.mpg`, `.mpg2`, `.mpg4`, `.ps`, `.ts`, `.vob` et `.wmv`.	File
out_video_file	Nom du fichier vidéo en sortie (`.ts`), avec son extension.	File
sensor_location	Entité ponctuelle qui identifie la position géographique du capteur.	Feature Layer
start_time	Horodatage associé à la première image de la vidéo. L’horodatage est utilisé pour aligner les images de la vidéo avec les données temporelles et spatiales.	Date
out_metadata_file (Facultatif)	Nom du fichier de métadonnées en sortie (`.csv`), avec son extension.	File
tilt (Facultatif)	Angle vertical, en degrés, entre la direction dans laquelle le capteur est orienté et le plan horizontal. Les valeurs positives indiquent une inclinaison vers le haut. Les valeurs négatives indiquent une inclinaison vers le bas.	Double
azimuth (Facultatif)	Angle horizontal du capteur mesuré dans le sens horaire à partir du nord géographique.	Double
horizontal_fov (Facultatif)	Étendue angulaire horizontale totale de la vue du capteur, mesurée en degrés.	Double
vertical_fov (Facultatif)	Étendue angulaire verticale totale de la vue du capteur, mesurée en degrés.	Double
far_distance (Facultatif)	Plage maximale depuis le capteur jusqu’à la limite lointaine du champ de vision.	Linear Unit

Exemple de code

Exemple 1 d’utilisation de la fonction GenerateVideoMetadataStationary (fenêtre Python)

Cet exemple crée un fichier vidéo avec des informations géospatiales pour un capteur fixe.

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

Exemple 2 d’utilisation de la fonction GenerateVideoMetadataStationary (script autonome)

Cet exemple crée un fichier vidéo avec des informations géospatiales pour un capteur fixe.

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

Environnements

Cet outil n’utilise pas d’environnement de géotraitement.

Informations de licence