Questions médias

Vous pouvez inclure des questions de type image, audio et fichier dans vos enquêtes pour que les utilisateurs puissent envoyer des pièces jointes avec leurs réponses à l’enquête.

Conseil :

Il est également possible d’ajouter des images et du son aux questions de type note et à choix multiples à des fins de référence et de style. Pour plus d’informations, consultez la rubrique Ajouter des éléments multimédia à une enquête.

Par défaut, les questions de type image, audio et fichier acceptent une pièce jointe. En définissant leur apparence sur multiline (multiligne) dans la colonne appearance (apparence), elles peuvent accepter plusieurs pièces jointes.

Images

Pour pouvoir être ajoutées à votre enquête, toutes les images doivent être enregistrées dans le dossier média de votre projet d’enquête.

Vous pouvez ajouter des images à n’importe quelle question en incluant le nom du fichier d’image (avec l’extension de fichier) dans la colonne media::image de votre feuille de calcul d’enquête. Les types de fichiers pris en charge incluent les fichiers BMP, GIF, JPC, JPE, JPEG, JPF, JPG et PNG. En ce qui concerne les images GIF, l’animation est prise en charge dans l’application Web Survey123 uniquement. L’application de terrain Survey123 prend également en charge les images TIF et TIFF.

Utilisez une question de type note pour afficher une image qui n’est pas associée à une question.

Pour ajouter des images pour des questions à choix multiples, ajoutez la colonne media::image à votre feuille de calcul de choix. Ajoutez le nom exact du fichier d’image (avec l’extension de fichier) pour chaque choix dans cette colonne.

Remarque :

Survey123 tient compte de la casse. Vérifiez que toutes les références aux noms et extensions de fichiers utilisent la même casse que les fichiers mêmes. Par exemple, Tree.JPG est différent de tree.jpg et, si le fichier est référencé de cette façon, l’image ne s’affiche pas dans votre enquête.

Les images en guise de choix dans les questions à choix multiples ne sont pas prises en charge par l’application Web Survey123 si vous utilisez les apparences minimal ou autocomplete.

La sélection d’une image dans une enquête présente une vue en plein écran de l’image. Retournez à l’enquête en utilisant le bouton de retour dans l’angle supérieur gauche.

Vous pouvez également soumettre une image dans votre enquête à l’aide d’une question de type image. Ceci vous permet de soumettre une image enregistrée sur votre appareil ou une photo prise avec l’appareil photo de votre appareil.

Une photo prise dans Survey123 est enregistrée en tant que fichier .jpg, avec un niveau de qualité dépendant de l’appareil photo de votre appareil. Vous pouvez définir la taille d’image, mesurée en pixels sur le bord le plus long, sous l’onglet Options de Survey123 Connect. La taille est appliquée à toutes les questions de type image de l’enquête. Les options disponibles sont les suivantes :

  • 320 pixels
  • 640 pixels
  • 1 280 pixels
  • 1 920 pixels
  • Unrestricted (Illimitée) (Permet de joindre toute taille de photo à l’enquête.)

La taille par défaut de l’image est de 1280 pixels. Les images soumises ayant été enregistrées sur l’appareil conservent leur type de fichier, leur résolution et leur qualité d’origine.

Ces tailles d’image n’affectent pas l’aperçu de l’image présenté par l’application de terrain Survey123. Vous pouvez les contrôler à l’aide du paramètre previewHeight. Pour plus d’informations, reportez-vous à la rubrique Hauteur des questions.

Vous pouvez définir la taille autorisée maximale d’une image de chaque question de type image d’une enquête. Spécifiez max-pixels dans la colonne parameters du XLSForm de la question à limiter. Par exemple, max-pixels=100 réduit la résolution de l’image proportionnellement à 100 pixels sur le bord le plus long. Si le paramètre du nombre de pixels maximal n’est pas spécifié, les images utilisent la taille d’image définie dans Survey123 Connect.

