Le domande di geotraccia e geoshape permettono di catturare una polilinea o un poligono su una mappa. È possibile usare questa geometria per la feature risultante nel feature layer invece di un punto.
Diversamente delle domande di geopunto o dall'acquisizione della posizione senza domande di posizione, le domande di geotraccia o geoforma non usano la posizione del dispositivo per compilare la risposta, sebbene utilizzino la posizione del dispositivo per centrare la mappa.
Se una domanda di geotraccia o geoforma viene lasciata senza risposta e la relativa geometria non viene creata da una impostazione predefinita o espressione, il record di rilevamento viene inviato al feature layer con la geometria nulla.
Nota:
È possibile aggiungere più domande di geopunto, geotraccia o geoforma a un rilevamento, ma solo una di esse come geometria del record di rilevamento. Puoi usare più domande della mappa se tutte le domande tranne una hanno bind::esri:fieldType impostato a null.
Ogni ripetizione in un rilevamento può anche avere più domande di geopunto, geotraccia o geoforma, ma solo uno di esse può essere usata come geometria di un record di ripetizione. Puoi usare domande a mappa multipla con lo stesso metodo descritto sopra.
Quando si catturano domande geotrace o geoshape usando una mappa, non tutte le caratteristiche dell'app da campo Survey123 sono supportate nell'app web. Le seguenti funzioni sono supportate nell'app da campo Survey123 ma non nell'app web:
- Basemaps offline
- Opzioni di stile fornite per le domande geotrace e geoshape
- Calcoli per le domande di geotraccia e geoforma, inclusa la funzione sum()
- Soglie di accuratezza della localizzazione ed espressioni di qualità della localizzazione
Metodi di acquisizione
I dati di geotraccia e geoforma presentano due metodi di acquisizione: schizzo e vertice. Lo schizzo viene utilizzato per impostazione predefinita per i rilevamenti creati da zero, mentre il vertice viene utilizzato per impostazione predefinita per i rilevamenti creati da un feature layer esistente. È possibile impostare un diverso metodo di acquisizione nel rilevamento immettendo method=sketch o method=vertex nella colonna body::esri:style per la domanda.
Schizzo
Con il metodo dello schizzo la geometria viene acquisita in un singolo movimento e l'acquisizione viene completata una volta che l'utente ha smesso di disegnare questa singola linea.
Per maggiori informazioni su come utilizzare questo metodo, consultare Schizzo.
Vertice
Il metodo del vertice consente l'acquisizione geometrica più precisa di una linea o forma posizionando i vertici che si collegano.
Per maggiori informazioni su come utilizzare questo metodo, consultare Vertice.
Alcuni parametri che controllano il comportamento durante l'acquisizione dei vertici sono:
- beep o nobeep: quando si imposta beep, viene fornito un feedback uditivo ogni volta che viene acquisito un vertice. Quando questo parametro non è incluso, l'impostazione predefinita è nobeep.
- haptic o nohaptic: quando si imposta haptic, viene fornito un feedback aptico ogni volta che viene acquisito un vertice. Questa funzione è disponibile solo se l'hardware supporta il feedback aptico. Quando questo parametro non è incluso, l'impostazione predefinita è nohaptic.
- edit o noedit: quando si imposta noedit, gli utenti possono acquisire solo i vertici nella loro posizione corrente, annullare il posizionamento di ogni vertice e sostituire l'intera linea o l'intero poligono. Gli utenti non possono modificare il singolo vertice. Quando questo parametro non è incluso, l'impostazione predefinita è edit.
- streaming e nostreaming: i vertici di linea o di poligono possono essere trasmessi mentre ci si muove. Quando questo parametro non è incluso, l'impostazione predefinita è nostreaming.
Nell'esempio seguente viene impostato il metodo di acquisizione su streaming vertice con feedback uditivo:
method=vertex,streaming,beep
L'autore del rilevamento può configurare la distanza tra i vertici adiacenti in streaming. Per impostazione predefinita, i vertici vengono acquisiti ogni 10 metri, ma il valore può essere modificato tramite il parametro distanceThreshold. Questo parametro è separato da uno spazio nella colonna body::esri:style. Possono anche essere inclusi altri parametri che definiscono la linea o la forma.
Nell'esempio seguente vengono acquisiti i vertici ogni 25 metri e viene creata una linea rossa:
method=vertex,streaming,beep distanceThreshold=25 lineColor=red
Se la precisione della posizione è importante per i vertici acquisiti, immettendo un valore di soglia di precisione nella colonna body::accuracyThreshold della domanda di geotraccia o geoforma si impedisce l'acquisizione dei vertici se la condizione della soglia non è soddisfatta.
Impostazioni predefinite ed espressioni
È possibile impostare la geometria predefinita per una domanda geotrace o geoshape o utilizzare un'espressione per creare la geometria usando i risultati di altre domande. I singoli vertici che formano la risposta a una domanda di geotraccia o geoforma sono insiemi separati da spazi di valori di latitudine e longitudine (in gradi decimali) separati da un carattere di punto e virgola. Per compilare la risposta a una domanda geotrace o geoshape, è necessario aderire a questa struttura per produrre una risposta valida. Per ottenere posizioni precise, questi valori potrebbero dover essere grandi. Ad esempio, i seguenti valori forniti nella colonna predefinita di una domanda di geoforma disegnano la forma attorno a un parco a Melbourne, in Australia:
-37.842156723211474 144.95942945338243; -37.83554486071995 144.9726235713864; -37.85681405373047 144.98240735651922; -37.85954045531896 144.97715349053766
Suggerimento:
I valori predefiniti della posizione nell'emisfero meridionale causano un errore in Microsoft Excel perché il valore inizia con un segno meno (-) e viene quindi letto come formula. In questi casi, occorre inserire un apostrofo prima del primo valore e verrà letto come previsto inExcel. L’aggiunta di un apostrofo non determina alcun cambiamento del comportamento in Survey123.
Poiché non è possibile inserire questi valori direttamente durante la compilazione dalle domande select_one, si consiglia l'utilizzo della funzionesubstr() nella colonna calculation per contribuire a costruire una risposta valida. Per esempio, il nome di una risposta in una domanda select_one può essere il seguente:
+059.38330_+018.66300
Questa risposta utilizza un numero fisso di caratteri sia per la latitudine sia per la longitudine, inclusi gli zeri che sarebbero normalmente troncati e con un trattino basso tra i due valori, dal momento che gli spazi non sono consentiti nella colonna del name. In questo modo viene creato un valore che può essere decostruito con la funzione substr() per compilare il seguente esempio di domanda di geotraccia con due vertici:
substr(${previous_question1}, 0, 10) + " " + substr(${previous_question1}, -10) + "; " + substr(${previous_question2}, 0, 10) + " " + substr(${previous_question2}, -10)
Questo esempio prende i primi 10 caratteri di due valori diversi (latitudini) e gli ultimi 10 caratteri (longitudini) e li presenta con uno spazio tra latitudini e longitudini e un punto e virgola tra le posizioni valide per produrre un risultato di geotrace valido.
È inoltre possibile utilizzare la funzione aggregata sum() per raccogliere un numero di valori di geopunto in una ripetizione e usarli come vertici per una conseguente geotraccia o geoforma. Ciò consente agli utenti di acquisire metadati di posizione per ogni vertice della geometria. Per ulteriori informazioni, consultare Funzioni di aggregazione.
Sebbene una posizione non venga immediatamente acquisita da una domanda di geotraccia o geoforma, la posizione del dispositivo viene utilizzata per centrare la mappa durante il caricamento del rilevamento. Per prevenire ciò, impostare il valore predefinito a null. Verranno invece visualizzate le opzioni per abilitare l'acquisizione della posizione, caricare la pagina della mappa per l'impostazione manuale di una posizione o l'aggiornamento di un calcolo se esiste un calcolo applicato alla domanda.
Ricerca geografica
Le domande Geotrace e Geoshape includono funzionalità di ricerca geografica, consentendo agli utenti di cercare indirizzi o punti di interesse e impostare lo zoom e posizionare un vertice in tali posizioni.
Per impostazione predefinita, la funzionalità di ricerca geografica restituisce risultati da tutto il mondo, utilizzando ArcGIS World Geocoding Service per la ricerca degli indirizzi.
Nota:
La geocodifica che utilizza ArcGIS World Geocoding Service consumerà crediti. Per ulteriori informazioni, vedere Capire i crediti.Per impostare un localizzatore specifico che restituisca i risultati, fornire l'ID elemento del localizzatore nella colonna bind::esri:parameters, ad esempio geocode=36ff9e8c13e042a58cfce4ad87f55d19. Il localizzatore utilizzato nel rilevamento ArcGIS Online deve essere un elemento in ArcGIS Online. Il localizzatore utilizzato nel rilevamento ArcGIS Enterprise deve essere un elemento nello stesso portale del rilevamento.
Attributi geometrici
Puoi usare le domande geotrace e geoshape nei calcoli per visualizzare e registrare gli attributi della geometria come la lunghezza (per geotrace) e il perimetro e l'area (per geoshape). Le funzioni distance() e area() vengono usate per costruire un'espressione con la domanda geotrace o geoshape. La funzione distance() restituisce un risultato in metri e la funzione area() restituisce un risultato in metri quadrati. Per esempi di calcoli che convertono questi risultati in altre unità, vedi il campione di geotraccia e geoforma in Survey123 Connect.
Simbologia della geometria
È possibile aggiungere uno stile per le domande di geotraccia e geoforma visualizzate nel rilevamento. È possibile impostare questo stile usando i seguenti parametri nella colonna body::esri:style delle domande di geotraccia e geoforma:
- lineColor
- lineWidth
- fillColor
I colori possono essere specificati con nomi colore HTML standard o codici colore esadecimali. È possibile utilizzare codici esadecimali a otto caratteri per impostare l'opacità. Parametri multipli sono separati da uno spazio, ad esempio lineColor=Black fillColor=#800000FF lineWidth=3.
Nota:
I parametri lineColor e lineWidth sono supportati sia dalle domande di geotraccia che da quelle di geoforma. Il parametro fillColor è supportato solo dalle domande di geoforma.
Queste opzioni di stile vengono visualizzate solo in Survey123 Connect e nell'applicazione da campo Survey123.
Le posizioni dei punti ricavate dalla prima domanda di geopunto in una ripetizione possono essere visualizzate su qualsiasi mappa del rilevamento. Per maggiori informazioni, vedi Sovrapposizioni di punti sulle mappe.
Stile delle domande
È possibile configurare mappa di base, strumenti di mappa e altezza della domanda per le domande di mappa.
È possibile impostare una mappa di predefinita per le singole domande della mappa usando il parametro map nella colonna body::esri:style. Ad esempio, map="World Topography" imposta la domanda sulla mappa per utilizzare la mappa di base World Topography. In alternativa, è possibile impostare il parametro map utilizzando l'ID dell'elemento della mappa, ad esempio map=de26a3cf4cc9451298ea173c4b324736. Questo parametro supporta le mappe online e offline, incluse le proprie mappe web. Per ulteriori informazioni, consultare Includere una mappa in un rilevamento.
La colonna body::esri:style accetta un parametro mapTools per controllare gli strumenti mappa disponibili per le domande di mappa. Se nessun parametro di strumento mappa è impostato verranno visualizzati tutti gli strumenti. Sono accettati i seguenti valori:
- mapTools=search
- mapTools=mapSwitcher
- mapTools=zoom
- mapTools=home
- mapTools=locate
È possibile impostare più strumenti separando ogni valore con una virgola, ad esempio mapTools=search,locate.
La colonna body::esri:style accetta un parametro height per le domande di mappa.
È possibile impostare l'altezza per una domanda fornendo il parametro height con un numero e, facoltativamente, un'unità. L'unità predefinita è lines, che si riferisce all'altezza del carattere di testo di input attuale. Per esempio, height=5 fa sì che una di queste domanda visualizzino cinque righe di altezza.
In alternativa, è possibile impostare l'unità come percentuale dell'altezza dello schermo, o in base al numero di pixel, aggiungendoli come suffisso al valore senza spazi. Ad esempio, sono accettati tutti i seguenti valori:
- height=5
- height=5lines
- height=25%
- height=250pixels
Gli strumenti di mappa e l'altezza possono essere impostati con uno spazio che li divide, ad esempio height=25% mapTools=search,zoom.