Domande sui media

È possibile includere domande di immagini, audio e file nei rilevamenti per permettere agli utenti di inviare allegati con le risposte ai rilevamenti.

Suggerimento:

Immagini e audio possono anche essere aggiunti ad altre domande in un sondaggio a scopo di riferimento e di stile. Per maggiori informazioni, consultare Usare i media nel rilevamento.

Per impostazione predefinita, le domande di immagine, audio e file consentono un solo allegato. Impostandone l'aspetto su multilinea nella colonna appearance è possibile includere più allegati.

Immagini

Il tipo di domanda immagine consente agli utenti di inviare immagini salvate sul proprio dispositivo o foto scattate con la fotocamera del proprio dispositivo.

Una foto scattata in Survey123 viene salvata come file .jpg, con un livello di qualità che varia a seconda della fotocamera del dispositivo. La dimensione dell'immagine, misurata in base ai pixel sul bordo più lungo, può essere impostata nella scheda Opzioni in Survey123 Connect. Questa dimensione è fornita a tutte le domande di immagine nel rilevamento. Sono disponibili le seguenti opzioni:

  • 320 pixel
  • 640 pixel
  • 1280 pixel
  • 1920 pixel
  • Non limitato (Al rilevamento può essere allegata qualsiasi dimensione di foto).

La dimensione predefinita dell'immagine è di 1280 pixel. Le immagini inviate che sono state salvate sul dispositivo mantengono il tipo di file, la risoluzione e la qualità originale.

Queste dimensioni di immagine non influiscono sull'anteprima di immagine fornita nell'app di campo Survey123. È possibile controllare questo con il parametro previewHeight. Questo parametro supporta tutti i tipi di unità supportati da il parametro height, ma l'altezza dell'immagine di anteprima è limitata dalla larghezza dello schermo del dispositivo e dal rapporto prospettico dell'immagine. Utilizzare previewHeight=0 per impostare l'anteprima immagine alla dimensione massima senza spazi vuoti superflui.

È possibile impostare la dimensione massima allocabile di un'immagine per ogni domanda di immagine individuale in un rilevamento. Specificare max-pixels nella colonna parametri di XSLForm per la domanda che si desidera limitare. Per esempio max-pixels=100 ridimensiona l'immagine in basso proporzionalmente a 100 pixel sul lato più lungo. Se il parametro max-pixels non è specificato, vengono utilizzate le dimensioni dell'immagine impostate in Survey123 Connect.

È possibile limitare una domanda immagine a un particolare metodo di acquisizione specificando method=camera o method=browse nella colona body::esri:style del XLSForm. È anche possibile impostare l'aspetto su new-front o new-rear per limitare una domanda di immagine in modo da usare solo le immagini della fotocamera del dispositivo, utilizzando rispettivamente la fotocamera anteriore o posteriore come impostazione predefinita. Quando si usa l'aspetto annotate, è anche possibile specificare method=map.

La dimensione massima predefinita del file per un'immagine singola è 10 MB. Per le domande di immagine nell'app web Survey123 è possibile specificare la dimensione file massima in megabyte utilizzando max-size nella colonna bind::esri:parameters. Ad esempio, max-size=5 consente agli utenti di allegare un'immagine di dimensione massima di 5 MB.

Nota:

La dimensione di file massima per un allegato individuale inviato dall'app di campo Survey123 è 10 MB.

Quando viene applicato alle domande di immagine, il parametro max-size è supportato solo nell'app Web Survey123. La dimensione massima non può eccedere i 100 MB per ArcGIS Online e i 20 MB per ArcGIS Enterprise.

Le domande di immagine supportano altri aspetti che permettono di annotare foto, disegnare su tele o firmare. Per ulteriori informazioni, consultare Aspetto.

Per impostazione predefinita, Survey123 genera automaticamente un nome file per le immagini inviate a una domanda. Il nome file include il nome della domanda come prefisso, seguito da un numero univoco. Per alcune domande è possibile personalizzare i nomi file per renderli più significativi. Per maggiori informazioni, consultare Personalizzare gli elementi del modulo. Se i dati del rilevamento vengono esportati e pubblicati come un feature layer per l'uso in Survey123, si consiglia di non personalizzare i nomi dei file. Per maggiori informazioni, consultare Parole chiave.

