As perguntas de traçado geográfico e forma geográfica permitem a você capturar uma polilinha ou polígono em um mapa. Você pode usar esta geometria para a feição resultante na camada de feição em vez de um ponto.
Diferentemente das perguntas de ponto geográfico ou da captura de localização sem uma pergunta de localização, as perguntas de traçado geográfico e de forma geográfica não utilizam a localização do dispositivo para preencher uma resposta, embora elas utilizem a localização do dispositivo para centralizar o mapa.
Se uma pergunta de traçado geográfico ou forma geográfica não for respondida e sua geometria não for criada a partir de um padrão ou expressão, o registro de levantamento topográfico será enviado para a camada de feição com geometria nula.
Anotação:
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.
Ao capturar perguntas de localização geográfica ou forma geográfica usando um mapa, nem todas as feições do aplicativo de campo Survey123 são suportados no 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
- Opções de estilo fornecidas para perguntas de traçado geográfico e forma geográfica
- Cálculos para perguntas de traçado geográfico e forma geográfica, incluindo a função sum().
- Limites de precisão de localização e expressões de qualidade de localização
Métodos de captura
Dados de traçado geográfico e forma geográfica têm dois métodos de captura, esboço e vértice. Esboço é utilizado por padrão para pesquisas criadas a partir do zero, e vértice é utilizado por padrão para pesquisas criadas a partir de uma camada de feição existente. Você pode definir um método de captura diferente na pesquisa digitando method=sketch oumethod=vertex na coluna body::esri:style da pergunta.
Esboço
O método de esboço captura a geometria em um único movimento, com a captura completa quando o usuário para de desenhar essa única linha.
Para obter mais informações sobre como usar esse método, consulte Esboço.
Vértice
O método Vértice permite a captura geométrica mais precisa de uma linha ou forma colocando vértices que se conectam.
Para obter mais informações sobre como usar esse método, consulte Vértice.
A seguir estão os parâmetros que controlam o comportamento ao capturar vértices:
- beep ou nobeep—Quando beep é definido, um comentário audível é fornecido cada vez que um vértice é capturado. Quando esse parâmetro não é incluído, o padrão é nobeep.
- haptic ou nohaptic—Quando haptic é definido, o comentário háptico é fornecido cada vez que um vértice é capturado. Isso é suportado apenas em hardware que suporta comentário tátil. Quando esse parâmetro não é incluído, o padrão é nohaptic.
- edit ou noedit—Quando noedit é definido, os usuários só podem capturar vértices em sua localização atual, desfazer cada posicionamento de vértice e substituir toda a linha ou polígono. Os usuários não podem editar um vértice individual. Quando esse parâmetro não é incluído, o padrão é edit.
- streaming ounostreaming—Os vértices de linha ou polígono podem ser transmitidos à medida que você se move. Quando esse parâmetro não é incluído, o padrão é nostreaming.
O exemplo a seguir define o método de captura como reprodução de vértice com comentário audível:
method=vertex,streaming,beep
O autor da pesquisa pode configurar a distância entre vértices adjacentes transmitidos. Por padrão, os vértices são capturados a cada 10 metros, mas isso pode ser modificado usando o parâmetro distanceThreshold. Este parâmetro é separado por um espaço na coluna body::esri:style. Outros parâmetros que definem a cor da linha ou da forma também podem ser incluídos.
O exemplo a seguir irá capturar vértices a cada 25 metros e criar uma linha vermelha:
method=vertex,streaming,beep distanceThreshold=25 lineColor=red
Se a precisão da posição for importante para os vértices capturados, inserir um valor de limite de precisão na coluna body::accuracyThreshold da pergunta de traçado geográfico ou forma geográfica impedirá que os vértices sejam capturados, a menos que a condição de limite seja atendida.
Padrões e expressões
Você pode definir a geometria padrão para uma pergunta de traçado geográfico ou de forma geográfica ou utilizar uma expressão para criar a geometria utilizando os resultados de outras perguntas. Os vértices individuais que compõem a resposta a uma pergunta de traçado geográfico ou forma geográfica são conjuntos de valores de latitude e longitude (em graus decimais) separados por espaço e ponto-e-vírgula. Para preencher a resposta de uma pergunta de traçado geográfico ou forma geográfica, você precisa deve aderir a esta estrutura para produzir uma resposta válida. Para obter localizações precisas, esses valores podem precisar ser grandes. Por exemplo, os seguintes valores fornecidos na coluna padrão de uma pergunta de forma geográfica desenharão a forma em torno de um parque em Melbourne, na Austrália:
-37.842156723211474 144.95942945338243; -37.83554486071995 144.9726235713864; -37.85681405373047 144.98240735651922; -37.85954045531896 144.97715349053766
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.
Pelo fato de não ser possível inserir estes valores diretamente ao preencher as perguntas de select_one, é recomendado a você utilizar a função substr() na coluna de cálculo para ajudar a construir uma resposta válida. Por exemplo, o nome de uma resposta em uma pergunta select_one pode ser o seguinte:
+059.38330_+018.66300
Esta resposta utiliza um número fixo de caracteres para latitude e longitude, incluindo zeros que normalmente seriam truncados e um sublinhado colocado entre os dois valores, pois espaços não são permitidos na coluna de nome. Isto cria um valor que pode ser desconstruído com a função substr() para preencher o seguinte exemplo de uma pergunta de traçado geográfico com dois vértices:
substr(${previous_question1}, 0, 10) + " " + substr(${previous_question1}, -10) + "; " + substr(${previous_question2}, 0, 10) + " " + substr(${previous_question2}, -10)
Este exemplo pega os 10 primeiros caracteres de dois valores diferentes (as latitudes) e os últimos 10 caracteres (longitudes) e apresenta a eles um espaço que separa latitudes e longitudes e um ponto-e-vírgula que separa os locais válidos, para produzir um resultado de traçado geográfico válido.
Você também pode utilizar a função de agregar sum() para agrupar vários valores de ponto geográfico em uma repetição para utilizá-los como vértices para um traçado geográfico ou forma geográfica resultante. Isto permite que os usuários capturem metadados de localização para todos os vértices da geometria. Para mais informações, consulte Funções de Agregar.
Embora uma localização não seja imediatamente capturada por uma pergunta de forma geográfica ou traçado geográfico, a localização do dispositivo é usada para centralizar o mapa ao carregar a pesquisa. Para evitar isso, defina o valor padrão como null. Ao invés, exibirá opções para habilitar a captura de localização, carregar a página de mapa para configuração manual de uma localização ou atualizar um cálculo se houver um cálculo aplicado à pergunta.
Geopesquisa
As perguntas de traçado geográfico e forma geográfica incluem funcionalidade de pesquisa geográfica, permitindo aos usuários pesquisar um endereço ou ponto de interesse e fazer com que o mapa amplie e coloque um vértice neste local.
Por padrão, a funcionalidade de pesquisa geográfica retorna resultados de todo o mundo, usando o ArcGIS World Geocoding Service para procurar os endereços.
Anotação:
A geocodificação usando ArcGIS World Geocoding Service 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.
Atributos geométricos
Você pode utilizar perguntas de traçado geográfico e forma geográfica em cálculos para exibir e registrar atributos da geometria, como comprimento (para traçado geográfico) e perímetro e área (para forma geográfica). As funções distance() e area() são utilizadas para criar uma expressão com a pergunta de traçado geográfico e forma geográfica. A função distance() retorna um resultado em metros e a função area() retorna um resultado em metros quadrados. Consulte a amostra de traçado geográfico e forma geográfica no Survey123 Connect para obter exemplos de cálculos que convertem esses resultados em outras unidades.
Simbologia da geometria
Você pode adicionar estilo às perguntas de traçado geográfico e de forma geográfica que serão exibidas na pesquisa. Você pode definir esse estilo usando os seguintes parâmetros na coluna body::esri:style das perguntas de traçado geográfico e forma geográfica:
- lineColor
- lineWidth
- fillColor
As cores podem ser especificadas por nomes de cores HTML padrão ou códigos de cores hexadecimais. Você pode usar códigos de cores hexadecimais de oito caracteres para definir a opacidade. Vários parâmetros são separados por um espaço, por exemplo, lineColor=Black fillColor=#800000FF lineWidth=3.
Anotação:
Os parâmetros lineColor e lineWidth são suportados por perguntas de traçado geográfico e forma geográfica. O parâmetro fillColor é suportado somente para perguntas de forma geográfica.
Essas opções de estilo somente são exibidas no Survey123 Connect e o aplicativo de campo Survey123.
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.
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.