Vous pouvez limiter une question de type image à une méthode de capture particulière en spécifiant method=camera ou method=browse dans la colonne body::esri:style de la feuille de calcul XLSForm. Vous pouvez également régler l’apparence sur new-front ou new-rear pour limiter, par défaut, une question de type image à à l’utilisation du capteur avant ou arrière, respectivement, de l’appareil.

La taille de fichier maximale par défaut d’une image individuelle est de 10 Mo. Pour les questions de type image dans l’application Web Survey123, vous pouvez spécifier la taille de fichier maximale en mégaoctets à l’aide du paramètre max-size dans la colonne bind::esri:parameters. Par exemple, max-size=5 permet aux utilisateurs de joindre une image d’une taille maximale de 5 Mo.

Remarque :

La taille de fichier maximale d’une pièce jointe envoyée à partir de l’application de terrain Survey123 est de 10 Mo.

Appliqué aux questions de type image, le paramètre max-size est uniquement pris en charge dans l’application Web Survey123. La taille maximale ne peut pas dépasser 100 Mo pour ArcGIS Online et 20 Mo pour ArcGIS Enterprise.

Les questions image prennent en charge d’autres apparences pour annoter des photos, dessiner sur une toile ou écrire une signature. Pour plus d’informations, reportez-vous à la rubrique Apparence.

Noms des fichiers image

Par défaut, Survey123 génère automatiquement un nom de fichier pour les images envoyées dans une question de type image. Le nom de fichier inclut le nom de la question en tant que préfixe, suivi d’un nombre unique. Pour certaines questions de type image, il peut être judicieux de personnaliser les noms de fichiers afin de les rendre plus pertinents. Vous pouvez par exemple inclure les prénom et nom du signataire dans le nom de fichier d’une signature. Dans le cas d’une photo, vous pouvez inclure la date ou un descripteur de l’objet que vous photographiez.

Vous pouvez utiliser le paramètre fileName dans la colonne bind::esri:parameters pour définir dynamiquement le nom de fichier de l’image capturée suivante. Dans l’exemple suivant, le nom du fichier image se compose de la valeur de la question asset_id et de la date/heure actuelles.

Syntaxe du nom de fichier image dans XLSForm

Pour des exemples de syntaxe, consultez l’exemple Images et annotation dans Survey123 Connect.

Les noms des fichiers image doivent respecter les règles suivantes :

  • Les noms de fichiers doivent être uniques pour toutes les questions de type image dans toutes les enquêtes de l’appareil. Le dossier My Survey Attachments (Mes enquêtes jointes) stocke toutes les images de toutes les enquêtes sur l’appareil et ne peut donc pas contenir de noms de fichiers dupliqués. Pour garantir l’unicité des noms de fichiers, vous pouvez utiliser la fonction now() dans l’expression fileName.
  • Les noms de fichiers ne peuvent pas dépasser 140 caractères.
  • Les noms de champ ne peuvent pas contenir d’espaces ou les caractères spéciaux suivants : \ / : * ? < > ; | . , ". Les espaces ou les caractères spéciaux seront remplacés par un caractère de soulignement.
Attention :

Si l’expression du paramètre fileName génère un nom de fichier dupliqué ou qui dépasse la longueur maximale, Survey123 revient au nom de fichier généré automatiquement pour l’image. De même, si les utilisateurs mettent à jour manuellement le nom de fichier dans l’enquête, le nom de fichier n’est pas accepté s’il s’agit d’un doublon ou s’il dépasse la longueur maximale.

Vous pouvez appliquer les paramètres suivants dans la colonne body::esri:style d’une question de type image afin de mieux contrôler les noms des fichiers image :

  • fileNameVisible : détermine si le nom du fichier sera visible dans l’enquête La valeur par défaut est true. Pour masquer le nom de fichier, saisissez fileNameVisible=false
  • allowRename : détermine si les utilisateurs sont autorisés à mettre à jour le nom du fichier manuellement. La valeur par défaut est true. Les utilisateurs ne pourront pas mettre à jour le nom de fichier lorsque fileNameVisible=false, même si allowRename=true.