Estrarre i metadati dell'immagine

È possibile usare la funzione pulldata("@exif") per estrarre tag di metadati Exchangeable Image File (EXIF) standard dalla risposta a una domanda di tipo immagine. Se si inserisce il seguente esempio in una domanda di tipo decimale, si estrapola il valore della latitudine del dispositivo da un'immagine:

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

I tag EXIF di posizione comunemente usati per la funzione pulldata("@exif") sono elencati nella seguente tabella:

Tag EXIFDescrizione

GpsLatitude

Latitudine della posizione del dispositivo sotto forma di stringa

GpsLongitude

Longitudine della posizione del dispositivo sotto forma di stringa

GpsAltitude

Altitudine della posizione del dispositivo sotto forma di stringa

GpsLatitudeRef

La latitudine di riferimento (ad esempio, N,E,S,O) del dispositivo sotto forma di stringa

GpsLongitudeRef

La longitudine di riferimento (ad esempio, N,E,S,O) del dispositivo sotto forma di stringa

GpsDestDistance

La distanza tra un dispositivo e le posizioni di destinazione, in chilometri, sotto forma di numero intero

GpsImgDirection

La direzione della posizione di destinazione dalla posizione del dispositivo sotto forma di stringa

GpsDestLatitude

La latitudine della posizione di destinazione sotto forma di stringa

GpsDestLongitude

La longitudine della posizione di destinazione sotto forma di stringa

GpsDestLatitudeRef

La latitudine di riferimento (ad esempio, N,E,S,O) della posizione di destinazione sotto forma di stringa

GpsDestLongitudeRef

La longitudine di riferimento (ad esempio, N,E,S,O) della posizione di destinazione sotto forma di stringa

È possibile utilizzare il seguente esempio per visualizzare sia la latitudine che la longitudine in un singolo campo, che può quindi essere utilizzato per compilare una domanda di geopunto:

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

Di seguito sono elencati altri tag EXIF che possono essere estratti da Survey123. A seconda dell'hardware utilizzato, non sono disponibili tutti i tag.

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

Per vedere questi tag in dettaglio, guarda l'esempio EXIF in Survey123 Connect.

Attenzione:

Se una domanda di immagine contiene immagini multiple, non è possibile estrarre dati EXIF dalle immagini usando la funzione pulldata("@exif"). Per estrarre dati EXIF da varie immagini inviate alla stessa domanda, prendere in considerazione la possibilità di usare una ripetizione.

Integrazione di Spike

Le domande di tipo immagine supportano anche integrazioni con Spike, una soluzione di misurazione laser sviluppata da ikeGPS, che permette di acquisire le misurazioni e la posizione di un oggetto da una foto. Per informazioni su come usare Spike con Survey123, vedere Aspetto.

Spike registra un certo numero di tag personalizzati aggiuntivi scrivendo un oggetto JSON nel tag EXIF ImageDescription che contiene proprietà non standard riguardanti il dispositivo Spike e le misurazioni che ha acquisito. Le colonne nei tag sono descritte nella tabella di seguito:

Tag SpikeDescrizione

device_id

L'ID del dispositivo Spike sotto forma di stringa

local_accuracy

La precisione del dispositivo Spike sotto forma di decimale

destination_altitude

L’altitudine della posizione di destinazione sotto forma di numero razionale

declination

La declinazione del dispositivo Spike sotto forma di numero razionale

pitch

Il pitch del dispositivo Spike sotto forma di numero razionale

rotation

La rotazione del dispositivo Spike sotto forma di stringa

objects

Un array JSON degli oggetti misurati (area e lunghezze) sotto forma di stringa

P2P.capture_id

L’ID delle due immagini del processo point-to-point sotto forma di stringa

P2P.horizontal_distance

La distanza orizzontale tra i due punti in metri

P2P.distance

La distanza tra i due punti in metri

P2P.gradient

Il gradiente tra i due punti in gradi

P2P.vertical_distance

La distanza verticale tra i due punti in metri

P2P.azimuth

L’azimut dei due punti in gradi

Per accedere a questi tag Spike, estrai prima l'oggetto JSON memorizzato nell'EXIF tramite pulldata("@exif") sulla proprietà objects come segue:

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

