Parametrisierte Aufrufe
Die folgenden Aspekte einer App können durch einen URL-Parameter gesteuert werden:
Aspekt | Parameter | Beispiel | Details |
---|---|---|---|
Sprache |
|
|
|
Farbschema |
|
|
|
Ansichtsmodus |
|
|
|
Center |
|
|
|
Maßstab |
|
|
|
Rotation |
|
|
|
Kamera |
|
|
|
Grundkarte |
|
|
|
Layer |
|
|
|
SRS |
|
|
|
Suche |
|
|
Um mehrere Parameter auf einmal zu verwenden, können Sie sie mit &
kombinieren, zum Beispiel …/index.html?lang=de&theme=everlasting
.
Um die Parameter permanent in der Adresszeile des Browsers anzuzeigen, ergänzen Sie das Bundle parameter-url in Ihrer App.
Die Parameter werden bei jeder relevanten Interaktion mit der App aktualisiert.
|
Sprache (lang)
Sie können de
für Deutsch und en
für Englisch verwenden.
Wenn kein Sprachparameter gesetzt ist, wird der Sprachparameter entsprechend der Spracheinstellung des Browsers hinzugefügt.
Weitere Sprachen können hinzugefügt werden (für weitere Details, siehe mapapps-custom-nls in GitHub )
Beispiel: https://<yourserver>/mapapps/ressources/apps/myapp/index.html?lang=de
Farbschema (theme)
Ein bestimmtes Farbschema kann direkt beim Start geladen werden. Dieses Farbschema muss in der App durch Hinzufügen des entsprechenden Farbschema-Bundles verfügbar sein.
Beispiel: https://<yourserver>/mapapps/ressources/apps/myapp/index.html?theme=autumn
.
Ansichtsmodus (vm)
Der Ansichtsmodus der Karte (2D oder 3D).
Beispiel: https://<yourserver>/mapapps/ressources/apps/myapp/index.html?vm=3D
Center (c)
Das Zentrum der Kartenansicht. Standardmäßig wird das SRS der aktuellen Karte verwendet.
Beispiel: https://<yourserver>/mapapps/ressources/apps/myapp/index.html?c=12345,12345`
Maßstab (s)
Der Maßstab der Kartenansicht.
Dieser Parameter muss in der Kombination mit center
verwendet werden.
Beispiel: https://<yourserver>/mapapps/resources/apps/myapp/index.html?s=12345`
.
Rotation (r)
Die Rotation der Kartenansicht.
Wählen Sie einen Wert zwischen 0
und 360
.
Beispiel: https://<yourserver>/mapapps/ressources/apps/myapp/index.html?r=45
.
Kamera (cam)
Die Kamera-Ansicht einer Szene. Dies gilt nur, wenn der Ansichtsmodus 3D ist.
Beispiel: https://<yourserver>/mapapps/resources/apps/myapp/index.html?cam=12345,12345,12345,90,45,55
Grundkarte (bm)
Die ID der ausgewählten Grundkarte. Die ID muss in der Konfiguration der App oder in einem innerhalb der App verwendeten Domain-Bundle verfügbar sein. Andernfalls hat der Parameter keinen Einfluss auf die App.
Beispiel: https://<yourserver>/mapapps/resources/apps/myapp/index.html?bm=streets`
.
Layer (l)
IDs der sichtbar/unsichtbar zu setzenden Layer und deren Transparenz, abweichend zur ursprünglichen Konfiguration der App. Nur die Sichtbarkeit und Transparenz der in der URL erscheinenden Layer geändert wird.
Beispiel: https://<yourserver>/mapapps/ressources/apps/myapp/index.html?l=<id1>,<id2>
Weitere Einzelheiten finden Sie in der Bundle Dokumentation .
SRS (srs)
Das gewählte räumliche Referenzsystem. Das SRS wird umgeschaltet bevor die Werte von Center und Kamera interpretiert werden.
Beispiel: https://<yourserver>/mapapps/resources/apps/myapp/index.html?srs=<wkid>
.
Suche (q)
Beim Start der App wird eine Suche ausgeführt.
Falls mehrere Suchthemen verfügbar sind, kann mit dem zusätzlichen Parameter source
die ID des gewünschten Themas angegeben werden.
Wenn durch die Suche mehrere Ergebnisse gefunden werden, wird nur auf das erste Ergebnis reagiert.
Beispiel: https://<yourserver>/mapapps/resources/apps/myapp/index.html?q=berlin&source=myStoreId
.
Wenn für das entsprechende Suchthema ein Popup definiert wurde, wird dieses nach der Suche angezeigt.
Um eine Suche über einen URL-Parameter starten zu können, muss das Bundle parametersearch
in der App eingebunden sein.
Weitere Einzelheiten finden Sie in der Bundle Dokumentation .