Extraire des métadonnées d’image

Vous pouvez utiliser la fonction pulldata() pour extraire les balises de métadonnées EXIF (Exchangeable Image File) standard de la réponse à une question de type image. En saisissant l’exemple suivant dans une question à décimales, la valeur de latitude de l’appareil est extraite d’une image :

pulldata("@exif", ${image}, "GpsLatitude")

Les balises de localisation EXIF courantes à utiliser avec les fonctions pulldata() sont indiquées dans la table suivante :

Balise EXIFDescription

GpsLatitude

Latitude de l’emplacement de l’appareil sous forme de chaîne

GpsLongitude

Longitude de l’emplacement de l’appareil sous forme de chaîne

GpsAltitude

Altitude de l’emplacement de l’appareil sous forme de chaîne

GpsLatitudeRef

La référence de latitude (c.-à-d. N, E, S, O) de l’emplacement de l’appareil sous forme de chaîne

GpsLongitudeRef

La référence de longitude (c.-à-d. N, E, S, O) de l’emplacement de l’appareil sous forme de chaîne.

GpsDestDistance

La distance entre l’appareil et les emplacements de destination, en kilomètres, sous forme de nombre entier

GpsImgDirection

La direction vers l’emplacement de destination depuis l’emplacement de l’appareil sous forme de chaîne

GpsDestLatitude

La latitude de l’emplacement de destination sous forme de chaîne

GpsDestLongitude

La longitude de l’emplacement de destination sous forme de chaîne

GpsDestLatitudeRef

La référence de latitude (c.-à-d. N, E, S, O) de l’emplacement de l’appareil sous forme de chaîne

GpsDestLongitudeRef

La référence de longitude (c.-à-d. N, E, S, O) de l’emplacement de l’appareil sous forme de chaîne.

Vous pouvez utiliser l’exemple suivant pour afficher les valeurs de la latitude et de la longitude dans un seul champ, de manière à renseigner ensuite une question de type géopoint :

string(pulldata("@exif", ${image}, "GpsLatitude")) + " " + string(pulldata("@exif", ${image}, "GpsLongitude"))

D’autres balises de type image EXIF pouvant être extraites par Survey123 sont répertoriées ci-dessous. N’oubliez pas que selon le matériel que vous utilisez, toutes ces balises ne seront pas disponibles.

GpsAltitudeRef

GpsTimeStamp

GpsSatellites

GpsStatus

GpsMeasureMode

GpsDop

GpsSpeedRef

GpsSpeed

GpsTrackRef

GpsTrack

GpsImgDirectionRef

GpsMapDatum

GpsDestBearingRef

GpsDestBearing

GpsDestDistanceRef

GpsProcessingMethod

GpsAreaInformation

GpsDateStamp

GpsVersionId

GpsDifferential

GpsHPositioningError

ImageWidth

ImageLength

ImageBitsPerSample

ImageCompression

ImagePhotometricInterpretation

ImageDescription

ImageMake

ImageModel

ImageStripOffsets

ImageOrientation

ImageSamplesPerPixel

ImageRowsPerStrip

ImageStripByteCounts

ImageXResolution

ImageYResolution

ImagePlanarConfiguration

ImageResolutionUnit

ImageTransferFunction

ImageSoftware

ImageDateTime

ImageArtist

ImageWhitePoint

ImagePrimaryChromaticities

ImageYCbCrCoefficients

ImageYCbCrSubSampling

ImageYCbCrPosition

ImageReferenceBlackWhite

ImageRating

ImageRatingPercent

ImageCopyright

ImageXPTitle

ImageXPComment

ImageXPAuthor

ImageXPKeywords

ImageXPSubject

ImageLensSpecification

ImageLensModel

ImageLensMake

ImageLensSerialNumber

ExtendedSubjectDistanceRange

ExtendedExposureTime

