O ArcGIS Survey123 pode ser integrado a outros aplicativos usando links para abrir o aplicativo da web ou aplicativo de campo do Survey123, Survey123 Connect, ou outro aplicativo. Por exemplo, você pode criar links de aplicativos para iniciar e abrir o aplicativo de campo do Survey123 de outro aplicativo da Esri, um pop-up de mapa da web ou um simples hiperlink em um e-mail ou site. Você pode usar uma URL para baixar e abrir automaticamente uma pesquisa para edição no Survey123 Connect. Você também pode vincular a outros aplicativos do Survey123, como ArcGIS QuickCapture e ArcGIS Field Maps.
Use os padrões de URL na tabela para criar links para acesso a partir de um navegador da web ou de outro aplicativo.
| O que iniciar | De onde vincular | Padrão de URL a ser usado |
|---|---|---|
Aplicativo da web | navegador da web | Formulário de pesquisa por ID: |
Aplicativo de campo | Android e iOS | Link do aplicativo Survey123 : |
Windows, Android, um grupo seleto de aplicativos no iOS | Esquema de URL personalizado: | |
Survey123 Connect | Windows | Esquema de URL personalizado: |
Outro aplicativo | Formulário de pesquisa | Link do Survey123: Varia de acordo com o aplicativo |
Os exemplos a seguir mostram como abrir uma pesquisa específica usando estes padrões de URL:
- https://survey123.arcgis.com/share/36ff9e8c13e042a58cfce4ad87f55d19
- https://survey123.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19
- arcgis-survey123://?itemID=36ff9e8c13e042a58cfce4ad87f55d19
- arcgis-survey123connect://?portalUrl=https://www.arcgis.com&itemID=36ff9e8c13e042a58cfce4ad87f55d19
Links de aplicativos do Survey123 estão em conformidade com os requisitos definidos pelo App Store e Google Play, habilite links para mais aplicativos e ofereça suporte a links encurtados que são mais fáceis de compartilhar.
Os links de esquema da URL personalizado não podem ser encurtados e podem ser difíceis de abrir no Android. Considere apresentar links de esquemas da URL personalizados na forma de hiperlinks, semelhante ao seguinte:
<a href="arcgis-survey123://?itemID=36ff9e8c13e042a58cfce4ad87f55d19">Open survey</a>Parâmetros da URL
Você pode adicionar parâmetros de URL ao final dos links para personalizar ainda mais a forma como o aplicativo é aberto. Por exemplo, você pode definir o local padrão para uma pergunta de ponto geográfico ou preencher uma pergunta de texto.
Os parâmetros de URL começam com o caractere ? e são separados pelo caractere &. O exemplo a seguir mostra um esquema de URL personalizado, com o primeiro parâmetro (itemID) começando com o caractere ? e cada um dos parâmetros de campo subsequentes (color_1 e color_2) separados pelo caractere &.
arcgis-survey123://?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:color_1=red&field:color_2=bluePara obter mais exemplos de URLs e parâmetros de URL suportados, consulte Iniciar o aplicativo da web, Iniciar o aplicativo de campo, Inicie o Survey123 Connect, e Inicie outro aplicativo do Survey123.
Anotação:
Antes de usar um link que contenha parâmetros para iniciar uma pesquisa no aplicativo de campo, é recomendado que o aplicativo já esteja instalado no dispositivo. Para mais informações, consulte Instale o aplicativo de campo Survey123 .
Codificação de URL
Embora os parâmetros de URL que não são codificados funcionem em alguns ambientes, é recomendável que você codifique os parâmetros da URL. A codificação substitui os caracteres inválidos pelo sinal de porcentagem (%) seguido por seu equivalente hexadecimal.
Por exemplo, o seguinte é um link do Survey123 que usa um retorno de chamada para retornar a um projeto específico no QuickCapture com parâmetros que não são codificados:
https://survey123.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19&callback=https://quickcapture.arcgis.app?itemID=867895a71a1840399476fc717e76bb43A seguinte é a mesma URL com parâmetros codificados:
https://survey123.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19&callback=https%3A%2F%2Fquickcapture.arcgis.app%3FitemID=867895a71a1840399476fc717e76bb43Um sinal de igual que especifica uma quebra entre uma chave e seu valor não deve ser codificado.
Dica:
Uma maneira de criar parâmetros codificados é usar ArcGIS Arcade. A função UrlEncode permite definir uma coleção de pares de valores-chaves que representam cada parâmetro e produzem uma URL com a codificação apropriada.
Um autor de pesquisa também pode desejar ocultar os parâmetros da URL para que dados confidenciais não sejam visíveis na URL. Nesse caso, ao criar uma URL para usar no aplicativo da web, inclua encodeUrlParams=true. Para obter mais informações, consulte Parâmetros de URL para abrir o aplicativo da web.