Layer di tracciamento

Quando l'amministratore dell'organizzazione abilita la condivisione della posizione per l'organizzazione, vengono creati layer di tracciamento che contengono informazioni sulla posizione degli utenti in mobilità e sui luoghi in cui sono stati. Nelle mappe e nelle app è possibile utilizzare viste di feature layer in hosting per questi layer (note come viste di tracciamento), che consentono di capire dove si sono recati gli utenti in mobilità in relazione ad altre risorse e informazioni. È inoltre possibile utilizzare i layer di tracciamento per eseguire analisi avanzate in ArcGIS.

Nota:

Se si desidera una panoramica più dettagliata delle informazioni sul tracciamento, applicare semplici filtri ed eseguire analisi dei tracciamenti è possibile visualizzare i tracciamenti nell'applicazione web Track Viewer.

Schema di condivisione della posizione

Quando la condivisione della posizione è abilitata per l'organizzazione, viene creato un layer di condivisione della posizione che memorizza l'ultima posizione nota degli utenti in mobilità, nonché i tracciamenti storici completi delle posizioni degli utenti in mobilità. Queste informazioni sono memorizzate in tre sottolayer, ciascuno con uno schema predefinito: ultime posizioni note, tracciamenti e linee di tracciamento. Quando si creano le viste di tracciamento nell'applicazione web Track Viewer, viene creata una vista di feature layer in hosting per ciascuno di questi tracciamenti.

Le viste del feature layer di condivisione della posizione e del feature layer in hosting vengono create nella cartella Condivisione posizione nei contenuti dell'account amministratore utilizzato per abilitare la condivisione della posizione. Il feature layer di condivisione della posizione è denominato Condivisione posizione e le viste del feature layer in hosting hanno lo stesso nome della vista di tracciamento per cui sono state create. È possibile condividere queste viste di feature layer in hosting con gli utenti dell'organizzazione aggiungendoli come visualizzatori dei tracciamenti durante la creazione della vista di tracciamento. Per ulteriori informazioni, vedere Creazione di viste di tracciamento.

Nota:

I feature layer di condivisione della posizione e le viste del feature layer non possono essere condivisi con il pubblico.

Il layer di condivisione della posizione non consuma crediti per l'archiviazione. Per ulteriori informazioni sull'utilizzo dei crediti in ArcGIS Online, vedere I crediti.

Traccia il feature layer

Il feature layer di tracciamento (e tutte le viste del feature layer ospitate basate su di esso) è un layer punto che contiene un record per ogni posizione in cui un utente in mobilità è stato registrato con l'applicazione mobile Field Maps, QuickCapture, Survey123 o Indoors. Questi record includono informazioni sul punto di tracciamento, ad esempio l'utente cui appartiene il tracciamento, il tipo di attività dell'utente in mobilità, le informazioni sulla batteria del dispositivo, la direzione, l'altitudine (rispetto al livello medio del mare) e la precisione della posizione.

I punti vengono inseriti solo dall'applicazione mobileField Maps, QuickCapture, Survey123, o Indoors e non vengono mai aggiornati o cancellati. Nessun filtro viene applicato ai punti che vengono registrati, e riflettono i dati grezzi dal dispositivo dell'utente mobile. Il layer è nel sistema di coordinate WGS 1984 Web Mercator (Auxiliary Sphere) [WGS84], che ha il noto ID (WKID) 4326.

Feature layer delle ultime località conosciute (LKL)

Il feature layer delle ultime posizioni conosciute (e qualsiasi vista del feature layer ospitate basata su di esso) è un layer di punti che contiene un singolo record per ogni utente che rappresenta la sua più recente posizione riportata. Ha gli stessi campi e le stesse informazioni del feature layer delle tracce, ed è anche nel sistema di coordinate WGS84.

La tabella seguente elenca i campi sia per il feature layer tracce che per il layer delle ultime posizioni conosciute:

CampoDescrizione
activity

Questo rappresenta l'attività di un utente mobile al momento della registrazione di una traccia. Ci sono sei valori possibili per questo campo:

  • Unknown (0)
  • Stationary (1)
  • Walking (2)
  • Running (3)
  • Cycling (4)
  • Automotive (5)

L'attività è determinata da Core Motion su iOS e ActivityRecognitionClient su Android, con ArcGIS Field Maps, ArcGIS QuickCapture, Survey123 e ArcGIS Indoors rispettando le attività comuni tra i due sistemi. Ciascuna di queste API si basa su sensori quali accelerometri, giroscopi, il pedometro, il magnetometro e il barometro del dispositivo. Se viene visualizzato costantemente un valore Sconosciuto, è possibile che il dispositivo abbia sensori limitati a disposizione.