ExtendedFNumber

ExtendedExposureProgram

ExtendedSpectralSensitivity

ExtendedISOSpeedRatings

ExtendedOecf

ExtendedExifVersion

ExtendedDateTimeOriginal

ExtendedDateTimeDigitized

ExtendedComponentsConfiguration

ExtendedCompressedBitsPerPixel

ExtendedShutterSpeedValue

ExtendedApertureValue

ExtendedBrightnessValue

ExtendedExposureBiasValue

ExtendedMaxApertureValue

ExtendedSubjectDistance

ExtendedMeteringMode

ExtendedLightSource

ExtendedFlash

ExtendedFocalLength

ExtendedSubjectArea

ExtendedMakerNote

ExtendedUserComment

ExtendedSubSecTime

ExtendedSubSecTimeOriginal

ExtendedSubSecTimeDigitized

ExtendedFlashPixVersion

ExtendedColorSpace

ExtendedPixelXDimension

ExtendedPixelYDimension

ExtendedRelatedSoundFile

ExtendedFlashEnergy

ExtendedSpatialFrequencyResponse

ExtendedFocalPlaneXResolution

ExtendedFocalPlaneYResolution

ExtendedFocalPlaneResolutionUnit

ExtendedSubjectLocation

ExtendedExposureIndex

ExtendedSensingMethod

ExtendedFileSource

ExtendedSceneType

ExtendedCfaPattern

ExtendedCustomRendered

ExtendedExposureMode

ExtendedWhiteBalance

ExtendedDigitalZoomRatio

ExtendedFocalLengthIn35mmFilm

ExtendedSceneCaptureType

ExtendedGainControl

ExtendedContrast

ExtendedSaturation

ExtendedSharpness

ExtendedDeviceSettingDescription

ExtendedImageUniqueId

Pour voir ces propriétés en détail, consultez l’exemple EXIF dans Survey123 Connect.

Attention :

Si une question de type image contient plusieurs images, les données EXIF ne peuvent pas être extraites des images à l’aide de la fonction pulldata("@exif"). Si vous devez extraire des données EXIF de plusieurs images soumises à la même question, envisagez d’utiliser une répétition.

Intégration avec Spike

Les questions image permettent également l’intégration avec la solution de mesure par laser Spike développée par ikeGPS, qui permet d’obtenir les mesures et la localisation d’un objet à partir d’une photo. Pour plus d’informations concernant l’utilisation de Spike avec Survey123, reportez-vous à la rubrique Apparence.

Spike enregistre un certain nombre de balises personnalisées supplémentaires en écrivant un objet JSON dans la balise EXIF ImageDescription contenant des propriétés non standard concernant l’appareil Spike et les mesures qu’il a effectuées. Les balises sont décrites dans le tableau suivant :

Balise SpikeDescription

device_id

L’identifiant de l’appareil Spike sous forme de chaîne

local_accuracy

La précision de l’appareil Spike indiquée sous la forme d’un nombre décimal

destination_altitude

L’altitude de l’emplacement de destination sous forme d’un nombre rationnel

declination

L’inclinaison de l’appareil Spike sous la forme d’un nombre rationnel

pitch

Le pas de l’appareil Spike sous la forme d’un nombre rationnel

rotation

La rotation de l’appareil Spike sous forme d’une chaîne

objects

Une matrice JSON des objets mesurés (surface et longueurs) sous forme de

P2P.capture_id

L’ID de deux images du processus point-à-point comme chaîne

P2P.horizontal_distance

La distance horizontale entre les deux points en mètres

P2P.distance

La distance entre les deux points en mètres

P2P.gradient

Le dégradé entre les deux points en degrés

P2P.vertical_distance

La distance verticale entre les deux points en mètres

P2P.azimuth

L’azimut des deux points en degrés

Pour accéder à ces propriétés Spike, extrayez tout d’abord l’objet JSON stocké dans l’EXIF en utilisant pulldata sur la propriété objects comme suit :

