Você pode incluir perguntas de imagem, áudio e arquivo em pesquisas para permitir que os usuários enviem anexos com as respostas da pesquisa.
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 imagem, áudio e arquivo permitem um anexo. Ao definir sua aparência para multiline na coluna appearance, vários anexos podem ser incluídos.
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, na guia Opções no 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.
Esses tamanhos de imagem não afetam a visualização da imagem fornecida no Survey123 field app. Você pode controlar isso pelo 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 de anotação é usada, também é possível especificar method=map.
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.
As perguntas de imagem oferecem suporte a outras aparências que permitem fazer anotações em fotos, desenhar em uma tela ou escrever uma assinatura. Para mais informações, consulte Aparência.
Por padrão, o Survey123 gera automaticamente um nome de arquivo para imagens enviadas em uma pergunta. O nome do arquivo inclui o nome da pergunta como um prefixo, seguido por um número exclusivo. Para algumas perguntas, você pode personalizar os nomes dos 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.
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")
Marcas EXIF de localização comumente usadas para 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.
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
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 informações sobre como usar Spike com Survey123, consulte Aparência.
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.
Áudio
O tipo de pergunta de áudio permite que os usuários gravem e carreguem áudio no Survey123. A gravação captura um arquivo de áudio usando o formato de captura de áudio padrão do seu dispositivo. Uma barra de progresso indica quanto tempo resta para a gravação. Os usuários podem pausar ou parar a gravação a qualquer momento. Quando a gravação estiver concluída, você poderá editar o nome do arquivo selecionando-o.
Anotação:
Pausar o áudio durante a gravação no aplicativo de campo não é suportado no Android.
A capacidade de carregar um arquivo de áudio existente não é suportada no aplicativo de campo.
Por padrão, as gravações de áudio são limitadas a um tamanho máximo de arquivo de 10 MB no aplicativo de campo e 10 minutos no aplicativo da web.
Você pode definir um limite de tamanho menor 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:
O tamanho máximo de arquivo para um anexo individual enviado do Survey123 field app é 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 o tamanho máximo do arquivo.Por padrão, os arquivos de áudio são codificados em dispositivosiOS eAndroid usando o codec Advanced Audio Coding (AAC), se o dispositivo suportá-los. 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:
Os codecs suportados pelo dispositivo estão listados na página Sobre no Survey123 field app. Pressione 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 .
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.
Por padrão, o Survey123 gera automaticamente um nome de arquivo para áudio enviado em uma pergunta. O nome do arquivo inclui o nome da pergunta como um prefixo, seguido por um número exclusivo. Para algumas perguntas, você pode personalizar os nomes dos 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.
Arquivos
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.
Por padrão, uma pergunta de arquivo permite um arquivo. Use multiline para a coluna appearance topara permitir o anexo de vários arquivos a uma pergunta de arquivo.
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 .
Por padrão, o Survey123 gera automaticamente um nome de arquivo para imagens enviadas em uma pergunta. O nome do arquivo inclui o nome da pergunta como um prefixo, seguido por um número exclusivo. Você pode personalizar os nomes dos 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.
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 palavras-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 sobre imagem e nomes de arquivo padrão tiverem sido usados para anexos, poderá usar 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 sobre imagem e nomes de arquivo padrão tiverem sido usados para anexos, poderá usar Atualizar palavras-chaves do 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
Por padrão, o Survey123 gera automaticamente um nome de arquivo para imagens, áudio e arquivos, enviadas em uma pergunta. O nome do arquivo inclui o nome da pergunta como um prefixo, seguido por um número exclusivo. 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:
Nomes de arquivo personalizados são suportados para perguntas de imagem, áudio e arquivo no aplicativo da web. Nomes de arquivo personalizados são suportados para perguntas de imagem apenas no aplicativo de campo.
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 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.
No aplicativo da web, se a expressão for o parâmetro fileName ou uma edição manual do nome do arquivo resultar em uma duplicata, um número incrementado será anexado ao novo nome do arquivo.
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.