Quando l'oggetto JSON è in un altro campo, sarà possibile utilizzare il percorso del nome oggetto Spike. in una funzione pulldata("@json") per estrapolare un valore specifico dall'array JSON. Per ulteriori informazioni sulla funzione pulldata("@json"), consultare Recuperare un valore da JSON. Il seguente esempio estrapola il pitch del dispositivo Spike dalla domanda con l'array al suo interno:

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

L'array di objects contiene anche aree e lunghezze acquisite dal dispositivo Spike. Questo array contiene gli oggetti misurati nell'immagine, includendo forme, linee e la forma di allineamento utilizzata per la trasformazione dell'immagine. Gli oggetti nell'array possono essere estratti facendo riferimento alla loro posizione nell'array, un ordine che corrisponde all'ordine nel quale sono stati acquisiti. L'esempio seguente restituisce la prima area o linea nell'array.

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

Nota:

La posizione 0 nell'array contiene sempre la forma di allineamento.

Per restituire la quantità di oggetti presenti nell'array, utilizzare la proprietà length come segue:

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

Per visualizzare esempi dei tag in uso, consultare il rilevamento di esempio di Spike in Survey123 Connect. Per ulteriori informazioni su Spike, visitare la pagina dei prodotti di ikeGPS.

Audio

Il tipo di domanda audio consente agli utenti di registrare e caricare l'audio in Survey123. La registrazione acquisisce un file audio usando il formato di acquisizione audio predefinito per il dispositivo. Una barra di avanzamento indica quanto tempo manca per la registrazione. Gli utenti possono mettere in pausa la registrazione in qualsiasi momento. Una volta che la registrazione è stata completata, è possibile modificare il nome file selezionandolo.

Nota:

La sospensione dell'audio durante la registrazione nell'app da campo non è supportata su Android.

La possibilità di caricare un file audio esistente non è supportata nell'app da campo.

Per impostazione predefinita, le registrazioni audio sono limitate a una dimensione file massima di 10 MB nell'app da campo e a 10 minuti nell'app web.

È possibile impostare un limite di dimensione più basso usando il parametro max-size nella colonna bind::esri:parameters. La registrazione si interrompe automaticamente quando questa dimensione massima viene raggiunta. Ad esempio, max-size=5 consente agli utenti di registrare fino a 5 MB di audio.

Alternativamente, è possibile specificare un limite di tempo in secondi usando il parametro max-duration nella colonna bind::esri:parameters. La registrazione si interrompe automaticamente quando la durata massima viene raggiunta. Per esempio, max-duration=30consente agli utenti di registrare fino a 30 secondi di audio.

Attenzione:
La dimensione di file massima per un allegato individuale inviato dall'app di campo Survey123 è 10 MB. Assicurati che con il valore di max-duration o max-size impostato il file audio non superi la dimensione massima del file.

Per impostazione predefinita, i file audio sono codificati nei dispositivi iOS e Android usando il codec Advanced Audio Coding (AAC), se il dispositivo lo supporta. È possibile specificare i codec audio preferiti usando il parametro codec nella colonna bind::esri:parameters. Possono essere forniti più codec separati da virgole, ad esempio, codec=amr-nb,aac. Sarà utilizzato il primo codec compatibile con il dispositivo.

Nota:

I codec supportati dal dispositivo sono elencati nella pagina Informazioni dell'app da campo Survey123. Tenere premuto il titolo Informazioni su ArcGIS Survey123 in cima alla pagina Informazioni per accedere a informazioni aggiuntive sul dispositivo, inclusi i codec audio supportati. Nei dispositivi Windows i file audio sono sempre registrati nel formato non compresso WAV.

Potrebbe non essere possibile riprodurre alcuni file audio in un browser Web perché non tutti i codec sono supportati dai browser. Per ulteriori informazioni sui Web, vedere la documentazione di Mozilla Developer Network.

È anche possibile inviare un file audio memorizzato sul proprio dispositivo usando una domanda di tipo file. Per un elenco dei tipi di file audio supportati, consultare File.