pulldata("@exif", ${image}, "objects")

Une fois l’objet JSON dans un autre champ, vous pouvez utiliser le chemin de nom de propriété spike. pour extraire une valeur spécifique du tableau JSON. Dans l’exemple suivant, le pas de l’appareil Spike est extrait de la question contenant la matrice :

pulldata("@json", ${spikedata}, "Spike.pitch")

La matrice objects contient également les surfaces et longueurs capturées par l’appareil Spike. Cette matrice contient les objets mesurés dans l’image, y compris les formes et les lignes, ainsi qu’une forme d’alignement utilisée pour la transformation d’image. Il est possible d’extraire les objets en se référant à leur position dans la matrice, suivant l’ordre correspondant à celui dans lequel ils ont été capturés. L’exemple suivant renvoie la première zone ou ligne de la matrice :

pulldata("@json", ${spikedata}, "Spike.objects[1].type")

Remarque :

La position 0 de la matrice contient toujours la forme d’alignement.

Pour obtenir le nombre d’objets présents dans le tableau, utilisez la propriété length comme indiqué ci-après :

pulldata("@json", ${spikedata}, "Spike.objects.length")

Pour voir des exemples d’utilisation de ces balises, consultez l’exemple d’enquête Spike dans Survey123 Connect. Pour plus d’informations sur Spike, consultez la page des produits ikeGPS.

Sonore

Pour inclure des fichiers audio dans votre enquête, ils doivent être enregistrés dans le sous-dossier média de votre projet d’enquête.

Vous pouvez ajouter du son à n'importe quelle question en incluant le nom du fichier d’image (avec l’extension de fichier) dans la colonne media::audio de votre feuille de calcul d’enquête. Les types de fichiers pris en charge incluent les fichiers MP3 et WAV. Des formats audio supplémentaires sont pris en charge par certaines plateformes. Par exemple, la lecture des fichiers M4A est possible sur iOS.

Utilisez une question de type note pour lire un clip audio qui n’est pas associé à une question.

Pour ajouter du son pour des questions à choix multiples, ajoutez la colonne media::image à votre feuille de calcul de choix. Ajoutez le nom exact du fichier audio (avec l’extension de fichier) pour chaque choix dans cette colonne.

Lorsque le son est inclus dans une enquête, un bouton de haut-parleur est actif sur le formulaire. Appuyez dessus pour lire le fichier audio. Vous pouvez lire les fichiers audio de manière répétée.

Vous pouvez également enregistrer un fichier audio dans l’application de terrain Survey123 à l’aide d’une question audio. Ceci a pour effet de capturer un fichier audio avec le format de capture audio par défaut correspondant à votre appareil. Une barre de progression indique la durée restante pour l’enregistrement. Les utilisateurs peuvent interrompre ou arrêter l’enregistrement à tout moment. Une fois l’enregistrement terminé, vous pouvez mettre à jour le nom de fichier en le sélectionnant.

Remarque :

Il n’est pas possible d’interrompre l’audio en cours d’enregistrement sur Android.

Par défaut, les enregistrements audio sont limités à une taille de fichier maximale de 10 Mo. Vous pouvez définir une taille limite inférieure en mégaoctets à l’aide du paramètre max-size dans la colonne bind::esri:parameters. L’enregistrement s’arrête automatiquement lorsque cette taille de fichier est atteinte. Par exemple, max-size=5 autorise les utilisateurs à enregistrer jusqu’à 5 Mo d’audio.

Vous pouvez également définir une durée limite en secondes à l’aide du paramètre max-duration dans la colonne bind::esri:parameters. L’enregistrement s’arrête automatiquement lorsque cette durée est atteinte. Par exemple, max-duration=30 autorise les utilisateurs à enregistrer jusqu’à 30 secondes d’audio.

Attention :
La taille de fichier maximale d’une pièce jointe envoyée à partir de l’application de terrain Survey123 est de 10 Mo. Vous devez vous assurer que le paramètre max-duration ou max-size que vous définissez n’entraîne pas le dépassement de la taille maximale du fichier audio.

