O ArcGIS Survey123 pode ser integrado a outros aplicativos utilizando links para iniciar o componente específico do aplicativo. Por exemplo, você pode criar links de aplicativos para iniciar e abrir o aplicativo do Survey123 Mobile 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.
Dica:
O Survey123 Mobile abre links de três aplicativos: Survey123 Mobile, o aplicativo de campo Survey123 e QuickCapture. Quando qualquer um desses links é aberto no Survey123 Mobile (por meio de Usar um link, Ler um código QR, ou de um link dentro de uma pesquisa ou projeto do QuickCapture), ele é aberto no Survey123 Mobile. Para informações, consulte Abrir conteúdo.
Use os padrões de URL na tabela para criar links para acesso a partir de um navegador da web ou de outro aplicativo. Os exemplos incluídos mostram como abrir uma pesquisa específica usando esses padrões de URL.
| O que iniciar | De onde vincular | Padrão de URL a ser usado |
|---|---|---|
| Survey123 Mobile | Android iOS | Link do aplicativo Survey123 1: Exemplo: |
Windows Android iOS2 | Esquema de URL personalizado3: Exemplo: | |
Aplicativo da web | navegador da web | Formulário de pesquisa por ID: Exemplo: |
Aplicativo de campo | Android iOS | Link do aplicativo Survey123 1: Exemplo: |
Windows Android iOS2 | Esquema de URL personalizado3: Exemplo: | |
| Survey123 Studio | Windows | Esquema de URL personalizado3: Exemplo: |
Survey123 Connect | Windows | Esquema de URL personalizado3: Exemplo: |
Outro aplicativo | Formulário de pesquisa | Link do Survey123: Varia de acordo com o aplicativo |
1—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.
2—Nos dispositivos iOS, esquemas de URL personalizados são aprovados apenas para um grupo seleto de aplicativos.
3—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-mobile://?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-mobile://?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:color_1=red&field:color_2=bluePara obter mais exemplos de URLs e parâmetros de URL suportados, consulte Iniciar Survey123 Mobile, Funções de recursos | ArcGIS Arcade | Esri Developer, Inicie o aplicativo da web, Inicie o aplicativo da web, Inicie Survey123 Connect, e Abrir outro aplicativo a partir do Survey123.
Anotação:
Antes de usar um link que contenha parâmetros para iniciar uma pesquisa no Survey123 Mobile ou no aplicativo de campo, recomenda-se que o aplicativo já esteja instalado no dispositivo. Para mais informações, consulte Instalar ArcGIS 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-mobile.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19&callback=https://quickcapture.arcgis.app?itemID=867895a71a1840399476fc717e76bb43A seguinte é a mesma URL com parâmetros codificados:
https://survey123-mobile.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.