Rastrear camadas

Após um administrador da organização habilitar o compartilhamento de localização para sua organização, camadas de rastreamento que contêm informações sobre onde os usuários móveis estão e onde eles estiveram são criadas. Você pode usar visualizações da camada de feição hospedadas dessas camadas (conhecidas como visualizações de rastreamento) em seus mapas e aplicativos, permitindo que você entenda onde os usuários móveis estiveram em relação a outros ativos e informações. Você também pode usar camadas de rastreamento para realizar análises avançadas no ArcGIS.

Anotação:

Se você deseja uma visão geral de alto nível das informações de rastreamento e deseja realizar uma filtragem e análise simples dos rastreamentos, você poderá visualizar rastreamentos no aplicativo da web Track Viewer.

Esquema de compartilhamento de localização

Quando o compartilhamento de localização está habilitado para sua organização, uma camada de Compartilhamento de localização é criada que armazena o último local conhecido dos usuários móveis, como também, o histórico de rastreamento completo de onde os usuários móveis estiveram. Esta informação é armazenada em três subcamadas, cada uma com um esquema pré-definido: últimos locais conhecidos, caminhos e linhas de caminhos. Quando você cria visualizações de rastreamento no aplicativo web Track Viewer, uma visualização da camada de feição hospedada é criada para cada uma dessas camadas de rastreamento.

As visualizações da camada de feição do compartilhamento de localização e da camada de feição hospedada são criadas em uma pasta de Compartilhamento de localização no conteúdo da conta de administrador que foi usada para habilitar o compartilhamento de localização. A camada de feição de compartilhamento de localização é denominada Compartilhamento de localização e as visualizações da camada de feição hospedadas têm o mesmo nome da visualização de rastreamento para a qual foram criadas. Você pode compartilhar essas visualizações da camada de feição hospedadas com usuários em sua organização adicionando-os como visualizadores de caminhos ao criar a visualização de rastreamento. Para mais informações, consulte Criar visualizações de rastreamento.

Anotação:

Camadas de feição do compartilhamento da localização e visualizações da camada de feição não podem ser compartilhadas com o público.

A camada de compartilhamento da localização não consome créditos para armazenamento. Para mais informações sobre como os créditos são usados no ArcGIS Online, consulte Entender os créditos.

Camada de feição de caminhos

A camada de feição de caminhos (e quaisquer visualizações da camadas de feição hospedada com base nela) é uma camada de ponto que contém um registro para cada local onde um usuário móvel foi rastreado com o aplicativo móvel Field Maps, QuickCapture, Survey123 ou Indoors. Esses registros incluem informações sobre o ponto de rastreamento, incluindo de quem é o rastreamento, o tipo de atividade do usuário móvel, informações da bateria sobre seu dispositivo, seu curso e altitude (a partir do nível médio do mar) e a precisão da localização.

Os pontos são inseridos apenas pelo aplicativo móvel Field Maps, QuickCapture, Survey123 ou Indoors e nunca são atualizados ou excluídos. Nenhuma filtragem é aplicada aos pontos registrados e eles refletem os dados brutos do dispositivo do usuário móvel. A camada está no sistema de coordenadas WGS 1984 Web Mercator (Esfera Auxiliar) [WGS84], que possui o conhecido ID (WKID) 4326.

Camada de feição dos últimos locais conhecidos (LKL)

A última camada de feição de localizações conhecidas (e qualquer visualização de camada de feição hospedada com base nela) é uma camada de ponto que contém um único registro para cada usuário representando sua localização informada mais recentemente. Ele tem os mesmos campos e informações que a camada de feição de caminhos e também está no sistema de coordenadas WGS84.

A tabela a seguir lista os campos para a camada de feição de caminhos e a última camada de feição de locais conhecidos:

CampoDescrição
activity

Isso representa a atividade de um usuário móvel no momento em que um caminho é registrado. Há seis valores possíveis para este campo:

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