Par défaut, les fichiers audio sont codés sur les appareils iOS et Android à l’aide du codec AAC (Advanced Audio Coding), si l’appareil le permet. Vous pouvez spécifier les codecs audio préférés à l’aide du paramètre codec dans la colonne bind::esri:parameters. Vous pouvez fournir plusieurs codecs en les séparant par des virgules, par exemple, codec=amr-nb,aac. Le premier codec compatible avec l’appareil sera utilisé. Les codecs pris en charge par l’appareil sont répertoriés sur la page About (À propos) dans l’application de terrain Survey123. Maintenez la bannière Powered by ArcGIS AppStudio (Optimisé par ArcGIS AppStudio) enfoncée au bas de la page About (À propos) pour afficher des informations complémentaires sur l’appareil, notamment les codecs audio qu’il prend en charge. Sur les appareilsWindows, les fichiers audio sont toujours enregistrés au format WAV décompressé.

Vous pouvez également soumettre un fichier audio conservé sur votre appareil à l’aide d’une question de type fichier. Pour obtenir la liste des types de fichiers pris en charge, reportez-vous à la rubrique Fichiers.

Fichiers

Les questions de type fichier autorisent les utilisateurs à soumettre différents types de fichiers.

La taille maximale par défaut d’un fichier individuel est de 10 Mo. Pour les questions de type fichier dans l’application Web Survey123, vous pouvez spécifier la taille de fichier maximale en mégaoctets à l’aide du paramètre max-size dans la colonne bind::esri:parameters. Par exemple, max-size=5 permet aux utilisateurs de joindre un fichier d’une taille maximale de 5 Mo.

Remarque :

La taille de fichier maximale d’une pièce jointe envoyée à partir de l’application de terrain Survey123 est de 10 Mo.

Appliqué aux questions de type fichier, le paramètre max-size est uniquement pris en charge dans l’application Web Survey123. La taille maximale ne peut pas dépasser 100 Mo pour ArcGIS Online et 20 Mo pour ArcGIS Enterprise.

Par défaut, une question de type fichier admet un fichier. Utilisez l’apparence multiligne pour permettre aux utilisateurs de joindre plusieurs fichiers à une question de type fichier.

Le type de question fichier accepte tous les types de fichiers joints pris en charge par ArcGIS Online et ArcGIS Enterprise. Les types de fichiers pris en charge sont les suivants :

CatégorieTypes de fichiers

Archiver

7Z, GTAR, GZ, TAR, TGZ, ZIP

Sonore

AIF, M4A, MID, MP2, MP3, MPA, RA, RAM, RMI, WAV, WMA

Données

CSV, GEODATABASE, GEOJSON, GML, GPKG*, JSON, MDB, PBF*, SD*, VRML, XML

Document

DOC, DOCX, DOT, PDF, PPT, PPTX, TXT, WPS, XLS, XLSX, XLT

Image

BMP, ECW, EMF, EPS, GIF, IMG, J2K, JP2, JPC, JPE, JPEG, JPF, JPG, PNG, PS, PSD, RAW, SID, TIF, TIFF, WMF

Vidéo

AVI, MOV, MP4, MPE, MPEG, MPG, MPV2, QT, WMV

*Type de pièce jointe non pris en charge dans ArcGIS Enterprise.

Vous pouvez limiter les types de fichiers qu’il est possible d’envoyer à une question de type fichier en utilisant la colonne body::accept. Cette colonne accepte les extensions de fichier (par exemple, .wav) et les types MIME (par exemple, audio/*). Il est possible de spécifier plusieurs extensions de fichier ou types MIME en les séparant par un point-virgule.

Pour en savoir plus sur les formats acceptés dans le cas des types MIME, reportez-vous à la liste des types MIME courants de Mozilla.


Dans cette rubrique
  1. Images
  2. Sonore
  3. Fichiers