Skip to main content

Paramètres URL

Des paramètres peuvent être ajoutés à l’URL d’un élément ArcGIS StoryMaps pour modifier son comportement ou activer des fonctionnalités spécifiques. Ils doivent être ajoutés à une URL ArcGIS StoryMaps selon la convention suivante :

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

URL de base

Les URL de base sont les points de terminaison serveur qu’ArcGIS StoryMaps utilise pour accéder aux ressources et aux fonctions. Les trois URL de base qui prennent en charge les paramètres sont répertoriées ci-dessous.

Opération URL de base
Créer un nouvel élément https://storymaps.arcgis.com/[storymap-type]/new
Modifier un élément (générateur) https://storymaps.arcgis.com/[storymap-type]/[storymap-itemID]/edit
Afficher un élément (visionneuse) https://storymaps.arcgis.com/[storymap-type]/[storymap-itemID]

Remarques :

  • Le [storymap-type] peut correspondre à stories, briefings, frames, collections, templates, ou themes.

  • Le [storymap-itemID] est l’ID d’un élément ArcGIS de type StoryMap ou StoryMap theme.

  • Il n’est actuellement pas possible d’afficher un thème.

Important :

Sur ArcGIS Enterprise, remplacez storymaps.arcgis.com par [your-portal-domain]/[web-adaptor-name]/apps/storymaps/.

Par exemple :

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

Paramètres d’affichage

Ces paramètres d’affichage sont utilisés avec l’URL de base pour visualiser des éléments ArcGIS StoryMaps :

https://storymaps.arcgis.com/[storymap-type]/[storymap-itemID]
Paramètre Comportement
Valeurs		 Récit Briefing Fenêtre Collection
play Activer la lecture automatique true (par défaut)
false		 ✅ ✅ ❌ ✅
speed Contrôler la vitesse de lecture automatique (nécessite play=true) slow
medium (par défaut)
fast		 ✅ ✅ ❌ ✅
header Afficher/masquer l’en-tête lors de l’affichage d’un élément true (par défaut)
false		 ✅ ✅ ❌ ✅
cover Afficher/masquer la couverture true (par défaut)
false		 ✅ ✅ ✅ ✅
navigation Afficher/masquer les contrôles de navigation true (par défaut)
false		 ❌ ❌ ❌ ✅
item Afficher un élément de collection par position numérique 1, 2, 3, ... ❌ ❌ ❌ ✅

Remarques :

  • La valeur par défaut est utilisée si aucune valeur n’est spécifiée pour un paramètre. Par exemple, play est identique à play=true.

  • Les paramètres d’URL header et cover remplaceront le comportement actuellement configuré de l’élément. Par exemple, si le paramètre Hide cover (Masquer la couverture) est activé pour un récit, cover=true peut servir à afficher la couverture. Pour plus d’informations, reportez-vous à la rubrique Configurer les paramètres d’un récit.

  • L’en-tête est masqué lorsqu’un récit est intégré à un <iframe>, mais le paramètre header peut être utilisé pour forcer son affichage. L’en-tête n’est pas masqué par défaut pour les briefings ou collections intégrés puisqu’il contient des éléments de navigation. Pour plus d’informations, consultez Intégration standard.

  • Masquer l’en-tête d’un briefing rendra indisponible sa barre d’outils de navigation. Les utilisateurs peuvent toujours passer d’une diapositive à l’autre à l’aide du clavier ou d’une télécommande. L’en-tête ne peut pas être masqué pour une collection.

Exemples de paramètres d’affichage

Les exemples ci-dessous combinent l’URL de base et des paramètres d’affichage afin d’illustrer comment construire une URL valide pour certains cas d’usage typiques.

Opération
URL
Activer la lecture automatique à vitesse lente pour un briefing .../briefings/[itemID]?play&speed=slow
Masquer l’en-tête d’un briefing .../briefings/[storymap-itemID]?header=false
Masquer l’en-tête et la couverture d’un récit .../stories/[storymap-itemID]?header=false&cover=false
Masquer l’en-tête, mais afficher la couverture d’un récit .../stories/[storymap-itemID]?header=false&cover=true
Afficher le cinquième élément d’une collection .../collections/[storymap-itemID]?item=5

Paramètres de création d’élément

Ces paramètres de création d’élément sont utilisés avec l’URL de base pour créer des éléments ArcGIS StoryMaps :

https://storymaps.arcgis.com/[storymap-type]/new
Paramètre		 Comportement
Valeurs		 Récit Briefing Fenêtre Collection
theme Créer un nouvel élément ArcGIS StoryMaps et appliquer un thème [theme-itemID] ✅ ✅ ❌ ✅
webmap Créer un récit ArcGIS StoryMaps et ajouter une carte Web comme premier bloc [webmap-itemID] ✅ ❌ ❌ ❌
webscene Créer un récit ArcGIS StoryMaps et ajouter une scène Web comme premier bloc [webscene-itemID] ✅ ❌ ❌ ❌
template Créer un récit ArcGIS StoryMaps à partir d’un modèle [template-itemID] ✅ ❌ ❌ ❌

Exemples de création d’élément

Les exemples ci-dessous combinent l’URL de base et des paramètres de création d’élément afin d’illustrer comment construire une URL valide pour certains cas d’usage typiques.

Opération
URL
Créer un briefing et appliquer un thème .../briefings/new?theme=[theme-itemID]
Créer un récit avec une carte Web comme premier bloc .../stories/new?webmap=[webmap-itemID]

Paramètres de connexion

Le paramètre ci-dessous fonctionne avec tous les types d’éléments.

Paramètre		 Comportement
Valeurs
urlKey Diriger l’utilisateur vers la page de connexion d’une organisation en particulier (par exemple, si une organisation utilise des identifiants de connexion d’entreprise). Le nom abrégé de votre organisation ArcGIS, qui correspond à la première partie de l’URL de votre organisation. Voir l’exemple ci-dessous :

Exemple de paramètre de connexion

Opération
URL
Diriger les lecteurs pour qu’ils se connectent sur https://myorg.maps.arcgis.com .../briefings/[storymap-itemID]?urlKey=myorg
Conseil :

Pour plus d’informations sur l’utilisation de ce paramètre urlKey, consultez Partage d’une story map avec un lien spécifique à une organisation.

Paramètres de variable (bêta)

Bêta :

Les paramètres de variable sont en bêta. Si vous rencontrez des problèmes avec une fonctionnalité bêta, partagez vos commentaires sur le site Esri Community.

Les paramètres de variable fonctionnent uniquement avec ArcGIS Online et les récits. Les paramètres de variable pouvant faire l’objet d’importantes modifications, ils ne sont pas recommandés pour des déploiements de production de premier plan.

Les paramètres de variable permettent de transmettre des informations à une URL d’élément ArcGIS StoryMaps, laquelle est ensuite disponible pour référence dans l’URL du contenu intégré.

Paramètre		 Comportement
Valeurs
var_[variable_name] Définit une variable nommée variable_name qui peut être référencée dans les URL d’intégration Valeurs fournies par l’utilisateur
Important :

Les noms des paramètres de variable doivent contenir uniquement des lettres et des chiffres, doivent être nommés avec le préfixe var_, et sont sensibles à la majuscule. Les valeurs de variable contenant des espaces ou d’autres caractères spéciaux doivent être encodées.

Les paramètres de variable peuvent être utilisés avec des applications ArcGIS intégrées qui prennent en charge les paramètres URL, telles qu’ArcGIS Dashboards, ArcGIS Survey123, ArcGIS Experience Builder et ArcGIS Instant Apps. Vous pouvez également utiliser des paramètres de variable lors de l’intégration d’autres applications ou sites Web non ArcGIS.

Pour aller plus loin :

Pour comprendre comment fonctionnent les paramètres d’URL dans différentes applications ArcGIS et ce que vous pouvez en faire, consultez les liens ci-dessous.

Exemples de paramètres de variable

L’exemple ci-dessous montre comment construire des URL valides pour un cas d’usage classique. La première URL montre comment référencer le paramètre de variable dans une URL d’intégration, la seconde montrant comment transmettre une valeur pour la variable dans l’URL de l’élément ArcGIS StoryMaps.

Cet exemple utilise une variable nommée mercury pour transmettre une valeur de 0.25 à un paramètre numérique préconfiguré d'un tableau de bord nommé mercuryMin. Le paramètre filtre les informations dans le tableau de bord pour ne montrer que les emplacements supérieurs au résultat minimum d’un test de la qualité de l’eau.

URL du tableau de bord (ajoutée à un récit avec un bloc d’intégration) :

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

URL d’élément ArcGIS StoryMaps :

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

Ressources supplémentaires