altitude

L'altitudine del dispositivo misurata in metri sul livello medio del mare (MSL).

app_id

L'app che ha registrato la posizione. Questo valore sarà tracker per i punti caricati da Tracker.

battery_percentage

La percentuale di batteria del dispositivo. Questa gamma va da 0 a 100.

battery_state

Questo rappresenta lo stato della batteria del dispositivo. Ci sono quattro possibili valori che possono essere registrati:

  • Unknown (0)
  • Unplugged (1)
  • Charging (2)
  • Plugged and fully charged (3)
category

La categoria associata alla traccia.

course

La direzione di marcia in unità da 0 a 360 gradi.

created_user

Il nome utente dell'utente mobile.

created_date

La data e l'ora in cui il punto è stato caricato sul server.

device_id

Un ID unico dato al dispositivo.

floor

Il numero del piano riportato dal fornitore di servizi di localizzazione.

globalid

L'ID globale della caratteristica generata dal server.

full_name

Il nome completo dell'utente.

horizontal_accuracy

La precisione orizzontale della posizione registrata misurata in metri.

last_edited_date

La data e l'ora in cui il punto è stato modificato per l'ultima volta sul server.

last_edited_user

Il nome utente dell'utente che ha modificato per ultimo la funzione.

level_id

Il livello del suolo registrato quando si utilizza ArcGIS IPS

location_source

La fonte della posizione (Wi-Fi, GPS, fuso, e così via). Questo viene registrato solo sui dispositivi Android.

location_timestamp

La data e l'ora in cui la posizione è stata registrata dal dispositivo.

objectid

Il campo ID gestito dal sistema.

session_id

Un ID unico che viene generato ogni volta che si attiva il tracciamento.

signal_strength

La forza del segnale del dispositivo. Questo campo non è attualmente compilato nel layer di condivisione della posizione.

speed

La velocità del dispositivo registrata in metri al secondo.

vertical_accuracy

La precisione verticale della posizione registrata misurata in metri.

Nota:

Tutti i valori di data e ora sono registrati in tempo universale coordinato (UTC).

location_timestamp rappresenta la data e l'ora in cui una posizione è stata registrata dall'applicazione mobile. last_edited_date rappresenta la data dell'ultima modifica della feature nel database del server.

Feature layer delle linee dei binari

Il feature layer delle linee di traccia (e qualsiasi vista di feature layer ospitata basata su di esso) è un layer di polilinee che contiene linee che rappresentano dove un utente mobile è stato. Queste linee sono generate automaticamente dal server usando i punti di traccia caricati dal feature layer delle tracce. Le linee di traccia sono aggiornate ogni 10 minuti circa e rappresentano un massimo di un'ora di durata. Le statistiche per ogni polilinea sono calcolate e memorizzate come attributi nel livello. Il layer è nel sistema di coordinate WGS 1984 Web Mercator (Auxiliary Sphere) [WGS84], che ha il noto ID (WKID) 4326.

La seguente tabella elenca i campi per il feature layer delle linee di traccia:

CampoDescrizione
avg_altitude

L'altitudine media basata sui punti della traccia usati per generare la linea, misurata in metri sul livello medio del mare (MSL).

avg_horizontal_accuracy

La precisione orizzontale media basata sui punti di traccia usati per generare la linea, misurata in metri.

avg_speed

La velocità media dell'utente basata sui punti di traccia usati per generare la linea, misurata in metri al secondo.

avg_vertical_accuracy

La precisione verticale media basata sui punti di traccia usati per generare la linea, misurata in metri.

category

La categoria associata alla traccia.

count

Il numero di punti di traccia usati per generare la linea.

created_date

La data e l'ora in cui la linea è stata creata.

created_user

Il nome utente dell'utente mobile.

end_time

L'ora di fine della linea.

full_name

Il nome completo dell'utente.

globalid

L'ID globale della caratteristica generata dal server.

max_altitude

L'altitudine più alta misurata in metri sul livello medio del mare (MSL).

max_battery_percentage

La percentuale di batteria più alta del dispositivo. Questa gamma va da 0 a 100.

max_horizontal_accuracy

La massima precisione orizzontale misurata in metri.

max_speed

La velocità massima misurata in metri al secondo.

max_vertical_accuracy

La massima precisione verticale misurata in metri.

min_altitude

L'altitudine più bassa misurata in metri sopra il livello medio del mare (MSL).

min_battery_percentage

La percentuale di batteria più bassa del dispositivo. Questa gamma va da 0 a 100.

min_horizontal_accuracy

La precisione orizzontale minima misurata in metri.

min_speed

La velocità minima misurata in metri al secondo.

min_vertical_accuracy

La precisione verticale minima misurata in metri.

objectid

Il campo ID gestito dal sistema.

last_edited_date

La data e l'ora in cui il punto è stato modificato per l'ultima volta sul server.

last_edited_user

Il nome utente dell'utente che ha modificato per ultimo la funzione.

predominant_activity

L'attività più comune dell'utente mobile. Ci sono sei valori possibili per questo campo:

  • Unknown (0)
  • Stationary (1)
  • Walking (2)
  • Running (3)
  • Cycling (4)
  • Automotive (5)

L'attività è determinata da Core Motion su iOS e ActivityRecognitionClient su Android, con ArcGIS Field Maps, ArcGIS QuickCapture, Survey123 e ArcGIS Indoors rispettando le attività comuni tra i due sistemi. Ciascuna di queste API si basa su sensori quali accelerometri, giroscopi, il pedometro, il magnetometro e il barometro del dispositivo. Se viene visualizzato costantemente un valore Sconosciuto, è possibile che il dispositivo abbia sensori limitati a disposizione.

predominant_battery_state

Lo stato della batteria più comune del dispositivo. Ci sono quattro possibili valori che possono essere registrati:

  • Unknown (0)
  • Unplugged (1)
  • Charging (2)
  • Plugged and fully charged (3)
start_time

L'ora di inizio della linea.

Nota:

Tutti i valori di data e ora sono registrati in tempo universale coordinato (UTC).

Analisi e configurazione avanzata

Per utilizzare lo schema di condivisione della posizione per analisi e configurazioni avanzate, utilizzare ArcGIS API for Python. Fornisce un modulo per automatizzare la gestione dei layer di tracciamento, dei viewer di tracciamento e degli utenti in mobilità. Oltre alla gestione dei contenuti, ArcGIS API for Python può essere utilizzato per sviluppare analisi più complesse dei brani. Per esempi e best practice, consultare gli script e i notebook di esempio disponibili su GitHub.

Filtrare i tracciamenti non validi

L'applicazione web Track Viewer filtra i punti di tracciamento non validi utilizzando l'espressione mostrata di seguito. È possibile utilizzare questa stessa espressione in Map Viewer per filtrare i punti di tracciamento non validi sulla mappa. Applicare un filtro al layer di tracciamento in Map Viewer utilizzando la seguente espressione:

horizontal_accuracy <= 10 OR (horizontal_accuracy <= 25 AND (speed is not NULL OR course is not NULL)) OR (speed is not NULL AND course is not NULL)

Eliminazione dei tracciamenti

Sebbene la funzione di eliminazione del layer di condivisione della posizione non sia mostrata nella definizione del feature layer, gli amministratori possono eliminare le tracce tramite ArcGIS REST API utilizzando l'operazioneelimina feature. Prima che gli amministratori possano eliminare le tracce, la condivisione della posizione deve essere disabilitata nelle impostazioni dell'organizzazione.

Accedere all'endpoint REST di eliminazione delle feature per il layer di tracciamento, dove è possibile specificare una clausola WHERE o gli ID degli oggetti per identificare ed eliminare i tracciamenti. L'URL dell'endpoint REST di eliminazione delle feature ha il seguente formato (dove host, dominio e webadaptor sono sostituiti dalle informazioni sul server):

https://host.domain.com/webadaptor/rest/services/Hosted/location_tracking/FeatureServer/0/deleteFeatures
Nota:

La possibilità di eliminare i tracciamenti è limitata alla rimozione di uno o più tracciamenti completi dell'utente. Questo assicura che l'ultima posizione nota, i tracciamenti e le linee di tracciamento dell'utente siano completamente rimosse. L'eliminazione di singoli punti di tracciamento non è consentita. Per eliminare i tracciamenti di un utente, è necessario utilizzare i seguenti parametri nell'endpoint REST di eliminazione delle feature (come descritto sopra):

  • returnDeleteResults = false
  • async = true
  • rollbackOnFailure = false

Inoltre, la clausola where deve utilizzare il seguente formato: created_user in ('<username>').

Limitazioni

L'uso delle tracce comporta le seguenti limitazioni:

  • Le tracce in ArcGIS Online possono essere esportate solo come shapefile o file CSV.
  • ArcGIS Online non possono essere utilizzati sui layer di condivisione della posizione.