Parametrisierte Aufrufe
Die folgenden Aspekte einer App können durch einen URL-Parameter gesteuert werden:
| Aspekt | Parameter | Beispiel |
|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Um mehrere Parameter auf einmal zu verwenden, kombinieren Sie sie mit &, 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/resources/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/resources/apps/myapp/index.html?theme=autumn.
Ansichtsmodus (vm)
Der Ansichtsmodus der Karte (2D oder 3D).
Beispiel: https://<yourserver>/mapapps/resources/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/resources/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/resources/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 in der App verwendeten Domain-Bundle verfügbar sein. Andernfalls hat der Parameter keine Auswirkung.
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/resources/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 mehrere Ergebnisse gefunden werden, wird standardmäßig nur das erste Ergebnis verwendet.
Um mehrere Ergebnisse anzuzeigen, setzen Sie die Eigenschaft useOnlyFirstResult des Links:https://demos.conterra.de/mapapps/resources/jsregistry/root/parametersearch/latest/README.md[parametersearch bundle ^] auf false.
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 .