Per impostazione predefinita, Survey123 genera automaticamente un nome file per l'audio inviato a una domanda. Il nome file include il nome della domanda come prefisso, seguito da un numero univoco. Per alcune domande è possibile personalizzare i nomi file per renderli più significativi. Per maggiori informazioni, consultare Personalizzare gli elementi del modulo. Se i dati del rilevamento vengono esportati e pubblicati come un feature layer per l'uso in Survey123, si consiglia di non personalizzare i nomi dei file. Per maggiori informazioni, consultare Parole chiave.

File

Il tipo di domanda file consente agli utenti di inviare una gamma di tipi di file.

La dimensione file massima predefinita per un unico file è 10 MB. Per le domande di file nell'app web Survey123, è possibile specificare la dimensione massima del file in megabyte utilizzando max-size nella colonna bind::esri:parameters. Ad esempio, max-size=5 consente agli utenti di allegare un file di dimensione massima di 5 MB.

Nota:

La dimensione di file massima per un allegato individuale inviato dall'app di campo Survey123 è 10 MB.

Quando viene applicato alle domande di file, il parametro max-size è supportato solo nell'app Web Survey123. La dimensione massima non può superare i 500 MB per ArcGIS Online e i 20 MB per ArcGIS Enterprise.

Per impostazione predefinita, una domanda di file accetta un solo file. Usa multilinea per la colona appearance per consentire di allegare più file a una domanda di file.

Il tipo di domanda file accetta tutti i tipi di allegati file supportati da ArcGIS Online e ArcGIS Enterprise. I tipi di file supportati sono i seguenti:

CategoriaTipo di file

Archivio

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

Audio

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

Dati

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

Documento

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

Immagine

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

Video

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

*Questo tipo di allegato non è supportato in ArcGIS Enterprise.

