En ArcGIS Instant Apps, puede agregar parámetros URL a la URL de su aplicación al compartirla y configurar un parámetro personalizado. Puede utilizar parámetros URL para incluir instrucciones al abrir el vínculo de la aplicación. Por ejemplo, puede ampliar una aplicación a una ubicación específica o a un nivel de escala, ampliar una función con una ventana emergente y mucho más.
Estructura de los parámetros
Los parámetros se agregan al final de la URL y se formatean como par de clave-valor conectado con un signo igual (=). Para agregar parámetros, debe utilizar el símbolo et (&) para conectarlos a su URL.
Las URL de Instant Apps con parámetros utilizan la siguiente estructura:
https://<domain>/apps/instant/<Template>/index.html?<AppID>&<param1=value>&<param2=value>&<param3=value>&...Nota:
Los símbolos menor que y mayor que (<>) se utilizan en todo este tema como corchetes. No agregue los símbolos a su URL.
<Template> es la plantilla Instant Apps de su aplicación.
<AppID> es el Id. único de la aplicación web. Las plantillas de Instant Apps (como la plantilla básica utilizada a continuación) toman el Id. de la aplicación que se va a abrir como parámetro de URL:
https://example.maps.arcgis.com/apps/instant/basic/index.html?appid=6c133f9d56d64723aee1da68e704c146Para agregar varios parámetros, sepárelos con símbolos et (&):
https://example.maps.arcgis.com/apps/instant/basic/index.html?appid=6c133f9d56d64723aee1da68e704c146&locale=en¢er=-157.7118,20.7413&level=7En este ejemplo, se han agregado los parámetros locale, center y level.
Parámetros generales
Las subsecciones siguientes describen los parámetros que pueden estar disponibles en su aplicación.
Nota:
No todas las plantillas de Instant Apps admiten los siguientes parámetros. Asegúrese de probar su aplicación para comprobar que el parámetro es compatible.
Especificar una ubicación
Defina una ubicación en la que se centrará su aplicación al abrir la URL. Establezca el centro con coordenadas geográficas (x, y) con center=<x>,<y>.
A continuación, encontrará un ejemplo:
https://example.maps.arcgis.com/apps/instant/basic/index.html?appid=6c133f9d56d64723aee1da68e704c146¢er=-157.7118,20.7413La aplicación se abre en las coordenadas (-157.7118, 20.7413).
Especificar un nivel de escala
Defina un nivel de escala específico con el parámetro level. Agregue level=<zoom level value>.
A continuación, encontrará un ejemplo:
https://example.maps.arcgis.com/apps/instant/basic/index.html?appid=6c133f9d56d64723aee1da68e704c146&level=2La aplicación se abre con un nivel de zoom inferior al predeterminado de la aplicación.
Especificar una extensión
Utilice dos coordenadas geográficas (x, y) para definir la extensión de mapa. Utilice extent=<MinX>,<MinY>,<MaxX>,<MaxY>. Las primeras coordenadas (MinX, MinY) deben definir la esquina suroeste de la extensión de mapa deseada. Las segundas coordenadas (MaxX, MaxY) deben definir la esquina noreste de la extensión de mapa deseada.
A continuación, encontrará un ejemplo:
https://example.maps.arcgis.com/apps/instant/basic/index.html?appid=6c133f9d56d64723aee1da68e704c146&extent=-73.28,42.08,-68.46,42.04La aplicación se abre con la extensión de mapa deseada.
Buscar la ubicación de un elemento
Busque una ubicación o entidad al abrir la aplicación utilizando el parámetro find. El mapa se amplía hasta la coincidencia más cercana y aparece un marcador de llamada. Utilice find=<search string>.
A continuación, encontrará un ejemplo:
https://example.maps.arcgis.com/apps/instant/basic/index.html?appid=6c133f9d56d64723aee1da68e704c146&find=michiganLa aplicación se amplía hasta el estado estadounidense de Míchigan como el mejor resultado de búsqueda obtenido.
Agregar un marcador con una ventana emergente
Al abrir la URL, amplíe un marcador con una ventana emergente personalizada con el parámetro marker. El parámetro utiliza las siguientes propiedades. Para omitir una propiedad, utilice comas dobles (,,).
Nota:
Todo el parámetro debe estar codificado. La codificación de URL sustituye los caracteres por el signo de porcentaje (%) seguido de su equivalente hexadecimal (hex). Para obtener más información y codificar sus cadenas, consulte URLEncoder.io.
Las propiedades del marcador deben estar estructuradas en el siguiente orden:
marker=<x>,<y>,<WKID>,<title>,<symbol URL>,<label>- <x>,<y>: las coordenadas geográficas del marcador.
- <WKID>: referencia espacial de las coordenadas que se agregarán al mapa. Si no incluye un WKID, se utilizarán las coordenadas GCS.
- <title>: título de la ventana emergente. Si no incluye un título, la ventana emergente estará vacía.
- <symbol URL>: símbolo del punto. Si no se incluye un símbolo, se utilizará un marcador circular negro.
- <label>: texto que se incluirá en la descripción emergente.
El parámetro ampliará el marcador. Haga clic en el marcador para abrir la ventana emergente.
A continuación, encontrará un ejemplo:
https://example.maps.arcgis.com/apps/instant/basic/index.html?appid=6c133f9d56d64723aee1da68e704c146&marker=-166.50,24.77,,Papah%C4%81naumoku%C4%81kea%20Marine%20National%20Monument,,One%20of%20the%20world%27s%20largest%20protected%20areas.%20This%20monument%20is%20home%20to%20native%20cultural%20significance%20and%20protects%20critical%20endemic%20species.La URL creará un marcador y una ventana emergente en las coordenadas designadas. La ventana emergente se titula Papahānaumokuākea Marine National Monument con texto.
Cambiar el idioma de la aplicación
Configure su URL para abrir la aplicación en un idioma específico. Utilice el parámetro locale y un código de idioma ISO 639-1 de dos letras. Instant Apps admite todos los mismos idiomas que admite ArcGIS Online. Agregue locale=<language code>.
A continuación, encontrará un ejemplo:
https://example.maps.arcgis.com/apps/instant/basic/index.html?appid=6c133f9d56d64723aee1da68e704c146&locale=viLa interfaz de usuario de la aplicación ahora está configurada en vietnamita al abrirla.
Generar parámetros con Compartir
Puede crear una URL para su aplicación con parámetros generados utilizando la funcionalidad Compartir. La URL que genere puede conservar la vista actual del mapa y abrir ventanas emergentes.
Nota:
Algunas plantillas no son compatibles con la herramienta Compartir. Consulte lamatriz de herramientas de la aplicación (PDF)para ver qué plantillas son compatibles con Compartir.
Los siguientes parámetros se pueden generar automáticamente con la función Compartir:
- locale=<language code>
- center=<x>,<y>
- level=<LOD>
- selectedFeature=<feature>
El parámetro selectedFeature abre la ventana emergente de una entidad.
Para utilizar la función Compartir para crear una URL con parámetros generados, siga estos pasos:
- En el panel lateral, desactive el modo Rápido y, cuando aparezca el mensaje de confirmación, haga clic en Continuar.
- En el panel lateral, haga clic en Interactividad para abrir el panel.
- Haga clic en Compartir para abrir el menú Compartir.
- Habilite la opción Compartir. Esto habilita la herramienta Compartir en su aplicación.
- En el mapa web, configure la vista del mapa en la que desea que se abra la URL.
Además, puede seleccionar una función si desea que la URL se abra en una función seleccionada y su ventana emergente.
- Haga clic en la herramienta Compartir.
- Haga clic en Copiar vínculo para copiar la URL de su aplicación en el portapapeles.
Esta URL incluirá parámetros agregados que abrirán su aplicación en la vista y la ventana emergente de la entidad seleccionada (si está configurada). Además, esta URL siempre está codificada.
Crear un parámetro de URL personalizado
Puede crear un parámetro de URL personalizado en su aplicación Instant Apps que amplíe una entidad y muestre la ventana emergente cuando se abra la aplicación. Los parámetros de URL personalizados se pueden combinar con otros parámetros de URL y son compatibles con el visor 3D, Básico, Leyenda interactiva, Reportero y Barra lateral. Básico y Barra lateral también admiten parámetros de URL personalizados que se aplican a varias capas.
Para crear un parámetro URL personalizado, siga estos pasos:
- En el panel lateral, desactive el modo Rápido y, cuando aparezca el mensaje de confirmación, haga clic en Continuar.
- Haga clic en Configuración de búsqueda y busque el nombre del parámetro URL.
Aparecerá la configuración del parámetro URL.
- En la sección Nombre del parámetro URL, introduzca el nombre de su parámetro personalizado.
Este será el parámetro personalizado que se agregará a la URL de su aplicación.
- En la capa de búsqueda de parámetros URL, seleccione la capa de entidades de la aplicación en la que desea que se busque su parámetro personalizado.
- Junto a la capa de entidades que ha seleccionado, haga clic en Campo para abrir el menú desplegable de campos.
Seleccione el campo dentro de su capa de búsqueda en el que desea que se busque su parámetro personalizado.
- Haga clic en Hecho.
- Haga clic en Publicar para implementar las configuraciones de los parámetros personalizados.
Se ha configurado el parámetro URL personalizado. Puede agregar el parámetro personalizado con el valor identificativo de la entidad a la URL de la aplicación utilizando la estructura de <assigned name>=<field value>. Esto ampliará y mostrará la ventana emergente de una entidad designada cuando se abra la aplicación.
Por ejemplo, si el parámetro personalizado se denominó "site" y debe buscar nombres de sitios, agregue site=<site name> al final de la URL de su aplicación web para que la aplicación amplíe la entidad especificada. En esta aplicación de ejemplo de las áreas marinas protegidas de la NOAA, el siguiente parámetro ampliará el sitio del Santuario Marino Nacional de la Bahía de Monterrey y abrirá la ventana emergente de la función: site=Monterey Bay National Marine Sanctuary.
La siguiente URL lo demuestra:
https://example.maps.arcgis.com/apps/instant/basic/index.html?appid=6c133f9d56d64723aee1da68e704c146&site=Monterey%20Bay%20National%20Marine%20Sanctuary