As perguntas de ponto geográfico permitem a você capturar uma posição específica em uma pesquisa. Enquanto respostas de pesquisa no Survey123 sempre tentarem capturar uma posição do dispositivo mesmo se uma pergunta de ponto geográfico não estiver incluída, uma pergunta de ponto geográfico visível no formulário resultará em uma captura melhor das informações de posição.
Considere o seguinte ao usar pontos geográficos:
- Você pode adicionar múltiplas perguntas de ponto geográfico, traçado geográfico ou formato geográfico a uma pesquisa, no entanto, você pode usar apenas um deles como a geometria do registro de pesquisa. Você pode usar várias perguntas de mapa se todas, exceto uma, bind::esri:fieldType definido para null.
- Cada repetição em um levantamento também pode ter mais de uma pergunta de ponto geográfico, traçado geográfico ou formato geográfico; no entanto, você pode usar apenas um deles como a geometria de um registro de repetição. Você pode usar várias perguntas do mapa com o mesmo método descrito acima.
- Por padrão, o Survey123 exibirá valores de latitude e de longitude WGS84, no formato de graus/minutos/segundos. Para alterar esta exibição para uma pesquisa, selecione a guia Mapa e escolha um valor de formato de coordenada diferente.
- Por padrão, uma pergunta de ponto geográfico utiliza um mapa base online. Se a pesquisa for usada offline, consulte Usar mapas base offline.
- As localizações do ponto da primeira pergunta de ponto geográfico em uma repetição podem ser exibidas em qualquer mapa da pesquisa. Para mais informações, consulte Sobreposições do ponto nos mapas.
- Se você não incluir quaisquer perguntas de ponto geográfico, traçado geográfico ou formato geográfico na pesquisa, a camada de feição principal da pesquisa terá um tipo de geometria de esriGeometryPoint. A localização do ponto será preenchida com as informações de localização disponíveis a partir da dispositivo no momento que os dados de pesquisa foram abertos. Este comportamento se aplica mesmo se a pesquisa tiver repetições que contêm perguntas do mapa, mas não inclui uma pergunta do mapa fora das repetições.
- Ao definir a coluna aparência da pergunta de ponto geográfico para press-to-locate, o Survey123 somente irá capturar um ponto quando o usuário interagir com a pergunta.
- Ao capturar respostas usando um mapa, nem todas as feições do aplicativo de campo Survey123 são suportadas com o aplicativo da web. As seguintes feições são suportadas no aplicativo de campo Survey123, mas não no aplicativo da web:
- Mapas base offline.
- Média de localização para perguntas de pontos geográficos.
- Simbologia do ponto geográfico.
- Limites de precisão de localização e expressões de qualidade de localização.
- Todas as propriedades pulldata("@geopoint"). O aplicativo da web suporta apenas x, y, z, horizontalAccuracy, verticalAccuracy, speed, e propriedades direction.
Limite de precisão de localização
Por padrão, o Survey123 não verifica a precisão nos valores da posição que ele coleta. Se a precisão de localização for importante para os resultados da pesquisa, você pode definir um limite de precisão com cálculo de média da localização. Isso pode ser feito inserindo um valor numérico na coluna body::accuracyThreshold da pergunta do ponto geográfico. Esse valor será o limite de precisão além do qual os valores não são mais capturados ao calcular a média de um local.
Quando não calculando a média, o painel de mapa no aplicativo de campo do Survey123 exibe um aviso se a precisão da posição for maior que o limite definido mas não proíbe o usuário de capturar as posições. Para capturar um local que atenda ao limite, aguarde até que não haja nenhum aviso e selecione o botão de local. As posições que não atendem ao limite de precisão são automaticamente ignoradas durante a média.
Expressões de qualidade de localização
O limite de precisão de localização é um número único, um valor mínimo para a precisão horizontal de uma localização fornecida. Uma expressão pode ser utilizada para advertir um usuário que sua localização não atende outros requisitos de qualidade mais complexos ou restringe-os de enviar esta localização. A seguir estão as colunas (juntamente com suas colunas de mensagens associadas) onde você pode inserir essas expressões:
- As colunas constraint e constraint_message podem ser usadas para evitar que o usuário capture um local em uma pergunta de ponto geográfico quando a expressão de qualidade do local não for atendida.
- As colunas bind::esri:warning e bind::esri:warning_message podem ser usadas para exibir um aviso ao usuário se a expressão de qualidade de localização não for atendida. Se a qualidade de localização não for atendida, a barra que contém o valor da coordenada na parte superior da pergunta do ponto geográfico ficará amarela. Neste caso, o usuário pode ainda capturar a localização.
Uma expressão pode ser criada em qualquer uma dessas colunas usando qualquer pergunta da pesquisa; normalmente são usadas perguntas ou parâmetros relacionados ao local da pesquisa.
Para os parâmetros de localização que podem ser utilizados, consulte a seção Extrair valores de ponto geográfico abaixo.
Como exemplo, a seguinte expressão pode ser usada para garantir que o usuário tenha quase parado antes de capturar uma localização e que a precisão horizontal seja melhor que 5 metros:
pulldata("@geopoint", ., "horizontalAccuracy") < 5 and pulldata("@geopoint", ., "speed") < 0.1
Dica:
Embora você possa desejar que o usuário capture um ponto quando estiver parado, raramente um dispositivo relatará um valor de velocidade igual a zero. Por esse motivo, o exemplo acima procura uma velocidade inferior a 0,1 para introduzir uma margem de erro aceitável.
Se a localização deve ser capturada nas condições descritas pela expressão, insira a expressão na coluna constraint. Se for apenas uma recomendação, inserir a expressão na coluna bind::esri:warning exibirá a mensagem de aviso ao usuário. O usuário pode ainda capturar a localização na pergunta de ponto geográfico.
As mensagens de constraint e bind::esri:warning são exibidas se a expressão destas colunas avaliar como falso.
Para expressões muito grandes ou complexas, é recomendado separar as funções pulldata("@geopoint") em perguntas individuais e consultar esses nomes de perguntas na expressão. Por exemplo, para executar a mesma função do exemplo acima, você pode usar o seguinte cálculo em uma pergunta denominada hAccuracy:
pulldata("@geopoint", ${location}, "horizontalAccuracy")
Então, você pode usar o seguinte cálculo em uma pergunta denominada currentSpeed:
pulldata("@geopoint", ${location}, "speed")
O cálculo a seguir pode ser usado como a expressão de restrição ou aviso para a pergunta do ponto geográfico:
(${hAaccuracy} < 5) and (${currentSpeed} < 0.1)
Reportar um intervalo de confiança de 95%
Sua organização pode exigir que os dados coletados sejam reportados em um intervalo de confiança específico (CI). Por padrão, quando o tipo de precisão que é retornado é erro médio quadrático (RMS), o CI é 68 porcento. Para relatar o IC de 95% em uma pesquisa, multiplique a precisão horizontal por 1,7308 e a precisão vertical por 1,9600. Para mais informações sobre estes fatores de conversão, consulte o Padrão Nacional para Precisão de Dados Espaciais.
Exemplo de exatidão de alta precisão
Neste exemplo, um conjunto absoluto mínimo de variáveis deve ser atendido, mas o usuário recebe discrição para coletar uma localização com algumas variáveis menos rígidas. Pode haver problemas de segurança ou perigo que impeçam o usuário de permanecer no local por tempo suficiente para atender aos requisitos preferenciais. Neste caso, um aviso é exibido e o usuário pode decidir por capturar a localização ou esperar mais um pouco.
Os seguintes requisitos mínimos absolutos de precisão são definidos pelo autor da pesquisa:
- A precisão horizontal com CI de 95 porcento é menor que dois metros.
- A precisão vertical com CI de 95 porcento é menor que dois metros.
- A Diluição da Posição de Precisão (PDOP) é menor ou igual a 6.0.
- Cinco ou mais satélites são utilizados.
Os seguintes requisitos de precisão preferidos são definidos pelo autor da pesquisa:
- A precisão horizontal com CI de 95 porcento é menor que um metro.
- A precisão vertical com CI de 95 porcento é menor que um metro.
- PDOP é menor ou igual a 2.0
- Sete ou mais satélites são utilizados.
O cálculo a seguir é usado em uma pergunta denominada haccuracy68cep:
pulldata("@geopoint", ${location}, "horizontalAccuracy")
O cálculo a seguir é usado em uma pergunta denominada haccuracy95ci:
${haccuracy68cep} * 1.7308
Com cálculos semelhantes realizados para precisão vertical, a expressão seguinte será inserida na coluna constraint para representar a precisão mínima absoluta:
${accuracyType} = 0 and ${haccuracy95ci} < 2 and ${vaccuracy95ci} < 2 and ${pdop} <= 6 and ${satellitesInUse} >= 5
A expressão seguinte será inserida na coluna bind::esri:warning para representar a precisão preferida. Os valores utilizados aqui são normalmente menores que os utilizados para a precisão mínima absoluta. Os valores menores são preferidos, mas os valores mínimos maiores podem ser utilizados.
${accuracyType} = 0 and ${haccuracy95ci} < 1 and ${vaccuracy95ci} < 1 and ${pdop} <= 2 and ${satellitesInUse} >= 7
Camadas de feição 3D
Por padrão, as perguntas de ponto geográfico do Survey123 não suportam valores do eixo z (altitude); eles somente capturam a latitude e longitude em uma camada de feição bidimensional. Você pode alterar isto inserindo esriFieldTypePointZ no campo bind::esri:fieldType que permite ao valor de altitude ser capturado na camada de feição. Isto também permite que o campo de altitude seja alterado ao especificar um valor de ponto geográfico.
Padrões
Uma localização padrão pode ser configurado para uma pergunta de ponto geográfico fornecendo um conjunto de valores de longitude e latitude separado por espaço (em graus decimais) na coluna padrão. Por exemplo, o -37.814552 144.966071 irá padronizar a pergunta de ponto geográfico para uma localização em Melbourne, Austrália.
Dica:
Os padrões de localização no hemisfério sul causam um erro no Microsoft Excel, pois o valor é lido como uma fórmula porque começa com um sinal de menos (-). Nesses casos, insira um apóstrofo antes do primeiro valor e ele será lido conforme pretendido no Excel. Adicionar um apóstrofo não causa nenhuma mudança no comportamento no Survey123.
Se um padrão não for fornecido, a pergunta do ponto geográfico atualizará automaticamente para a localização atual do dispositivo. Para evitar isso, defina o valor padrão como null. A pergunta do ponto geográfico exibirá opções para habilitar a captura de localização, carregar a página do mapa para definir manualmente uma localização ou atualizar um cálculo se houver um cálculo aplicado.
As perguntas de ponto geográfico que são alteradas de um estado não relevante para um estado relevante não serão atualizadas automaticamente para a localização do dispositivo. Defina o valor padrão como posição para obter automaticamente a localização atual identificada pelo dispositivo quando a pergunta for relevante.
As perguntas de ponto geográfico contidas em pesquisas iniciadas na Caixa de Entrada, Rascunhos ou Caixa de Saída não serão atualizadas automaticamente para a localização atual do dispositivo. Defina o valor padrão como posição para obter automaticamente a localização atual identificada pelo dispositivo quando a pesquisa é aberta a partir de uma pasta.
Cálculos
Você pode preencher uma pergunta de ponto geográfico utilizando os resultados de outras perguntas. A resposta de uma pergunta de ponto geográfico é formatada como uma lista de valores de latitude e longitude separados por espaços (em graus decimais) seguidos por valores opcionais, iniciando com altitude e precisão (em metros). Para preencher a resposta de uma pergunta de ponto geográfico, você deve aderir a essa estrutura para produzir uma resposta válida.
Pelo fato de você não poder fazer isto diretamente ao preencher as perguntas de select_one, é recomendado a você utilizar a função substr() para ajudar a construir uma resposta válida. Por exemplo, o nome do ponto geográfico pode ser o seguinte:
+059.38330_+018.00000
Esse valor usa uma quantidade fixa de caracteres para latitude e longitude, incluindo zeros que normalmente seriam truncados com um sublinhado entre os dois valores, pois espaços não são permitidos na coluna nome. Isto cria um valor que pode ser desconstruído com a função substr() para preencher o exemplo seguinte de uma pergunta de ponto geográfico:
concat(substr(${LocationValue}, 0, 10), " ", substr(${LocationValue}, -10))
Este exemplo leva os primeiros 10 caracteres do valor (a latitude) e os últimos 10 caracteres (o valor de longitude) e apresenta-os separados por um espaço para produzir um resultado de ponto geográfico válido.
Você também pode utilizar a função pulldata() para preencher uma pergunta de ponto geográfico utilizando um arquivo csv anexado. Primeiro, adicione o arquivo .csv na pasta de mídia da pesquisa. Então, adicione algo semelhante ao seguinte na coluna cálculo:
pulldata('Intersections', 'Lat', 'IntersectionID', ${intersection}) + " " + pulldata('Intersections', 'Long', 'IntersectionID', ${intersection})
Como o exemplo substr(), isto combina os valores de longitude e latitude de uma localização com um espaço para criar uma resposta válida para uma pergunta de ponto geográfico baseado em uma pergunta anterior.
Veja exemplos de ambos os cálculos nas amostras no Survey123 Connect.
Exigido e somente para leitura
As perguntas de ponto geográfico preenchem automaticamente uma pesquisa com uma localização fornecida pelo dispositivo se um estiver disponível. Se o dispositivo não fornecer um local válido na resposta à pesquisa, o Survey123 retorna uma localização de 0,0, que está em um trecho do oceano na costa da África. Marcar a pergunta do ponto geográfico como exigido impede que a pesquisa seja enviada com esse valor nulo, e a pesquisa é aceita assim que o dispositivo fornecer um local ou um local for enviado manualmente.
Tornar a pergunta de ponto geográfico como somente para leitura evitará a inserção de respostas manuais. Isto pode ser útil para perguntas em que uma resposta automática é necessária e uma resposta manual causaria problemas com o conjunto de dados. É recomendado usá-lo com um dos cálculos descritos acima, que fornece um valor de ponto geográfico discreto que os usuários não podem alterar.
Pesquisa geográfica e geocódigo
As perguntas de ponto geográfico inclui a funcionalidade de pesquisa geográfica, permitindo os usuários procurar por um endereço ou ponto de interesse e ampliar o mapa e posicionar o marcador de ponto geográfico nesta localização.
Por padrão, a funcionalidade de pesquisa geográfica retorna resultados de todo o mundo, usando o Serviço do ArcGIS Geocoding para procurar os endereços.
Por padrão, a pesquisa geográfica retorna resultados de todo o mundo, usando o Serviço do ArcGIS Geocoding para pesquisar os endereços. Os usuários conectados também visualizarão todos os serviços de geocodificação configurados pela organização.
Anotação:
A geocodificação usando Serviço do ArcGIS Geocoding consumirá créditos. Para mais informações, consulte Entender os créditos.Para definir um localizador específico para retornar resultados, forneça o ID de item do localizador na coluna bind::esri:parameters, por exemplo, geocode=36ff9e8c13e042a58cfce4ad87f55d19. Um localizador usado em uma pesquisa do ArcGIS Online deve ser um item no ArcGIS Online. Um localizador usado em uma pesquisa do ArcGIS Enterprise deve ser um item do mesmo portal da pesquisa.
Você também pode definir uma pergunta para realizar apenas uma geocodificação, adicionando uma pergunta de texto com a aparência de geocodificar. Para mais informações, consulte Aparência do geocódigo.
Geocodificação reversa
A geocodificação reversa pode ser executada no aplicativo de campo ao pressionar o mapa ou as coordenadas quando a visualização de ponto geográfico completa for aberta, mas isto não é salvo e enviado à pesquisa. O valor geocodificado reverso pode ser obtido a partir do ponto geográfico utilizando pulldata("@geopoint", ${location}, "reversegeocode"), que retorna a localização como um objeto JSON. Propriedades individuais do objeto podem ser extraídas fornecendo o nome da propriedade, mas estas propriedades diferem dependendo do localizador utilizado. No caso do Serviço do ArcGIS Geocoding, um objeto JSON semelhante ao seguinte é retornado:
{
"address": {
"Match_addr": "207-361 Flinders St, Melbourne, Victoria, 3000",
"LongLabel": "207-361 Flinders St, Melbourne, Victoria, 3000, AUS",
"ShortLabel": "207-361 Flinders St",
"Addr_type": "StreetAddress",
"Type": "",
"PlaceName": "",
"AddNum": "283",
"Address": "283 Flinders St",
"Block": "",
"Sector": "",
"Neighborhood": "Melbourne",
"District": "Melbourne",
"City": "Melbourne",
"MetroArea": "",
"Subregion": "",
"Region": "Victoria",
"RegionAbbr": "VIC",
"Territory": "",
"Postal": "3000",
"PostalExt": "",
"CntryName": "Australia",
"CountryCode": "AUS"
},
"location": {
"x": 144.96721048751365,
"y": -37.81768543612741,
"spatialReference": {
"wkid": 4326,
"latestWkid": 4326
}
}
}Para extrair um valor específico do objeto JSON, use uma função pulldata("@geopoint") semelhante à seguinte, que extrai a propriedade Match_addr:
pulldata("@geopoint", ${location}, "reversegeocode.address.Match_addr")
O serviço de geocódigo padrão para sua organização é usado na geocodificação reversa. Para utilizar um serviço de geocódigo diferente, insira a URL do localizador como um parâmetro opcional na função com o formato pulldata("@geopoint", ${location}, "reversegeocode", ${locatorURL}). Se o serviço for protegido, ou a pesquisa for planejada para usuários públicos, um item do proxy deverá ser configurado com credenciais de acesso salvas nele.
Se uma URL de localizador for fornecida, os parâmetros adicionais podem ser fornecidos que serão passados para URL. Como as propriedades fornecidas com o objeto de JSON, estes parâmetros diferem dependendo do serviço de geocódigo utilizado. O exemplo seguinte utiliza o parâmetro featureTypes, que limita o valor retornado para um tipo específico de localização para retornar somente os negócios mais próximos ou ponto de referência:
pulldata("@geopoint", ${location}, "reversegeocode.address.Match_addr", "https://geocode.arcgis.com/arcgis/rest/services/World/GeocodeServer", "featureTypes=POI")Dica:
Se o serviço de geocódigo padrão para sua implantação do ArcGIS Enterprise for o Serviço do ArcGIS Geocoding, ou se o Serviço do ArcGIS Geocoding for usado como parâmetro de URL do localizador em uma pesquisa corporativa como nas etapas acima, você poderá receber um erro de token ao executar a geocodificação reversa. Para evitar isto, crie um item de proxy que tenha credenciais de acesso do ArcGIS Online salvo nele para um usuário com permissões para executar geocodificação. Este item pode então ser configurado como um serviço de geocódigo padrão para um portal, ou como o destino de um parâmetro de URL do localizador na função de geocodificação reversa.
Para obter mais informações sobre parâmetros de URL de geocodificação reversa, incluindo uma lista completa de parâmetros que podem ser enviados para a URL, consulte reverseGeocode na documentação do ArcGIS REST API.
Você pode incluir vários cálculos de geocodificação reversa sem afetar o desempenho ou os créditos. Por exemplo, as três chamadas a seguir para propriedades individuais podem ser incluídas:
pulldata("@geopoint", ${location}, "reversegeocode.address.Match_addr")
pulldata("@geopoint", ${location}, "reversegeocode.address.LongLabel")
pulldata("@geopoint", ${location}, "reversegeocode.address.ShortLabel")
A geocodificação reversa é realizada para o primeiro cálculo, que consome créditos. Em seguida, a resposta é armazenada em cache e usada para os outros dois cálculos. Uma nova chamada para o serviço geográfico só é necessária se a URL de solicitação de geocodificação reversa tiver sido alterada devido a uma alteração no local, um parâmetro de solicitação diferente sendo usado ou o token de acesso original expirando.
Configurar um item localizador de proxy
Para configurar um item localizador de proxy, siga estas etapas:
- Entre na sua organização do ArcGIS com uma conta que tenha privilégios de geocodificação.
- Na página Conteúdo, procure porAdicionar Item > De uma URL para ArcGIS Online, ou Adicionar Item > A partir da web para ArcGIS Enterprise, e assegure que o tipo selecionado seja Serviço da web do ArcGIS Server.
- Use a URL do localizador pretendido, por exemplo, https://geocode.arcgis.com/arcgis/rest/services/World/GeocodeServer para o Serviço do ArcGIS Geocoding.
Isto será detectado como um serviço protegido.
- Adicione um nome de usuário e senha para uma conta do ArcGIS com privilégios de geocodificação.
- Escolha Armazenar credenciais com item de serviço. Não solicite a autenticação..
- Forneça um título e tags.
- Clique em Adicionar Item.
- Compartilhe este item de localizador online publicamente.
Para mais informações, consulte Requisitos para configurar seus próprios localizadores para ArcGIS Online ou Configurar serviços de utilitário com seu portal do ArcGIS Enterprise.
Extrair valores de ponto geográfico
Para desconstruir uma resposta de geopoint, você pode utilizar a função pulldata("@geopoint") para extrair os valores para preencher os valores de outras perguntas. O exemplo seguinte extrai o valor de precisão horizontal de uma pergunta de ponto geográfico:
pulldata("@geopoint", ${location}, "horizontalAccuracy")
A disponibilidade das propriedades do ponto geográfico é dependente de hardware. A tabela seguinte lista propriedades que podem ser derivadas de um ponto geográfico:
| Nome de propriedade | Descrição | Unidade |
|---|---|---|
| x | Longitude: um valor positivo no hemisfério oriental e um valor negativo no hemisfério ocidental. | Graus Decimais |
| y | Latitude: um valor positivo no hemisfério norte e um valor negativo no hemisfério sul. | Graus Decimais |
| z | Altitude, metros acima do nível do mar (padrão) ou altura acima de elipsóide (se selecionado nas configurações do aplicativo de campo). | Metros |
| horizontalAccuracy | Precisão horizontal das coordenadas x e y. | Metros |
| verticalAccuracy | Precisão vertical da coordenada z. | Metros |
| velocidade | Velocidade terrestre. | Metros por segundos |
| verticalSpeed | Velocidade vertical. | Metros por segundos |
| direção | Direção de viagem medido à direita do norte. | Graus Decimais |
| positionSourceType | Categoria da origem de posição. Os potenciais resultados são Desconhecido (0), Usuário (1), Localização de Sistema (2), Dispositivo Externo (3), Dispositivo de Rede (4) e Arquivo (5). | Não Aplicável |
| positionSourceInfo.antennaHeight | Altura da antena do dispositivo. A distância da antena até a superfície do solo é subtraída dos valores de altitude. | Metros |
| positionSourceInfo.altitudeType | Tipo de altitude selecionada. Resultados potenciais são altitude acima do nível médio do mar (0) e altura acima do elipsóide (1). Isto está disponível para todos os tipos de provedores de localização. | Não Aplicável |
A tabela seguinte lista propriedades adicionais que podem ser derivadas de um ponto geográfico capturado com um receptor de precisão alta:
| Nome de propriedade | Descrição | Unidade |
|---|---|---|
| magneticVariation | Ângulo entre o norte magnético e verdadeiro. | Graus Decimais |
| fixType | Tipo de correção de posição da coordenada. Os resultados potenciais são NoFix (0), GPS (1), DifferentialGPS (2), PrecisePositioningService (3), RTKFixed (4), RTKFloat (5), Estimado (6), Manual (7), Simulador (8) e SBAS (9). | Não Aplicável |
| positionSourceInfo | Informações do dispositivo como um objeto JSON. Útil para depuração e validação. Elementos individuais também podem ser retornados utilizando o nome completo do elemento. Consulte as linhas da tabela abaixo para todos os elementos disponíveis. | Não Aplicável |
| positionSourceInfo.pluginName | Nome da fonte de posição interna. Isto está disponível somente para o provedor de localização integrado do dispositivo. | Não Aplicável |
| positionSourceInfo.deviceAddress | Endereço do dispositivo. Isto está disponível somente para receptores GNSS externos. | Não Aplicável |
| positionSourceInfo.deviceName | Nome do dispositivo. Isto está disponível somente para receptores GNSS externos. | Não Aplicável |
| positionSourceInfo.deviceType | Tipo do dispositivo externo. Resultados potenciais são Desconhecidos (-1), Bluetooth (0), Porta Serial (1) e Bluetooth LE (2). Isto está disponível somente para receptores GNSS externos. | Não Aplicável |
| positionSourceInfo.networkName | Nome da fonte de posição rede. Isto está disponível somente para provedores de local da rede. | Não Aplicável |
| positionSourceInfo.networkAddress | Endereço da fonte de posição da rede. Isto está disponível somente para provedores de local da rede. | Não Aplicável |
| positionSourceInfo.networkPort | Porta da fonte de posição da rede. Isto está disponível somente para provedores de local da rede. | Não Aplicável |
| positionSourceInfo.geoidSeparationCustom | Diferença entre o elipsóide da Terra WGS-84 e nível médio do mar como definido pelo usuário nas configurações do aplicativo. | Metros |
| geoidSeparation | Diferença entre o elipsóide da Terra WGS-84 e nível médio do mar como reportado pelo receptor do GNSS. Isso às vezes é chamado de altura ortométrica. | Metros |
| accuracyType | Tipo de precisão reportada pelas propriedades horizontalAccuracy e verticalAccuracy. Os resultados potenciais são RMS (0) e DOP (1). RMS é a precisão do erro médio quadrático. Isto é calculado baseado no intervalo de confiança de 68 porcento para latitude, longitude e erros de altitude reportado no sentença de GST fornecido pelo receptor. Se o receptor não suporta GST, DOP é utilizado ao invés. DOP é diluição de precisão baseada na exatidão. Isto utiliza um valor de erro de intervalo estimado do usuário constante (UERE) para estimar precisões horizontais e verticais. | Não Aplicável |
| positionAccuracy | Erro esférico radial médio. Cerca ambos erros horizontais e verticais. | Metros |
| latitudeError | Valor de erro 1-sigma de latitude. Esta propriedade só é preenchida quando o dispositivo de posicionamento suporta sentenças GST em fluxos NMEA. | Metros |
| longitudeError | Valor de erro 1-sigma de longitude. Esta propriedade só é preenchida quando o dispositivo de posicionamento suporta sentenças GST em fluxos NMEA. | Metros |
| altitudeError | Valor de erro 1-sigma de altitude. Esta propriedade só é preenchida quando o dispositivo de posicionamento suporta sentenças GST em fluxos NMEA. | Metros |
| hdop | Diluição de Precisão Horizontal (HDOP) dos dados de Posição. | Não Aplicável |
| vdop | Diluição de Precisão Vertical (VDOP) dos dados de Posição. | Não Aplicável |
| pdop | Diluição de Precisão da Posição (PDOP) dos dados de Posição. A equação utilizada para determinar PDOP é PDOP^2 = HDOP^2 + VDOP^2. | Não Aplicável |
| differentialAge | Duração do sinal diferencial e correção utilizada pelo receptor de GPS para corrigir a posição diferencialmente. | Segundos |
| referenceStationId | ID da estação de referência diferencial (DSID) da estação utilizada pelo receptor de GPS. | Não Aplicável |
| satellitesVisible | A quantidade de satélites de posicionamento visíveis no momento de captura da localização. | Não Aplicável |
| satellitesInUse | Quantidade de satélites de posicionamento sendo utilizados para retornar os dados de posição. | Não Aplicável |
Formato das Coordenadas
A função pulldata("@geopoint") também pode ser utilizada para extrair valores de ponto geográfico e formatá-los em formatos de coordenadas adicionais:
- pulldata("@geopoint", ${location}, "DMS") retorna o ponto geográfico como graus, minutos e segundos. Isto é retornado como um objeto JSON:
{ "latitudeDegrees": 39, "latitudeHemisphere": "N", "latitudeMinutes": 57, "latitudeSeconds": 36.3, "latitudeText": "39°57'36.3\"N", "longitudeDegrees": 116, "longitudeHemisphere": "E", "longitudeMinutes": 27, "longitudeSeconds": 4, "longitudeText": "116°27'04.0\"E", "text": "39°57'36\"N 116°27'4\"E" } - pulldata("@geopoint", ${location}, "DDM") retorna o ponto geográfico como graus e minutos decimais e pulldata("@geopoint", ${location}, "DD") retorna o ponto geográfico como graus decimais. Eles também são retornados como objetos JSON e podem ter valores individuais extraídos com parâmetros adicionais da mesma maneira que os formatos de graus, minutos e segundos acima.
Os formatos de coordenadas a seguir podem ser usados com um parâmetro de precisão opcional, produzindo um valor decimal que é uma potência de 10—por exemplo, 0,01, 0,1, 1, 10 ou 100.
- pulldata("@geopoint", ${location}, "MGRS") retorna o ponto geográfico como um valor de grade do Sistema de Referência de Grade Militar (MGRS) com uma precisão de 1 metro. Ao fornecer o parâmetro opcional de precisão, a precisão pode ser alterada. Por exemplo, pulldata("@geopoint", ${location}, "MGRS", 100) retorna um valor de grade com precisão de 100 metros.
- pulldata("@geopoint", ${location}, "USNG") retorna o ponto geográfico como um valor de grade da Grade Nacional dos Estados Unidos (USNG) com uma precisão de 1 metro.
- pulldata("@geopoint", ${location}, "UTM") retorna o ponto geográfico como coordenadas de Universal Transverse Mercator (UTM) com uma precisão de 1 metro. Isto é retornado como um objeto JSON:
{ "band": "S", "easting": 452994, "northing": 4423429, "text": "50S 452994E 4423429N", "type": "UTM", "zone": 50 }
Simbologia do ponto geográfico
Uma pergunta de ponto geográfico pode exibir um símbolo personalizado para o marcador de ponto no mapa usando o parâmetro symbol na coluna body::esri:style de uma pesquisa. O parâmetro deve fornecer o nome de arquivo do símbolo personalizado, que deve ser um arquivo .png na pasta de mídia da pesquisa. Veja os seguintes exemplos:
symbol=hydrant.png
O parâmetro symbol aceita parâmetros opcionais para configurar a exibição do símbolo no mapa. Separe estes parâmetros do nome do arquivo com um ponto de interrogação e um do outro com e comercial (&). Por exemplo, o parâmetro symbol pode ter as propriedades x, ye scale, da seguinte maneira:
symbol=hydrant.png?x=0.2&y=0.7&scale=2
- O parâmetro x especifica o ponto de ancoragem horizontal do símbolo. Ele aceita um valor entre 0 (representando a borda esquerda da imagem) e 1 (representando a borda direita). Se não definido, o valor padrão será 0.5.
- O parâmetro y especifica o ponto de ancoragem vertical do símbolo. Ele aceita um valor entre 0 (representando a borda superior da imagem) e 1 (representando a borda inferior). Se não definido, o valor padrão será 1.
- O parâmetro scale especifica a escala na qual a imagem é exibida. Valores abaixo de 1 diminuem a imagem, enquanto valores acima de 1 aumentam a imagem.
O valor fornecido pode ser uma constante ou uma referência a uma pergunta, por exemplo, symbol=${symbol_question}. Expressões embutidas não são suportadas.
Sobreposições do ponto nos mapas
As localizações do ponto da primeira pergunta de ponto geográfico em uma repetição podem ser exibidas em qualquer pergunta do mapa em sua pesquisa configurando a coluna body::esri:style para uma pergunta de ponto geográfico, traçado geográfico ou forma geográfica no overlay=repeat_name. Todos os pontos capturados para a primeira pergunta de ponto geográfico nessa repetição são exibidos no mapa. Parâmetros adicionais podem ser usados para personalizar a simbologia de sobreposição.
Os seguintes parâmetros opcionais são suportados pelo estilo de sobreposição e podem ser separados por um e comercial, por exemplo, overlay=repeat_name&preview=true:
| Parâmetro | Descrição | Exemplo |
|---|---|---|
visualização | Mostra pontos de sobreposição na pergunta do mapa. O valor padrão é verdadeiro. | view=false |
visualização | Mostra pontos de sobreposição no mapa de visualiação. O valor padrão é falso. | preview=true |
ícone | O nome do símbolo de ponto a ser usado para os afinetes do mapa. Revise os símbolos disponíveis na biblioteca Símbolos de Ponto na documentação do Esri Developer . | icon=esri_pin_two |
iconColor | A cor do ícone usado para os alfinetes do mapa. Este parâmetro aceita um nome de cor padrão ou um código de cor hexadecimal. O valor padrão é preto. | iconColor=Blue |
iconOutlineColor | A cor de contorno usada para os alfinetes do mapa. Este parâmetro aceita um nome de cor padrão ou um código de cor hexadecimal. O valor padrão é branco. | iconOutlineColor=#FF4500 |
iconSize | O tamanho do ícone conforme aparece no mapa. O valor padrão é 30. | iconSize=40 |
rótulo | O nome da pergunta de pesquisa para usar como rótulo. | label=question_name |
labelColor | A cor do rótulo de um ponto. Este parâmetro aceita um nome de cor padrão ou um código de cor hexadecimal. O valor padrão é preto. | labelColor=#FFD700 |
labelOutlineColor | A cor de contorno do rótulo. Este parâmetro aceita um nome de cor padrão ou um código de cor hexadecimal. O valor padrão é branco. | labelOutlineColor=Black |
fontSize | O tamanho de fonte do rótulo de um ponto. O valor padrão é 13. | fontSize=16 |
Estilo de pergunta
Você pode configurar o mapa base, as ferramentas do mapa e a altura da pergunta para as perguntas do mapa.
Um mapa base padrão pode ser definido para perguntas de mapa individuais usando o parâmetro map na coluna body::esri:style. Por exemplo, map="World Topography" irá definir a pergunta do mapa para usar o mapa base da Topografia Mundial. Você também pode definir o parâmetro map usando o ID do item do mapa, por exemplo, map=de26a3cf4cc9451298ea173c4b324736. Este parâmetro suporta mapas online e offline, incluindo seus próprios mapas da web. Para mais informações, consulte Incluir um mapa em uma pesquisa.
A coluna body::esri:style aceita um parâmetro mapTools para controlar as ferramentas de mapa que estão disponíveis para perguntas de mapa. Se nenhum parâmetro de ferramenta de mapa for definido, todas as ferramentas serão exibidas. Os seguintes valores são aceitos:
- mapTools=search
- mapTools=mapSwitcher
- mapTools=zoom
- mapTools=home
- mapTools=locate
Várias ferramentas podem ser definidas separando cada valor com uma vírgula, por exemplo, mapTools=search,locate.
A coluna body::esri:style aceita o parâmetro height para perguntas de mapa.
Você pode definir a altura de uma pergunta fornecendo o parâmetro height com um número, e opcionalmente, uma unidade. A unidade padrão é lines, referindo-se à altura da fonte de texto de entrada atual. Por exemplo, height=5 faz com que qualquer uma destas perguntas apareça com cinco linhas de altura.
Alternativamente, você pode definir a unidade para uma porcentagem da altura da tela ou por número de pixels, adicionando-os como um sufixo ao valor sem espaço. Por exemplo, todos os seguintes valores são aceitos:
- height=5
- height=5lines
- height=25%
- height=250pixels
As ferramentas de altura e mapa podem ser definidas com um espaço entre elas, por exemplo, height=25% mapTools=search,zoom.