È possibile limitare i tipi di file che possono essere inviati a una domanda di file utilizzando la colonna body::accept. Questa colonna accetta sia le estensioni dei file (ad esempio .wav) che i tipi MIME (ad esempio audio/*). Le estensioni file multiple o i MIME possono essere impostati separandoli con una virgola.

Per informazioni sui formati accettati per i tipi MIME, consultare l'elenco di Mozilla dei tipi MIME comuni.

Per impostazione predefinita, Survey123 genera automaticamente un nome file per i file inviati a una domanda. Il nome file include il nome della domanda come prefisso, seguito da un numero univoco. È possibile personalizzare i nomi file per renderli più significativi. Per maggiori informazioni, consultare Personalizzare gli elementi del modulo. Se i dati del rilevamento vengono esportati e pubblicati come un feature layer per l'uso in Survey123, si consiglia di non personalizzare i nomi dei file. Per maggiori informazioni, consultare Parole chiave.

Parole chiave

Survey123 utilizza parole chiave negli allegati per associarli a domande specifiche in un rilevamento. Quando si crea una domanda di immagine, audio o file in un rilevamento e la si pubblica, il nome della domando viene utilizzato come parola chiave nella tabella degli allegati. Ad esempio, se un rilevamento contiene domande di immagine denominate image_closeup e image_wideview, il valore memorizzato nella colonna KEYWORDS della tabella degli allegati sarà image_closeup o image_wideview per ciascuna foto. Survey123 associa automaticamente la parola chiave dell'allegato con il nome della domanda per associare gli allegati alle domande.

Lo scopo dell'associazione della parola chiave è evidente quando si stampano i report. Survey123 assicurerà che la corretta foto venga stampata come risposta alla domanda corretta nel rilevamento. L'associazione di parole chiave è inoltre utilizzata per consentire la modifica di Immagini nella casella In arrivo.

Se si modifica il nome di una domanda di immagine e si ripubblica il rilevamento, è necessario cambiare anche la parola chiave per tutti i record degli allegati esistenti.

Attenzione:

Quando vengono esportati dati di Survey123, la colonna KEYWORDS della tabella degli allegati non verrà mantenuta.

Se questi dati vengono poi ripubblicati come feature service ospitato, si ha una domanda Immagine e sono stati utilizzati i nomi file predefiniti per gli allegati, è possibile utilizzare il notebook Python Aggiorna parole chiave allegati per ricompilare la colonna KEYWORDS. Se si ha più di una domanda di immagine nel proprio rilevamento, non è possibile utilizzare il notebook ed è necessario determinare manualmente quale file è associato a quale domanda e inserire il nome della domanda nella colonna KEYWORDS per ogni record di allegato. Per ulteriori informazioni, consultare questo articolo dell'Assistenza tecnica.

Se i dati vengono ripubblicati come feature service di ArcGIS Server, è necessario aggiungere prima la colonna KEYWORDS alla tabella degli allegati. È possibile utilizzare lo strumento Aggiorna allegati per aggiungere questa colonna. Se si ha una domanda Immagine e sono stati utilizzati i nomi predefiniti per gli allegati, è possibile utilizzare il notebook Python Aggiorna parole chiave allegati per ricompilare la colonna KEYWORDS. Se si ha più di una domanda di immagine nel proprio rilevamento, non è possibile utilizzare il notebook ed è necessario determinare manualmente quale file è associato a quale domanda e inserire il nome della domanda nella colonna KEYWORDS per ogni record di allegato. Per ulteriori informazioni, consultare questo articolo dell'Assistenza tecnica.

In tutti gli ambienti, quando si visualizzano successivamente questi record in Survey123, il valore della parola chiave nella tabella degli allegati corrisponderà al nome della domanda e l'associazione verrà effettuata automaticamente.

Personalizzare i nomi file

Per impostazione predefinita, Survey123 genera automaticamente un nome file per le immagini, l'audio e i file inviati a una domanda. Il nome file include il nome della domanda come prefisso, seguito da un numero univoco. È possibile personalizzare i nomi file per renderli più significativi. Ad esempio, è possibile includere il nome e cognome del firmatario nel nome file di una firma. Per una foto, è possibile includere la data o un descrittore dell'oggetto che si sta fotografando.

Attenzione:

I nomi file personalizzati sono supportati per le domande immagine, audio e file nell'app Web. I nomi file personalizzati sono supportati per le domande di immagine solo nell'app da campo.

I nomi file personalizzati vengono impostati mentre il file viene aggiunto a una domanda multimediale e non vengono aggiornati automaticamente per riflettere le modifiche successive nel rilevamento. Ad esempio, se un nome file fa riferimento a una domanda di testo e il valore di tale domanda cambia dopo l'aggiunta del file, il nome file non verrà aggiornato per riflettere il cambiamento.

È possibile utilizzare il parametro fileName nella colonna bind::esri:parameters perimpostare dinamicamente il nome file per un file che deve essere creato. Nell'esempio seguente, un nome file immagine simile a ASSET406-20221018145109.jpg viene creato dalla domanda asset_id e la data e ora correnti:

Sintassi del nome file immagine in XLSForm

Per consultare altri esempi di sintassi, vedere il campione Immagini e Annotazioni in Survey123 Connect.

I nomi file devono rispettare le seguenti proprietà:

  • I nomi file devono essere univoci per tutte le domande in tutti i rilevamenti nel dispositivo. La cartella I miei allegati al rilevamento archivia tutte le immagini per tutti i rilevamenti nel dispositivo, quindi non può contenere nomi file duplicati. Per assicurarsi che i nomi file siano univoci, considerare di utilizzare una funzione come now() nell'espressione fileName.
  • I nomi file non possono essere più lunghi di 140 caratteri.
  • I nomi file non possono contenere spazi o i seguenti caratteri speciali: \ / : * ? < > ; | . , ". Gli spazi e i caratteri speciali verranno sostituiti con un trattino basso.
Attenzione:

Nell'app da campo, se l'espressione per il parametro fileName determina un nome file duplicato o che supera la lunghezza massima, sarà utilizzato il nome file dell'immagine generato automaticamente. Similmente, se gli utenti modificano manualmente il nome file nel rilevamento, esso non verrà accettato se è un duplicato o se supera la lunghezza massima.

Nell'app Web, se l'espressione per il parametro fileName, o una modifica manuale al nome file, risulta in un duplicato, verrà aggiunto un numero incrementale al nuovo nome file.

I seguenti parametri possono essere applicati nella colonna body::esri:style in una domanda per controllare ulteriormente i nomi file.

  • fileNameVisible: indica se il nome del file sarà visibile nel rilevamento. L'impostazione predefinita è true. Per nascondere il nome del file, digita fileNameVisible=false.
  • allowRename: indica se agli utenti è concesso modificare il nome del file manualmente. L'impostazione predefinita è true. Gli utenti non possono modificare il nome del file quando fileNameVisible=false, anche seallowRename=true.