Você pode incluir perguntas que envolvam mídia (áudio, arquivos e imagens) em pesquisas para permitir que os usuários enviem anexos juntamente com suas respostas.
Dica:
Imagens e áudio também podem ser adicionados a outras perguntas em uma pesquisa para fins de referência e estilo. Para obter mais informações, consulte Adicionar mídia a uma pesquisa.
Por padrão, perguntas de mídia permitem um anexo. Para permitir múltiplos anexos, defina a aparência deles.
Por padrão, o Survey123 gera automaticamente um nome de arquivo para mídia enviada em uma pergunta. O nome do arquivo inclui o nome da pergunta como um prefixo, seguido por um número exclusivo. Você pode personalizar nomes de arquivos para torná-los mais significativos. Para mais informações, consulte Nomes de arquivo personalizados. Se os dados de pesquisa forem exportados e publicados como uma camada de feição para reutilização no Survey123, é recomendado não personalizar os nomes dos arquivos. Para mais informações, consulte Palavras-chaves.
Áudio
O tipo de pergunta de áudio permite que os usuários gravem áudio no Survey123. Uma barra de progresso indica o tempo restante da gravação. Os usuários podem pausar ou parar a gravação a qualquer momento. Após concluir a gravação, eles poderão editar o nome do arquivo.
Anotação:
No aplicativo de campo Survey123, pausar o áudio durante a gravação não é suportado no Android.
Por padrão, as gravações de áudio são limitadas a um tamanho máximo de arquivo de 10 MB no Survey123 Mobile e aplicativo de campo Survey123, e 10 minutos no aplicativo da web Survey123.
Você pode definir um limite de tamanho diferente em megabytes usando o parâmetro max-size na coluna bind::esri:parameters. A gravação será interrompida automaticamente quando o tamanho de arquivo máximo for atingido. Por exemplo, max-size=5 permite aos usuários gravar até 5 MB de áudio.
Como alternativa, você pode especificar um limite de tempo em segundos usando o parâmetro max-duration na coluna bind::esri:parameters. A gravação será interrompida automaticamente quando a duração máxima for atingida. Por exemplo, max-duration=30 permitirá aos usuários gravar até 30 segundos de áudio.
Aviso:
No aplicativo de campo Survey123, o tamanho máximo de arquivo para um anexo enviado individualmente é de 10 MB. Garanta que o valor max-duration ou max-size que você definiu não faça com que o arquivo de áudio exceda este tamanho máximo do arquivo.
Você pode especificar codecs de áudio preferidos usando o parâmetro codec na coluna bind::esri:parameters. Vários codecs podem ser fornecidos, separados por vírgulas, por exemplo, codec=amr-nb,aac. O primeiro codec compatível com o dispositivo será usado.
Anotação:
No Survey123 Mobile, os arquivos de áudio são codificados usando o codec Advanced Audio Coding (AAC) por padrão, caso o dispositivo ofereça suporte a ele. A seguir estão os codecs suportados para cada sistema operacional:
- Android—AAC, MP3
- iOS—AAC, ALAC, FLAC, MP3, PCM, Vorbis
- Windows—AAC, ALAC, MP3, PCM, Vorbis, WMAudioLossless, WMAudioV8, WMAudioV9
Anotação:
No aplicativo de campo Survey123, a gravação captura um arquivo de áudio usando o formato de captura de áudio padrão do seu dispositivo. Os codecs suportados pelo dispositivo estão listados na página Sobre no aplicativo. Pressione e segure o título Sobre o ArcGIS Survey123 no topo da página Sobre para revelar informações adicionais sobre o dispositivo, incluindo os codecs de áudio suportados. Em dispositivos Windows, os arquivos de áudio são sempre gravados no formato WAV não compactado.
Talvez você não consiga reproduzir alguns arquivos de áudio em um navegador da web pois nem todos os codecs são suportados pelos navegadores. Para obter mais informações sobre codecs de áudio na web, consulte a documentação da rede de desenvolvedores do Mozilla .
As perguntas de áudio permitem apenas carregar um arquivo de áudio existente no aplicativo da web. Você também pode enviar um arquivo de áudio armazenado em seu dispositivo usando um arquivo de pergunta. Para obter uma lista dos tipos de arquivos de áudio suportados, consulte Arquivos.
Arquivos
Anotação:
Esta seção descreve a funcionalidade que está disponível apenas no Survey123 Connect e aplicativo de campo Survey123. Esta funcionalidade não está disponível no Survey123 Studio ou Survey123 Mobile.
O tipo de pergunta de arquivo permite que os usuários enviem uma variedade de tipos de arquivo.
O tamanho máximo de arquivo padrão para um arquivo individual é 10 MB. Para perguntas de arquivo no Survey123 web app, você pode especificar o tamanho máximo do arquivo em megabytes usando max-size na coluna bind::esri:parameters. Por exemplo, max-size=5 permite aos usuários anexar um arquivo de até 5 MB.
Anotação:
O tamanho máximo de arquivo para um anexo individual enviado do Survey123 field app é 10 MB.
Quando aplicado às perguntas de arquivo, o parâmetro max-size é suportado somente no Survey123 web app. O tamanho máximo não pode exceder 500 MB para ArcGIS Online e 20 MB para ArcGIS Enterprise.
O tipo de pergunta de arquivo aceita todos os tipos de anexos de arquivo suportados pelo ArcGIS Online e ArcGIS Enterprise. Os tipos de arquivos suportados são como seguem:
| Categoria | Tipo de arquivo |
|---|---|
Arquivar | 7Z, GTAR, GZ, TAR, TGZ, ZIP |
Áudio | AIF, M4A, MID, MP2, MP3, MPA, RA, RAM, RMI, WAV, WMA |
Dados | CSV, GEODATABASE, GEOJSON, GML, GPKG*, JSON, MDB, PBF*, SD*, VRML, XML |
Documento | DOC, DOCX, DOT, PDF, PPT, PPTX, TXT, WPS, XLS, XLSX, XLT |
Imagem | BMP, ECW, EMF, EPS, GIF, IMG, J2K, JP2, JPC, JPE, JPEG, JPF, JPG, PNG, PS, PSD, RAW, SID, TIF, TIFF, WMF |
Vídeo | AVI, MOV, MP4, MPE, MPEG, MPG, MPV2, QT, WMV |
*Este tipo de anexo não é suportado noArcGIS Enterprise.
Você pode limitar os tipos de arquivo que podem ser submetidos a uma pergunta de arquivo usando a coluna body::accept. Esta coluna permite extensões de arquivo (por exemplo, .wav) e tipos MIME (por exemplo, audio/*). Várias extensões de arquivo ou tipos MIME podem ser definidos, separando-os com vírgulas.
Para informações sobre os formatos aceitos para tipos MIME, consulte a lista de tipos MIME comuns do Mozilla .
Imagens
O tipo de pergunta de imagem permite que os usuários enviem imagens salvas no dispositivo ou fotos tiradas com a câmera do dispositivo.
Uma foto tirada no Survey123 é salva como um arquivo .jpg, com um dependente do nível de qualidade na câmera do dispositivo. O tamanho da imagem, medido por pixels na borda mais longa, pode ser definido usando Opções no Survey123 Studio ou Survey123 Connect. Este tamanho é aplicado a todas as perguntas de imagem da pesquisa. As seguintes opções estão disponíveis:
- 320 pixels
- 640 pixels
- 1280 pixels
- 1920 pixels
- Irrestrito (Qualquer tamanho de foto pode ser anexado à pesquisa.)
Por padrão, o tamanho da imagem é 1280 pixels. As imagens enviadas que foram salvas no dispositivo mantêm o tipo de arquivo original, a resolução e a qualidade.
Estes tamanhos de imagem não afetam a visualização da imagem fornecida no Survey123 Mobile ou aplicativo de campo Survey123.
O tamanho máximo de arquivo padrão para uma imagem individual é 10 MB. Para perguntas de imagem noSurvey123 web app, você pode especificar o tamanho máximo do arquivo em megabytes usando max-size na coluna bind::esri:parameters. Por exemplo, max-size=5 permite aos usuários anexar uma imagem de até 5 MB.
Anotação:
O tamanho máximo de arquivo para um anexo individual enviado do Survey123 field app é 10 MB.
Quando aplicado à pergunta de imagem, o parâmetro max-size é suportado somente no Survey123 web app. O tamanho máximo não pode exceder 100 MB para ArcGIS Online e 20 M para ArcGIS Enterprise.
Personalizar o tamanho da imagem e método de captura
Anotação:
Esta seção descreve a funcionalidade que está disponível apenas no aplicativo de campo Survey123. Esta funcionalidade não está disponível no Survey123 Mobile.
Você pode controlar o tamanho de visualização da imagem fornecida no aplicativo de campo Survey123 com o parâmetro previewHeight. Este parâmetro oferece suporte a todos os tipos de unidade suportados pelo parâmetro height , mas a altura da imagem de visualização é limitada pela largura da tela do dispositivo e pela proporção da imagem. Utilize previewHeight=0 para definir a visualização da imagem para ser o tamanho máximo sem o espaço em branco desnecessário.
Você pode definir o tamanho máximo permitido de uma imagem para cada pergunta de imagem individual em uma pesquisa. Especifique max-pixels na coluna parameter do XLSForm para a pergunta que você deseja limitar. Por exemplo, max-pixels=100 dimensiona a imagem para baixo proporcionalmente a 100 pixels na borda mais longa. Se o parâmetro max-pixels não for especificado, o tamanho da imagem definido em Survey123 Connect será usado.
Você pode limitar uma pergunta sobre imagem a um método de captura específico, especificando method=camera ou method=browse na coluna body::esri:style do XLSForm. Você também pode definir a aparência para new-font ou new-rear para limitar uma pergunta de imagem para usar apenas imagens da câmera do dispositivo, usando a câmera frontal ou traseira, respectivamente, como padrão. Quando a aparência annotate é usada, também é possível especificar method=map.
Aparência
Você pode alterar o comportamento das pergunta e a maneira como são apresentadas definindo a aparência. Para confirmar quais aplicativos de envio oferecem suporte a uma determinada aparência, consulte a tabela Aparências.
Ao definir a coluna appearance como multiline, uma pergunta de arquivo ou imagem aceita múltiplos anexos em uma única pergunta.
Esta aparência pode ser combinada com outras aparências definindo ambas as aparências separadas por um espaço, como multiline annotate para uma pergunta de imagem.
Você pode controlar o número de arquivos ou imagens que podem ser enviadas usando a função count-selected na coluna restrição. Exemplos são os seguintes:
- O count-selected(${file_question}) <= 5 limitará o número de arquivos que podem ser enviados a um máximo de cinco.
- O count-selected(${image_question}) <= 3 limitará o número de arquivos que podem ser enviados a um máximo de três.
Ao definir a aparência para signature, uma pergunta de imagem pode ser usada para abrir uma assinatura.
Anotação:
No Survey123 Connect, você também pode definir as seguintes aparências para perguntas de imagem em pesquisas utilizadas com o aplicativo de campo Survey123:
- Ao definir a aparência como new-front ou new-rear, você pode limitar as perguntas de imagem para que utilizem somente a câmera frontal ou a câmera traseira do dispositivo, respectivamente, por padrão. Estas aparências podem ser combinadas com annotate definindo ambas as aparências separadas por um espaço, como new-front annotate.
- Ao definir a aparência como draw ou annotate, você permite que os usuários desenhem ou façam anotações em fotos.
- Ao definir a aparência para spike, uma pergunta de imagem exibe um botão para abrir o aplicativo móvel Spike e realizar a integração de Survey123 com Spike. Para mais informações, consulte Aparência de imagens do Spike .
Aparência da assinatura
Definindo a aparência para signature, uma pergunta de imagem apresenta um pop-up para capturar uma assinatura.
Uma assinatura é salva como um anexo de imagem .jpg com as mesmas dimensões do pop-up. Por padrão, a largura do pop-up se estende até a largura da tela do dispositivo, com uma altura fixa de 200 pixels. Para definir a largura máxima deste pop-up usando o parâmetro max-pixels, consulte Personalizar o tamanho da imagem e o método de captura.
Você também pode fornecer uma imagem na coluna padrão para definir um plano de fundo personalizado para a assinatura. As dimensões da imagem padrão determinam a proporção de tela do pop-up.
A largura do pop-up será a menor das seguintes:
- O valor de max-pixels
- A largura da imagem padrão
- A largura da tela do dispositivo
A altura será de 200 pixels, a menos que uma imagem padrão seja fornecida.
Ao projetar uma pesquisa usando a aparência da assinatura, certifique-se de levar em consideração o tamanho da tela de todos os dispositivos alvo.
O texto do rodapé pode ser fornecido para um pop-up da pergunta de assinatura usando o parâmetro footerText na coluna body::esri:style. Ao usar apenas o parâmetro footerText sem valor, a dica de orientação da pergunta aparecerá abaixo da assinatura. Isso pode ser alterado para a dica da pergunta usando footerText=@[hint]. A dica ou dica de orientação usada para o texto do rodapé não aparecerá no local padrão abaixo do nome da pergunta. Para obter mais informações sobre dicas, consulte Dicas.
Anotação:
O Survey123 web app não oferece suporte a múltiplas linhas, parâmetro max-pixels ou padrões quando aplicados à aparência signature.
Aparência de desenhar e anotação
Anotação:
Esta seção descreve a funcionalidade que está disponível apenas no Survey123 Connect e aplicativo de campo Survey123. Esta funcionalidade não está disponível no Survey123 Studio ou Survey123 Mobile.
Definindo a aparência para draw, uma pergunta de imagem exibe um botão para carregar uma tela para desenhar. Na paleta de ferramentas de desenho, você pode alternar entre as ferramentas de desenho e também controlar as configurações de cada ferramenta, como tamanho do texto, largura da linha, cor e assim por diante. Para obter informações sobre a interface do canvas, consulte Desenhar e anotar. Você pode criar paletas personalizadas que permitem configurar ferramentas de desenho e anotação para atender às suas necessidades. Para obter mais informações, consulte Paletas de desenhar e anotar.
Definindo a aparência para annotate, uma pergunta sobre imagem exibe um botão para abrir a câmera do dispositivo e tirar uma foto que você pode anotar com gráficos e texto. Na paleta de ferramentas de desenho, você pode alternar entre as ferramentas de desenho e também controlar as configurações de cada ferramenta, como tamanho do texto, largura da linha, cor e assim por diante. Para obter informações sobre a interface do canvas, consulte Desenhar e anotar. Você pode criar paletas personalizadas que permitem configurar ferramentas de desenho e anotação para atender às suas necessidades. Para obter mais informações, consulte Paletas de desenhar e anotar.
Dica:
No Survey123 3.13 e posterior, os dados EXIF são copiados da imagem de origem para a imagem anotada.
Como alternativa, você pode permitir que o usuário anote uma imagem existente do armazenamento do dispositivo ou uma captura instantânea de um mapa. Para fazer isso, defina body::esri:style para essa pergunta method=browse, method=camera ou method=map. O comportamento padrão para a aparência da anotação é idêntico ao fornecer method=camera. Você pode definir a pergunta para fornecer várias opções para a imagem de origem fornecendo várias opções separadas por vírgulas, por exemplo, method=camera,browse.
Aviso:
Independentemente do método definido, o aplicativo da web Survey123 exibe apenas uma opção de procura de arquivo.
Padrões e cálculos se comportam de forma diferente com perguntas de imagem utilizando draw e annotate. Se o nome do arquivo de uma imagem na pasta de mídia da pesquisa for utilizado como um valor padrão ou o resultado de um cálculo, a imagem será utilizada como um plano de fundo inicial para a tela. Com anotar, essa imagem é substituída por uma imagem fornecida e é exibida apenas se o usuário se recusar especificamente a fornecer uma imagem ou redefinir a imagem já fornecida.
Anotação:
Você pode definir a resolução de uma imagem definindo um valor max-pixels na coluna parâmetros. Para uma pergunta de desenho, a configuração max-pixels=1000 definirá a tela para uma imagem quadrada de 1000 x 1000 pixels. Para uma pergunta de anotação, a configuração max-pixels=1000 definirá o lado mais longo da imagem em 1000 pixels, preservando a proporção da imagem fornecida. Se max-pixels não estiver definido, o tamanho da imagem será definido pela configuração do tamanho da imagem nas configurações de Opções para sua pesquisa no Survey123 Connect.
Ambas estas maneiras de configuração da resolução de imagem são substituídas, fornecendo uma imagem padrão para a pergunta, caso em que a resolução da imagem padrão será aplicada. Isso pode ser usado para garantir uma resolução padrão para todas as imagens enviadas. Fornecer um instantâneo de um mapa para anotação também substituirá quaisquer outras configurações de resolução de imagem, com a imagem sendo definida para o tamanho da área de tela visível.
Aparência das imagens Spike
Anotação:
Esta seção descreve a funcionalidade que está disponível apenas no Survey123 Connect e aplicativo de campo Survey123. Esta funcionalidade não está disponível no Survey123 Studio ou Survey123 Mobile.
Anotação:
Spike a integração não é compatível com o aplicativo da web Survey123.
As perguntas de imagem suportam aparências para integrar Survey123 com Spike, uma solução de medição à laser desenvolvida pelo ikeGPS que permite capturar as medições e localização de um objeto a partir de uma foto. Definindo a aparência para spike, spike-full-measure ou spike-point-to-point, uma pergunta de imagem exibe um botão para abrir o aplicativo móvel Spike em dispositivos iOS e Android.
Uma foto tirada com o aplicativo Spike e dispositivo laser permite gravar as coordenadas e distância do objeto, e medir as dimensões dos objetos na foto ao desenhar áreas e linhas. A foto com marcação de medição é então, anexada à sua pesquisa, e os metadados da foto, como coordenadas e medições ficam disponíveis para serem gravadas. Metadados de medição e Spike associado são gravados no arquivo de imagem utilizando as tags do Exchangeable Image File (EXIF) padrão. As informações do EXIF podem então ser extraídas e utilizadas para preencher outros campos.
A diferença entre as aparências Spike é a extensão dos valores armazenados na imagem. A aparência spike mede somente a distância e localização, enquanto a aparência spike-full-measure mede distância, localização, área e comprimento. A aparência spike-point-to-point captura uma série de valores exclusivos para ela, denotados por nomes de propriedade que começam com P2P.
Para obter mais informações sobre essas tags EXIF, consulte a integração do Spike . Para mais informações sobre Spike, consulte o site da web Spike .
Extrair metadados da imagem
Você pode usar a função pulldata("@exif") para extrair tags de metadados Exchangeable Image File (EXIF) padrão da resposta para uma pergunta de imagem. A inserção do seguinte exemplo em uma pergunta decimal extrai o valor de latitude do dispositivo a partir de uma imagem:
pulldata("@exif", ${image}, "GpsLatitude")
Tags EXIF de localização comuns que você pode usar com a função pulldata("@exif") estão listadas na tabela a seguir:
| Tag de EXIF | Descrição |
|---|---|
| GpsLatitude | A latitude de localização do dispositivo como uma string |
| GpsLongitude | A longitude de localização do dispositivo como uma string |
| GpsAltitude | A altitude de localização do dispositivo como uma string |
| GpsLatitudeRef | A referência de latitude (isto é, N,S,L,O) de localização do dispositivo como uma string |
| GpsLongitudeRef | A referência de longitude (isto é, N,S,L,O) de localização do dispositivo como uma string |
| GpsDestDistance | A distância entre o dispositivo e os locais de destino, em quilômetros, como um número inteiro |
| GpsImgDirection | A direção até o local de destino a partir da localização do dispositivo como uma string |
| GpsDestLatitude | A latitude do local de destino como uma string |
| GpsDestLongitude | A longitude do local de destino como uma string |
| GpsDestLatitudeRef | A referência de latitude (isto é, N,S,L,O) do local de destino como uma string |
| GpsDestLongitudeRef | A referência de longitude (isto é, N,S,L,O) do local de destino como uma string |
Você pode usar o seguinte exemplo para exibir os valores de latitude e longitude em um único campo, que pode então usar para preencher uma pergunta de ponto geográfico:
string(pulldata("@exif", ${image}, "GpsLatitude")) + " " + string(pulldata("@exif", ${image}, "GpsLongitude"))
Outras tags EXIF de imagem que podem ser extraídas por Survey123 são listadas abaixo. Dependendo do hardware sendo usado, nem todas estas tags estarão disponíveis.
| Tag de EXIF | ||
|---|---|---|
GpsAltitudeRef | GpsTimeStamp | GpsSatellites |
GpsStatus | GpsMeasureMode | GpsDop |
GpsSpeedRef | GpsSpeed | GpsTrackRef |
GpsTrack | GpsImgDirectionRef | GpsMapDatum |
GpsDestBearingRef | GpsDestBearing | GpsDestDistanceRef |
GpsProcessingMethod | GpsAreaInformation | GpsDateStamp |
GpsVersionId | GpsDifferential | GpsHPositioningError |
ImageWidth | ImageLength | ImageBitsPerSample |
ImageCompression | ImagePhotometricInterpretation | ImageDescription |
ImageMake | ImageModel | ImageStripOffsets |
ImageOrientation | ImageSamplesPerPixel | ImageRowsPerStrip |
ImageStripByteCounts | ImageXResolution | ImageYResolution |
ImagePlanarConfiguration | ImageResolutionUnit | ImageTransferFunction |
ImageSoftware | ImageDateTime | ImageArtist |
ImageWhitePoint | ImagePrimaryChromaticities | ImageYCbCrCoefficients |
ImageYCbCrSubSampling | ImageYCbCrPosition | ImageReferenceBlackWhite |
ImageRating | ImageRatingPercent | ImageCopyright |
ImageXPTitle | ImageXPComment | ImageXPAuthor |
ImageXPKeywords | ImageXPSubject | ImageLensSpecification |
ImageLensModel | ImageLensMake | ImageLensSerialNumber |
ExtendedSubjectDistanceRange | ExtendedExposureTime | ExtendedFNumber |
ExtendedExposureProgram | ExtendedSpectralSensitivity | ExtendedISOSpeedRatings |
ExtendedOecf | ExtendedExifVersion | ExtendedDateTimeOriginal |
ExtendedDateTimeDigitized | ExtendedComponentsConfiguration | ExtendedCompressedBitsPerPixel |
ExtendedShutterSpeedValue | ExtendedApertureValue | ExtendedBrightnessValue |
ExtendedExposureBiasValue | ExtendedMaxApertureValue | ExtendedSubjectDistance |
ExtendedMeteringMode | ExtendedLightSource | ExtendedFlash |
ExtendedFocalLength | ExtendedSubjectArea | ExtendedMakerNote |
ExtendedUserComment | ExtendedSubSecTime | ExtendedSubSecTimeOriginal |
ExtendedSubSecTimeDigitized | ExtendedFlashPixVersion | ExtendedColorSpace |
ExtendedPixelXDimension | ExtendedPixelYDimension | ExtendedRelatedSoundFile |
ExtendedFlashEnergy | ExtendedSpatialFrequencyResponse | ExtendedFocalPlaneXResolution |
ExtendedFocalPlaneYResolution | ExtendedFocalPlaneResolutionUnit | ExtendedSubjectLocation |
ExtendedExposureIndex | ExtendedSensingMethod | ExtendedFileSource |
ExtendedSceneType | ExtendedCfaPattern | ExtendedCustomRendered |
ExtendedExposureMode | ExtendedWhiteBalance | ExtendedDigitalZoomRatio |
ExtendedFocalLengthIn35mmFilm | ExtendedSceneCaptureType | ExtendedGainControl |
ExtendedContrast | ExtendedSaturation | ExtendedSharpness |
ExtendedDeviceSettingDescription | ExtendedImageUniqueId | |
Para visualizar estas tags em detalhes, consulte o exemplo EXIF no Survey123 Connect.
Aviso:
Se uma pergunta de imagem tiver várias imagens, você não poderá extrair os dados EXIF das imagens usando a função pulldata("@exif"). Para extrair dados EXIF de várias imagens enviadas para a mesma pergunta, considere usar uma repetição.
Integração do Spike
Anotação:
Esta seção descreve uma funcionalidade que está disponível apenas no Survey123 Connect. Esta funcionalidade não está disponível no Survey123 Studio.
As perguntas de imagem também suportam integração com Spike, uma solução de medição à laser desenvolvida pelo ikeGPS que permite a você capturar as medições e localização de um objeto a partir de uma foto. Para obter informações sobre como usar Spike com Survey123, consulte a aparência de imagens Spike.
O Spike registra uma série de tags personalizadas adicionais gravando um objeto JSON na tag ImageDescription do EXIF contendo propriedades não padrão relacionadas ao dispositivo Spike e as medições obtidas por ele. As tags são descritas na seguinte tabela:
| Tag Spike | Descrição |
|---|---|
| device_id | O ID do dispositivo Spike como uma string |
| local_accuracy | A precisão do dispositivo Spike como um decimal |
| destination_altitude | A altitude do local de destino como um número racional |
| declination | A declinação do dispositivo Spike como um número racional |
| pitch | A inclinação do dispositivo Spike como um número racional |
| rotation | A rotação do dispositivo Spike como uma string |
| objects | Um conjunto JSON de objetos medidos (área e comprimentos) como uma string |
| P2P.capture_id | O ID de duas imagens do processo de ponto a ponto como uma string |
| P2P.horizontal_distance | A distância horizontal entre os dois pontos em metros |
| P2P.distance | A distância entre os dois pontos em metros |
| P2P.gradient | O gradiente entre os dois pontos em graus |
| P2P.vertical_distance | A distância vertical entre os dois pontos em metros |
| P2P.azimuth | O azimute dos dois pontos em graus |
Para acessar estas tags do Spike, primeiro extraia o objeto JSON armazenado no EXIF utilizando pulldata("@exif") na propriedade objects como segue:
pulldata("@exif", ${image}, "objects")
Após este objeto JSON estar em outro campo, você poderá utilizar o caminho de nome do objeto Spike. em uma função pulldata("@json") para extrair um valor específico do conjunto JSON. Para obter mais informações sobre a função pulldata("@json"), consulte Recuperar um valor de JSON. O seguinte exemplo extrai a inclinação do dispositivo Spike a partir da pergunta com o conjunto dentro dele:
pulldata("@json", ${spikedata}, "Spike.pitch")
O conjunto objects também contém as áreas e os comprimentos capturados pelo dispositivo Spike. Este conjunto contém os objetos medidos na imagem, incluindo formas e linhas, como também, uma forma de alinhamento utilizada para a transformação da imagem. Os objetos no conjunto podem ser extraídos consultando sua posição no conjunto, um pedido que corresponde à ordem na qual foram capturados. O seguinte exemplo retorna a primeira área ou linha no conjunto:
pulldata("@json", ${spikedata}, "Spike.objects[1].type")
Anotação:
A posição 0 no conjunto sempre contém a forma de alinhamento.
Para retornar a quantidade de objetos presentes no conjunto, utilize a propriedade length como segue:
pulldata("@json", ${spikedata}, "Spike.objects.length")
Para visualizar exemplos destas tags em uso, consulte a pesquisa de amostra do Spike no Survey123 Connect. Para mais informações sobre o Spike, consulte a página de produtos da ikeGPS.
Palavras-Chaves
O Survey123 usa palavras-chave de anexo para associar anexos a perguntas específicas em uma pesquisa. Quando você cria uma pergunta de imagem, áudio ou arquivo em uma pesquisa e a publica, o nome da pergunta é usado como a palavra-chave na tabela de anexos. Por exemplo, se uma pesquisa tiver perguntas de imagem denominadas image_closeup e image_wideview, o valor armazenado na coluna KEYWORDS da tabela de anexos será image_closeup ou image_wideview para cada foto. O Survey123 corresponde automaticamente à palavra-chave do anexo com o nome da pergunta para associar anexos a perguntas.
O objetivo da associação de palavra-chave é mais evidente ao imprimir relatórios, o Survey123 garantirá que a foto correta seja impressa como resposta à pergunta correta na pesquisa. A associação de palavra-chave também é usada para permitir a edição de imagens na caixa de entrada.
Se você alterar o nome de uma pergunta de imagem e republicar a pesquisa, também deverá alterar a palavra-chave de quaisquer registros anexos existentes.
Aviso:
Quando os dados Survey123 forem exportados, a coluna KEYWORDS da tabela de anexos não será retida.
Se esses dados forem republicados como um serviço da feição hospedado, você tiver uma pergunta de imagem e nomes de arquivo padrão tiverem sido usados para anexos, poderá usar a opção Atualizar palavras-chaves de anexo do notebook Python para preencher novamente a coluna KEYWORDS. Se você tiver mais de uma pergunta de imagem em sua pesquisa, não poderá usar o notebook e deverá determinar manualmente qual arquivo está associado a qual pergunta e inserir o nome da pergunta na coluna KEYWORDS para cada registro de anexo. Para mais informações, consulte Suporte Técnico
Se os dados forem republicados como um serviço da feição ArcGIS Server, você deverá primeiro adicionar a coluna KEYWORDS à tabela de anexos. Você pode usar a ferramenta Atualizar Anexos para adicionar esta coluna. Se você tiver uma pergunta de imagem e nomes de arquivo padrão tiverem sido usados para anexos, poderá usar a opção Atualizar palavras-chaves de anexo do notebook Python para preencher novamente a coluna KEYWORDS. Se você tiver mais de uma pergunta de imagem em sua pesquisa, não poderá usar o notebook e deverá determinar manualmente qual arquivo está associado a qual pergunta e inserir o nome da pergunta na coluna KEYWORDS para cada registro de anexo. Para mais informações, consulte Suporte Técnico
Em qualquer ambiente, na próxima vez que você visualizar esses registros no Survey123, o valor da palavra-chave na tabela de anexos corresponderá ao nome da pergunta e a associação será realizada automaticamente.
Nomes de arquivo personalizados
Anotação:
Esta seção descreve a funcionalidade que está disponível apenas no Survey123 Connect e aplicativo de campo Survey123. Esta funcionalidade não está disponível no Survey123 Studio ou Survey123 Mobile.
Por padrão, o Survey123 gera automaticamente um nome de arquivo para mídia enviada em uma pergunta. Você pode personalizar os nomes dos arquivos para torná-los mais significativos. Por exemplo, você pode incluir o nome e o sobrenome do signatário em um nome do arquivo de assinatura. Para uma foto, você pode incluir a data ou uma descrição do objeto que está fotografando.
Aviso:
No aplicativo da web, os nomes de arquivo personalizados são suportados em perguntas de imagem, áudio e arquivo. No aplicativo de campo, os nomes de arquivo personalizados são suportados somente em perguntas de imagem.
Os nomes de arquivo personalizados são definidos conforme o arquivo é adicionado a uma pergunta de mídia e não são atualizados automaticamente para refletir as alterações subsequentes na pesquisa. Por exemplo, se um nome de arquivo fizer referência a uma pergunta de texto e o valor dessa pergunta mudar após o arquivo for adicionado, o nome do arquivo não será atualizado para refletir a mudança.
Você pode usar o parâmetro fileName na coluna bind::esri:parameters para definir dinamicamente o nome do arquivo para um arquivo que será criado. No exemplo a seguir, um nome de arquivo de imagem semelhante a ASSET406-20221018145109.jpg é criado a partir da pergunta asset_id e a data e hora atuais:
Para obter mais exemplos de sintaxe, consulte a amostra Imagens e Anotação no Survey123 Connect.
Os nomes dos arquivos devem seguir o seguinte:
- Os nomes dos arquivos devem ser exclusivos para todas as perguntas em todas as pesquisas no dispositivo. A pasta Meus Anexos de Pesquisa armazena todas as imagens de todas as pesquisas no dispositivo e não pode conter nomes de arquivo duplicados. Para garantir que os nomes de arquivo sejam exclusivos, considere usar uma função como now() na expressão fileName.
- Os nomes de arquivo não podem ter mais de 140 caracteres.
- Os nomes de arquivo não podem conter espaços ou os seguintes caracteres especiais: \ / : * ? < > ; | . , ". Espaços e caracteres especiais serão substituídos por um sublinhado.
Aviso:
No aplicativo da web, se a expressão for o parâmetro fileName ou uma edição manual de nome do arquivo resultar em uma duplicata, um número incrementado será anexado ao novo nome do arquivo.
No aplicativo de campo, se a expressão para o parâmetro fileName resultar em um nome de arquivo duplicado ou que exceda o comprimento máximo, será usado o nome de arquivo gerado automaticamente para a imagem. Da mesma forma, se os usuários editarem manualmente o nome do arquivo na pesquisa, o nome do arquivo não será aceito se for duplicado ou exceder o comprimento máximo.
Os seguintes parâmetros podem ser aplicados na coluna body::esri:style para uma pergunta para controlar ainda mais os nomes dos arquivos:
- fileNameVisible—Especifica se o nome do arquivo ficará visível na pesquisa. O padrão é true. Para ocultar o nome do arquivo, digite fileNameVisible=false.
- allowRename—Especifica se os usuários têm permissão para editar o nome do arquivo manualmente. O padrão é true. Os usuários não podem editar o nome do arquivo quando fileNameVisible=false, mesmo se allowRename=true.