A atividade é determinada por Movimento Principal no iOS e ActivityRecognitionClient noAndroid, com ArcGIS Field Maps, ArcGIS QuickCapture, Survey123 e ArcGIS Indoors honrando as atividades comuns entre os dois sistemas. Cada uma dessas APIs depende de sensores, incluindo acelerômetros, giroscópios, pedômetro, magnetômetro e barômetro do seu dispositivo. Se você visualizar constantemente um valor de Desconhecido, é possível que seu dispositivo tenha sensores limitados disponíveis.

altitude

A altitude do dispositivo medida em metros acima do nível médio do mar (MSL).

app_id

O aplicativo que gravou a localização. Este valor será tracker para pontos transferidos do Tracker.

battery_percentage

A porcentagem de bateria do dispositivo. Este intervalo é de 0 a 100.

battery_state

Isso representa o estado da bateria do dispositivo. Há quatro valores possíveis que podem ser registrados:

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

A categoria associada ao caminho.

course

A direção de deslocamento em unidades de 0 a 360 graus.

created_user

O nome de usuário do usuário móvel.

created_date

A data e hora em que o ponto foi carregado no servidor.

device_id

Um ID exclusivo fornecido ao dispositivo.

floor

O número do andar informado pelo provedor de serviços de localização.

globalid

O ID global da feição gerada pelo servidor.

full_name

O nome completo do usuário.

horizontal_accuracy

A precisão horizontal da localização registrada medida em metros.

last_edited_date

A data e hora em que o ponto foi editado pela última vez no servidor.

last_edited_user

O nome de usuário do usuário que editou a feição pela última vez.

level_id

O nível do andar registrado ao usarArcGIS IPS

location_source

A origem da localização (Wi-Fi, GPS, fundido e assim por diante). Isso é registrado apenas em dispositivos Android.

location_timestamp

A data e hora em que a localização foi registrada pelo dispositivo.

objectid

O campo ID gerenciado do sistema.

session_id

Um ID exclusivo que é gerado sempre que o rastreamento é ativado.

signal_strength

A intensidade do sinal do dispositivo. Este campo não está atualmente preenchido na camada de compartilhamento de localização.

speed

A velocidade do dispositivo registrada em metros por segundo.

vertical_accuracy

A precisão vertical da localização registrada medida em metros.

Anotação:

Todos os valores de data e hora são registrados no tempo universal coordenado (UTC).

O location_timestamp representa a data e hora na qual um local foi gravado pelo aplicativo móvel. O last_edited_date representa quando a feição foi alterada pela última vez no banco de dados do servidor.

Camada de feição de linhas de caminhos

A camada de feição de linhas de caminho (e qualquer visualização de camada de feição hospedada com base nela) é uma camada de polilinha que contém linhas que representam onde um usuário móvel esteve. Essas linhas são geradas automaticamente pelo servidor usando os pontos do caminho transferidos da camada de feição de caminhos. As linhas do caminho são atualizadas aproximadamente a cada 10 minutos e representam no máximo uma hora de duração. As estatísticas para cada polilinha são calculadas e armazenadas como atributos na camada. A camada está no sistema de coordenadas WGS 1984 Web Mercator (Esfera Auxiliar) [WGS84], que possui o conhecido ID (WKID) 4326.

A tabela a seguir lista os campos da camada de feição de linhas do caminho:

CampoDescrição
avg_altitude

A altitude média com base nos pontos do caminho usados ​​para gerar a linha, medida em metros acima do nível médio do mar (MSL).

avg_horizontal_accuracy

A precisão horizontal média com base nos pontos do caminho usados ​​para gerar a linha, medida em metros.

avg_speed

A velocidade média do usuário com base nos pontos do caminho usados ​​para gerar a linha, medida em metros por segundo.

avg_vertical_accuracy

A precisão vertical média com base nos pontos do caminho usados ​​para gerar a linha, medida em metros.

category

A categoria associada ao caminho.

count

O número de pontos do caminho usados ​​para gerar a linha.

created_date

A data e hora em que a linha foi criada.

created_user

O nome de usuário do usuário móvel.

end_time

A hora de término da linha.

full_name

O nome completo do usuário.

globalid

O ID global da feição gerada pelo servidor.

max_altitude

