Skip to main content

Parámetros de la URL

Se pueden agregar parámetros a la URL de un elemento de ArcGIS StoryMaps para modificar su comportamiento o activar entidades específicas. Deben agregarse a una URL de ArcGIS StoryMaps usando la siguiente convención:

[baseURL] + ? + [parameter1] + & + [parameter2] + & + [parameter3] + & + ...

URL de base

Las URL de base son los extremos del servidor que ArcGIS StoryMaps utiliza para acceder a recursos y funcionalidades. Las tres URL de base que admiten parámetros se enumeran a continuación.

Acción URL de base
Crear un nuevo elemento https://storymaps.arcgis.com/[storymap-type]/new
Editar un elemento (builder) https://storymaps.arcgis.com/[storymap-type]/[storymap-itemID]/edit
Ver un elemento (visor) https://storymaps.arcgis.com/[storymap-type]/[storymap-itemID]

Notas:

  • Los [storymap-type] pueden ser stories, briefings, frames, collections, templates o themes.

  • El [storymap-itemID] puede ser el Id. de un elemento de ArcGIS de tipo StoryMap o StoryMap theme.

  • Actualmente no hay forma de ver un tema.

Importante:

En ArcGIS Enterprise, sustituya storymaps.arcgis.com por [your-portal-domain]/[web-adaptor-name]/apps/storymaps/.

Por ejemplo:

https://www.myorg.gov/my-portal/apps/storymaps/[storymap-type]/new

Parámetros de visualización

Los parámetros de visualización se utilizan junto con la URL de base para crear nuevos elementos de ArcGIS StoryMaps:

https://storymaps.arcgis.com/[storymap-type]/[storymap-itemID]
Parámetro Comportamiento
Valores		 Historia Informe Marco Captura
play Activar la reproducción automática true (predeterminado)
false		 ✅ ✅ ❌ ✅
speed Controlar la velocidad de reproducción automática (requiere play=true) slow
medium (predeterminado)
fast		 ✅ ✅ ❌ ✅
header Mostrar/ocultar el encabezado al ver un elemento true (predeterminado)
false		 ✅ ✅ ❌ ✅
cover Mostrar/ocultar la portada true (predeterminado)
false		 ✅ ✅ ✅ ✅
navigation Mostrar/ocultar controles de navegación true (predeterminado)
false		 ❌ ❌ ❌ ✅
item Mostrar un elemento de colección por posición numérica 1, 2, 3, ... ❌ ❌ ❌ ✅

Notas:

  • El valor predeterminado se utiliza cuando no se especifica ningún valor para un parámetro. Por ejemplo, play es lo mismo que play=true.

  • Los parámetros de URL header y cover anularán el comportamiento configurado actualmente del elemento. Por ejemplo, si una historia tiene Ocultar portada activado, cover=true puede usarse para mostrar la portada. Para obtener más información, consulte Configurar los ajustes de la historia.

  • El encabezado está oculto cuando una historia está integrada en un <iframe>, pero el parámetro header puede usarse para forzar que se muestre. El encabezado no está oculto de forma predeterminada para informes o colecciones integrados, ya que contiene elementos de navegación. Para obtener más información, consulte Integración estándar.

  • Ocultar el encabezado de un informe hará que su barra de navegación no esté disponible. Los lectores aún pueden navegar usando el teclado o un mando deslizante. El encabezado no se puede ocultar en una colección.

Ejemplos de parámetros de visualización

Los ejemplos siguientes combinan la URL de base y los parámetros de visualización para ilustrar cómo construir una URL válida para varios casos de uso típicos.

Acción
URL
Habilitar la reproducción automática a baja velocidad para un informe .../briefings/[itemID]?play&speed=slow
Ocultar el encabezado de un informe .../briefings/[storymap-itemID]?header=false
Ocultar el encabezado y la portada de una historia .../stories/[storymap-itemID]?header=false&cover=false
Ocultar el encabezado pero mostrar la portada de una historia .../stories/[storymap-itemID]?header=false&cover=true
Mostrar el quinto elemento de una colección .../collections/[storymap-itemID]?item=5

Parámetros de creación de un elemento

Los parámetros de creación de un elemento se utilizan junto con la URL de base para crear nuevos elementos de ArcGIS StoryMaps:

https://storymaps.arcgis.com/[storymap-type]/new
Parámetro		 Comportamiento
Valores		 Historia Informe Marco Captura
theme Crear un nuevo elemento de ArcGIS StoryMaps y aplicar un tema [theme-itemID] ✅ ✅ ❌ ✅
webmap Crear un nuevo elemento de ArcGIS StoryMaps y agregar un mapa web como el primer bloque [webmap-itemID] ✅ ❌ ❌ ❌
webscene Crear un nuevo elemento de ArcGIS StoryMaps y agregar una escena web como el primer bloque [webscene-itemID] ✅ ❌ ❌ ❌
template Crear una nueva historia de ArcGIS StoryMaps a partir de una plantilla [template-itemID] ✅ ❌ ❌ ❌

Ejemplos de creación de elementos

Los ejemplos siguientes combinan la URL de base y los parámetros de creación de elementos para ilustrar cómo construir una URL válida para varios casos de uso típicos.

Acción
URL
Crear un nuevo informe y aplicar un tema .../briefings/new?theme=[theme-itemID]
Crear una nueva historia con un mapa web como el primer bloque .../stories/new?webmap=[webmap-itemID]

Parámetros de inicio de sesión

El parámetro siguiente funciona con todos los tipos de elementos.

Parámetro		 Comportamiento
Valores
urlKey Dirija al usuario a la página de inicio de sesión de una organización concreta, por ejemplo, si una organización utiliza inicios de sesión empresariales. El nombre corto de su organización de ArcGIS, que es la primera parte de la URL de su organización. Consulte el ejemplo a continuación.

Ejemplo de parámetro de inicio de sesión

Acción
URL
Dirigir a los lectores para iniciar sesión en https://myorg.maps.arcgis.com .../briefings/[storymap-itemID]?urlKey=myorg
Sugerencia:

Para obtener más información sobre el uso del parámetro urlKey, consulte Compartir un StoryMap con un enlace específico de la organización.

Parámetros variables (beta)

Beta:

Los parámetros de variables están en beta. Si tiene problemas con una función beta, comparta sus comentarios en la comunidad de Esri.

Los parámetros variables solo funcionan cuando se usa ArcGIS Online y solo con historias. Los parámetros variables pueden recibir cambios disruptivos, por lo que no se recomiendan para su uso en despliegues de producción de alto perfil.

Los parámetros variables permiten pasar información a una URL de elemento de ArcGIS StoryMaps que luego está disponible para consultar en la URL del contenido integrado.

Parámetro		 Comportamiento
Valores
var_[variable_name] Define una variable llamada variable_name que puede referenciarse en URL de integración Valores proporcionados por el usuario
Importante:

Los nombres de parámetros de variables deben contener solo letras y números, deben nombrarse con el prefijo var_, y son sensibles a mayúsculas y minúsculas. Los valores de variables que contengan espacios u otros caracteres especiales deben codificarse.

Los parámetros variables pueden usarse con aplicaciones ArcGIS integradas que soportan parámetros de URL, como ArcGIS Dashboards, ArcGIS Survey123, ArcGIS Experience Builder y ArcGIS Instant Apps. También puede que sea capaz de usar parámetros variables al integrar otras aplicaciones o sitios web que no sean ArcGIS.

[¡DIVEIN] Para saber cómo funcionan los parámetros de URL en varias aplicaciones de ArcGIS y qué puede hacer con ellos, consulte los enlaces a continuación.

Ejemplos de parámetros variables

El siguiente ejemplo ilustra cómo construir URL válidas para un caso de uso típico. La primera URL muestra cómo referenciar el parámetro de la variable en una URL integrada y la segunda muestra cómo pasar un valor para la variable en la URL del elemento ArcGIS StoryMaps.

Este ejemplo utiliza una variable llamada mercury para pasar un valor de 0.25 a un parámetro numérico preconfigurado de un cuadro de mando llamado mercuryMin. El parámetro filtra la información en el cuadro de mando para mostrar solo ubicaciones que superan el resultado mínimo de un ensayo de calidad del agua.

URL del cuadro de mando (agregada a una historia con un bloque de integración):

https://www.arcgis.com/apps/dashboards/[dashboard-itemID]#mercuryMin={{$custom.mercury}}

URL del elemento de ArcGIS StoryMaps:

https://storymaps.arcgis.com/stories/[storymap-itemID]?var_mercury=0.25

Recursos adicionales