È 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 EXIF | Descrizione |
|---|---|
| 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 Spike | Descrizione |
|---|---|
| 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.
È 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:
| Categoria | Tipo 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:
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.