A maior altitude medida em metros acima do nível médio do mar (MSL).

max_battery_percentage

A maior porcentagem de bateria do dispositivo. Este intervalo é de 0 a 100.

max_horizontal_accuracy

A precisão horizontal máxima medida em metros.

max_speed

A velocidade máxima medida em metros por segundo.

max_vertical_accuracy

A precisão vertical máxima medida em metros.

min_altitude

A altitude mais baixa medida em metros acima do nível médio do mar (MSL).

min_battery_percentage

A menor porcentagem de bateria do dispositivo. Este intervalo é de 0 a 100.

min_horizontal_accuracy

A precisão horizontal mínima medida em metros.

min_speed

A velocidade mínima medida em metros por segundo.

min_vertical_accuracy

A precisão vertical mínima medida em metros.

objectid

O campo ID gerenciado do sistema.

last_edited_date

A data e hora em que o ponto foi editado pela última vez no servidor.

last_edited_user

O nome de usuário do usuário que editou a feição pela última vez.

predominant_activity

A atividade mais comum do usuário móvel. Há seis valores possíveis para este campo:

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

A atividade é determinada por Movimento Principal no iOS e ActivityRecognitionClient noAndroid, com ArcGIS Field Maps, ArcGIS QuickCapture, Survey123 e ArcGIS Indoors honrando as atividades comuns entre os dois sistemas. Cada uma dessas APIs depende de sensores, incluindo acelerômetros, giroscópios, pedômetro, magnetômetro e barômetro do seu dispositivo. Se você visualizar constantemente um valor de Desconhecido, é possível que seu dispositivo tenha sensores limitados disponíveis.

predominant_battery_state

O estado de bateria mais comum do dispositivo. Há quatro valores possíveis que podem ser registrados:

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

A hora de início da linha.

Anotação:

Todos os valores de data e hora são registrados no tempo universal coordenado (UTC).

Análise e configuração avançadas

Para usar o esquema de compartilhamento de localização para análise e configuração avançadas, use ArcGIS API for Python. Ele fornece um módulo para automatizar o gerenciamento de camadas de rastreamento, visualizadores de caminhos e usuários móveis. Além de gerenciar o conteúdo, o ArcGIS API for Python pode ser usado para desenvolver análises mais complexas de caminhos. Para exemplos e melhores práticas, consulte os scripts de amostra e notebooks disponíveis em GitHub.

Filtrando caminhos inválidos

O Track Viewer web app filtra pontos de caminhos inválidos usando a expressão mostrada abaixo. Você pode usar essa mesma expressão no Map Viewer para filtrar pontos de caminhos inválidos em seu próprio mapa. Aplique um filtro na camada de rastreamento no Map Viewer usando a seguinte expressão:

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)

Excluindo caminhos

Embora o recurso de exclusão para a camada de compartilhamento de localização não seja mostrado na definição da camada de feição, os administradores podem excluir caminhos por meio dArcGIS REST API usando a operação de excluir feições. Antes que os administradores possam excluir caminhos, o compartilhamento de localização deve ser desativado nas configurações da organização.

Procure o parâmetro REST de excluir feições da camada de rastreamento, onde você pode especificar uma cláusula where ou object IDs para identificar e excluir caminhos. A URL do parâmetro REST de excluir feições segue o seguinte formato (onde host, domínio e webadaptor são substituídos pelas informações sobre seu servidor):

https://host.domain.com/webadaptor/rest/services/Hosted/location_tracking/FeatureServer/0/deleteFeatures
Anotação:

A capacidade de excluir caminhos é restrita à remoção completa de um ou mais caminhos do usuário. Isso garante que a última localização conhecida, caminhos e linhas de caminhos do usuário sejam completamente removidas. A exclusão de pontos de caminho individuais não é suportada. Para excluir com sucesso os caminhos de um usuário, você deve usar os seguintes parâmetros no parâmetro REST de excluir feições (conforme descrito acima):

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

Além disso, a cláusula where deve usar o seguinte formato: created_user in ('<username>').

Limitações

O uso de caminhos vem com as seguintes limitações: