Skip to main content

URL-Parameter

Parameter können der URL eines ArcGIS StoryMaps-Elements hinzugefügt werden, um das Verhalten zu ändern oder bestimmte Features zu aktivieren. Sie müssen einer ArcGIS StoryMaps-URL nach folgender Konvention hinzugefügt werden:

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

Basis-URLs

Basis-URLs sind die Server-Endpunkte, die ArcGIS StoryMaps verwendet, um auf Ressourcen und Funktionalitäten zuzugreifen. Die drei Basis-URLs, die Unterstützung für Parameter bieten, sind unten aufgeführt.

Aktion Basis-URL
Erstellen eines neuen Elements https://storymaps.arcgis.com/[storymap-type]/new
Bearbeiten eines Elements (Builder) https://storymaps.arcgis.com/[storymap-type]/[storymap-itemID]/edit
Anzeigen eines Elements (Viewer) https://storymaps.arcgis.com/[storymap-type]/[storymap-itemID]

Anmerkungen:

  • Der [storymap-type] kann stories, briefings, frames, collections, templates oder themes lauten.

  • Die [storymap-itemID] kann die ID eines ArcGIS-Elements vom Typ StoryMap oder StoryMap theme sein.

  • Derzeit gibt es keine Möglichkeit, ein Design anzuzeigen.

Wichtig

In ArcGIS Enterprise ersetzen Sie storymaps.arcgis.com durch [your-portal-domain]/[web-adaptor-name]/apps/storymaps/.

Beispiel:

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

Anzeigeparameter

Anzeigeparameter werden zusammen mit der Basis-URL verwendet, um ArcGIS StoryMaps-Elemente anzuzeigen:

https://storymaps.arcgis.com/[storymap-type]/[storymap-itemID]
Parameter Verhalten
Werte		 Story Briefing Frame Sammlung
play Aktivieren der automatischen Wiedergabe true (Standard)
false		 ✅ ✅ ❌ ✅
speed Steuern der Geschwindigkeit der automatischen Wiedergabe (play=true erforderlich) slow
medium (Standard)
fast		 ✅ ✅ ❌ ✅
header Ein-/Ausblenden der Kopfzeile beim Anzeigen eines Elements true (Standard)
false		 ✅ ✅ ❌ ✅
cover Ein-/Ausblenden der Titelseite true (Standard)
false		 ✅ ✅ ✅ ✅
navigation Ein-/Ausblenden der Navigationssteuerelemente true (Standard)
false		 ❌ ❌ ❌ ✅
item Anzeigen eines Sammlungselements nach numerischer Position 1, 2, 3, ... ❌ ❌ ❌ ✅

Anmerkungen:

  • Wenn für einen Parameter kein Wert angegeben ist, wird die Standardeinstellung verwendet. Beispiel: play entspricht play=true.

  • Die URL-Parameter header und cover setzen das aktuell konfigurierte Verhalten des Elements außer Kraft. Wenn zum Beispiel für eine Story Titelseite ausblenden aktiviert ist, kann cover=true verwendet werden, um die Titelseite anzuzeigen. Weitere Informationen finden Sie unter Konfigurieren von Story-Einstellungen.

  • Die Kopfzeile ist ausgeblendet, wenn eine Story in einen <iframe> eingebettet ist, mit dem Parameter header kann das Einblenden jedoch erzwungen werden. Bei eingebetteten Briefings oder Sammlungen wird die Kopfzeile nicht standardmäßig ausgeblendet, da sie Navigationselemente enthält. Weitere Informationen finden Sie unter Standard-Einbettung.

  • Wenn Sie die Kopfzeile für ein Briefing ausblenden, ist die Werkzeugleiste für die Navigation nicht mehr verfügbar. Leser können weiterhin mit der Tastatur oder einer Fernbedienung navigieren. Für eine Sammlung kann die Kopfzeile nicht ausgeblendet werden.

Beispiele für Anzeigeparameter

In den folgenden Beispielen ist die Basis-URL mit Anzeigeparametern kombiniert, um zu veranschaulichen, wie eine gültige URL für einige typische Anwendungsfälle erstellt wird.

Aktion
URL
Aktivieren der automatischen Wiedergabe mit langsamer Geschwindigkeit für ein Briefing .../briefings/[itemID]?play&speed=slow
Ausblenden der Kopfzeile für ein Briefing .../briefings/[storymap-itemID]?header=false
Ausblenden der Kopfzeile und der Titelseite für eine Story .../stories/[storymap-itemID]?header=false&cover=false
Ausblenden der Kopfzeile und Anzeigen der Titelseite für eine Story .../stories/[storymap-itemID]?header=false&cover=true
Anzeigen des fünften Elements einer Sammlung .../collections/[storymap-itemID]?item=5

Elementerstellungsparameter

Elementerstellungsparameter werden zusammen mit der Basis-URL verwendet, um neue ArcGIS StoryMaps-Elemente zu erstellen:

https://storymaps.arcgis.com/[storymap-type]/new
Parameter		 Verhalten
Werte		 Story Briefing Frame Sammlung
theme Erstellen eines neuen ArcGIS StoryMaps-Elements und Anwenden eines Designs [theme-itemID] ✅ ✅ ❌ ✅
webmap Erstellen einer neuen ArcGIS StoryMaps-Story und Hinzufügen einer Webkarte als erster Block [webmap-itemID] ✅ ❌ ❌ ❌
webscene Erstellen einer neuen ArcGIS StoryMaps-Story und Hinzufügen einer Webszene als erster Block [webscene-itemID] ✅ ❌ ❌ ❌
template Erstellen einer neuen ArcGIS StoryMaps-Story aus einer Vorlage [template-itemID] ✅ ❌ ❌ ❌

Beispiele für die Elementerstellung

In den folgenden Beispielen ist die Basis-URL mit Elementerstellungsparametern kombiniert, um zu veranschaulichen, wie eine gültige URL für einige typische Anwendungsfälle erstellt wird.

Aktion
URL
Erstellen eines neuen Briefings und Anwenden eines Designs .../briefings/new?theme=[theme-itemID]
Erstellen einer neuen Story mit einer Webkarte als erster Block .../stories/new?webmap=[webmap-itemID]

Anmeldeparameter

Der folgende Parameter funktioniert mit allen Elementtypen.

Parameter		 Verhalten
Werte
urlKey Weiterleiten des Benutzers zur Anmeldeseite einer bestimmten Organisation, z. B. wenn eine Organisation Enterprise-Anmeldungen verwendet Der Kurzname Ihrer ArcGIS-Organisation. Dies ist der erste Teil Ihrer Organisations-URL. Siehe nachfolgendes Beispiel.

Beispiel für Anmeldeparameter

Aktion
URL
Weiterleiten der Leser zur Anmeldung bei https://myorg.maps.arcgis.com .../briefings/[storymap-itemID]?urlKey=myorg
Tipp:

Weitere Informationen zur Verwendung des Parameters urlKey finden Sie unter Sharing a StoryMap with an organization-specific link.

Variablenparameter (Beta)

Beta:

Variablenparameter befinden sich im Beta-Stadium. Wenn Sie Schwierigkeiten mit einer Beta-Funktion haben, teilen Sie Ihr Feedback in der Esri Community.

Variablenparameter funktionieren nur bei Verwendung von ArcGIS Online und nur bei Storys. Da Variablenparameter grundlegende Änderungen erfahren können, werden sie für die Verwendung in wichtigen Produktionsbereitstellungen nicht empfohlen.

Mit Variablenparametern können Sie Informationen an die URL eines ArcGIS StoryMaps-Elements übergeben, die dann in der URL eingebetteter Inhalte referenzierbar ist.

Parameter		 Verhalten
Werte
var_[variable_name] Definiert eine Variable mit dem Namen variable_name, die in Einbettungs-URLs referenziert werden kann Benutzerdefinierte Werte
Wichtig

Variablenparameternamen dürfen nur Buchstaben und Zahlen enthalten und müssen mit dem Präfix var_ benannt werden. Außerdem wird zwischen Groß- und Kleinschreibung unterschieden. Variablenwerte, die Leerzeichen oder andere Sonderzeichen enthalten, müssen codiert werden.

Variablenparameter können mit eingebetteten ArcGIS-Apps, die URL-Parameter unterstützen, verwendet werden, wie zum Beispiel ArcGIS Dashboards, ArcGIS Survey123, ArcGIS Experience Builder und ArcGIS Instant Apps. Variablenparameter können Sie möglicherweise auch verwenden, wenn Sie Apps oder Websites einbetten, die keine ArcGIS-Apps oder -Websites sind.

Tauchen Sie ein:

Um zu erfahren, wie URL-Parameter in verschiedenen ArcGIS-Apps funktionieren und wofür sie verwendet werden können, sehen Sie sich die folgenden Links an.

Beispiele für Variablenparameter

Im folgenden Beispiel wird veranschaulicht, wie gültige URLs für einen typischen Anwendungsfall erstellt werden. Die erste URL zeigt, wie der Variablenparameter in einer Einbettungs-URL referenziert wird. Die zweite URL zeigt, wie ein Wert für die Variable an die URL eines ArcGIS StoryMaps-Elements übergeben wird.

In diesem Beispiel wird eine Variable mit dem Namen mercury verwendet, um den Wert 0.25 an den vorkonfigurierten numerischen Parameter mit dem Namen mercuryMin eines Dashboards zu übergeben. Der Parameter filtert die Informationen im Dashboard so, dass nur die Standorte angezeigt werden, bei denen das Ergebnis der Prüfung der Wasserqualität über einem bestimmten Mindestwert liegt.

Dashboard-URL (einer Story mit einem Einbettungsblock hinzugefügt):

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

URL des ArcGIS StoryMaps-Elements:

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

Zusätzliche Ressourcen