Layer-Optionen
layers
Konfigurationen eines Layers. Auf Einzelheiten zu komplexeren Konfigurationseinträgen wird jeweils in einem gesonderten Abschnitt eingegangen.
name
Zur Identifikation genutzter Name des Layers. Muss eindeutig sein.
title
Angezeigter Name des Layers.
attribution
Attributierung, die zu dem Layer in der Karte angezeigt wird.
base
Name des Layers, dessen Konfiguration als Basis des Layers herangezogen wird. Es werden alle Eigenschaften vererbt und können dann gezielt überschrieben werden.
layers:
- name: wms_background
title: WMS Background
type: wms
source:
url: "http://www.example.org/wms/service?"
fomat: "image/png"
layers:
- color
srs: "EPSG:4326"
- name: mono_background
title: Mono background
base: wms_background
source:
layers:
- mono
status
Legt fest, ob der Layer aktiv ist. Aktive Layer werden, soweit in der default-config.yaml oder einer App-Konfiguration nicht anders angegeben, in der Karte angezeigt. Mögliche Werte sind active und inactive. Fehlt dieses Attribut, wird der Layer auf active gesetzt.
catalog
Soll die Gruppe im Katalog auftauchen kann dies hier eingesetllt werden. Standartwert false. Zusätzlich kann hier auch noch ein Titel mit angegeben werden.
catalog:
title: Parken Mobilität
opacity
Deckkraft des Layers.
metadataUrl
Externe URL zum Anzeigen von Metadaten, wird u.a. im Katalog verwendet.
background
Definiert ob ein Layer ein Hintergrundlayer ist. Standardwert: false.
directAccess
Ist der Parameter gesetzt, wird der Dienst direkt abgefragt und nicht über die Anwendung die als Proxy dient..
cluster
Definiert ob ein Layer geclustert werden soll. Dies gilt nur für Layer mit dem type postgis. Der Standartwert für diese Option ist false. Alle Layer mit cluster true die zur selben Gruppe gehören, werden zusammen geclustert.
abstract
Beschreibung welche Daten in dem Layer angezeigt werden, wird u.a. in der Darstellung des Katalogs verwendet.
type
Mögliche Typen sind wms, tiledwms, wmts, postgis und digitize. Je nach angegebenen type wird eine entsprechende source erwartet.
create_index
Diese Option ist nur für Layer mit dem type postgis und digitize gültig. Sie legt fest, ob für den Layer beim Drucken ein Index-Dokument erstellt und ein Kachelgitter zu der Karte hinzugefügt werden soll. Der Standartwert für diese Option ist true.
source
Konfiguration der Datenquelle des Layers. Einzelheiten unter source.
featureinfo
Konfiguration der Informationsabfrage des Layers. Dies gilt nur für Layer mit dem type postgis, wms oder tiledwms. Fehlt dieses Attribut oder ist der Wert null gesetzt, erfolgt keine Informationsabfrage für diesen Layer.
Konfiguriert, ob in der Kartenanwendung eine GetFeatureInfo-Abfrage für Layer vom type wms oder tiledwms durchgeführt bzw. Informationen zu einer Geometrie für Layer vom type postgis angezeigt werden soll.
Für Layer vom type wms oder tiledwms ist das Attribut target zu verwenden. Es definiert, wie das Ergebnis der GetFeatureInfo-Abfrage durch die Anwendung dargestellt wird. Mögliche Werte sind:
- _popup
Zeigt die Antwort der Anfrage in einem IFrame in einem, durch die Anwendung erzeugten, Popup. Zusätzlich können über die Attribute width und height die Breite bzw. Höhe des IFrames in Pixel eingestellt werden. Der Default-Wert für width beträgt 300, der Default-Wert für height beträgt 150. Diese werden verwendet, wenn das entsprechendne Attribut nicht gesetzt wurde.
- _blank
Zeigt die Antwort der Abfrage in einem neuen Browserfenster bzw. einem neuen Browsertab.
- CSS-Identifikators (Klasse oder ID eines Elements)
Zeigt die Antwort der Abfrage im angegebenen Element. Hierbei werden die der Antwort evtl. vorkommende HTML-Tags meta, link, title und script vor dem Anzeigen entfernt.
Für Layer vom type wms oder tiledwms steht das Attribut featureCount zur Verfügung. Hiermit wird festgelegt, für wie viele übereinander liegende Features Informationen angezeigt werden sollen. Der Default-Wert ist 1.
Für Layer vom type wms oder tiledwms, deren GetFeatureInfo-Abfrage das INFO_FORAMT application/vnd.ogc.gml unterstützen kann das Attribut gml auf true gesetzt werden um die abgefragte Geometrie in der Karte hervorzuheben. Mit dem Attribut gmlStyle kann ein Styling für die zurückgelieferten Geometrien definiert werden. Wie ein Styling zu definieren ist, ist im Abschnitt Style erläutert. Zusätzlich kann durch das Setzen des Attributs catalog auf true festgelegt werden, ob Nutzer im GML enthaltene Layer in die Anwendung hinzufügen können.
Für Layer vom type postgis wird immer ein durch die Anwendung erzeugtes Popup verwendet. Die anzuzeigenden Eigenschaften einer Geometrie sind im Attribut properties als Liste zu definieren.
Beispiel für WMS-GetFeatureInfo Ergebnis im Kartenpopup mit definierter Breite, Höhe und maximale Anzahl übereinander liegender Features, für die Informationen abgerufen werden sollen:
layers:
- name: wms_1
title: WMS 1
type: wms
source:
[...]
featureinfo:
target: '_popup'
width: 500
height: 250
featureCount: 10
gml: true
catalog: true
gmlStyle:
strokeWidth: 2
strokeColor: '#f00'
fillColor: '#00f'
legend
Konfiguration der anzuzeigenden Legende des Layers. Fehlt dieses Attribut oder ist der Wert null gesetzt, erfolgt keine Anzeige einer Legende für diesen Layer.
Konfiguriert die Angezeigte Legende des Layers. Für Layer vom type wms oder tiledwms werden keine Attribute benötigt. In diesem Fall wird eine GetLegendGraphic-Anfrage gestellt und das Ergebnis als Legendenbild eingebunden.
Für Layer vom type postgis kann das Attribute type verwendet werden um eine Legende zu erzeugen. In type ist hierbei der Geometrietyp (Point, Line, Polygon) anzugeben, der als Legende dargestellt werden soll. Dieser wird dann in der für den Layer angegebenen Darstellung angezeigt.
Für alle Arten von Layern kann das Attribut url verwendet werden. Hierbei muss url auf eine Grafik verweisen, die als Legende angezeigt werden soll.
searchConfig
Pro Layer kann auch eine eigene Suche definiert werden,
printTileSize
Für WMS-Layer (type wms oder tiledwms) kann eine printTileSize eingestellt werden. Wenn diese gesetzt ist, dann fragt mapfish print den WMS als Kacheln ab. Der Parameter muss ein Array mit zwei ganzzahligen Pixel-Angaben sein.
layers:
- name: wms_1
title: WMS 1
type: wms
printTileSize: [1024, 1024]
source:
[...]
style
Konfiguration der Darstellung des Layers. Dies gilt nur für Layer mit dem type postgis. Einzelheiten unter style.
Für nicht definierte Attribute wird der jeweilige Standardwert von OpenLayers 5 verwendet.
Bemerkung
Layer, die weder groups zugeordnet sind, stehen in der Anwendung nicht zur Verfügung.
radius
Radius für Punkte. Angabe in Pixel.
strokeColor
Linienfarbe für Punkte, Linien und Polygone. Angabe als Hex- oder RGB-Wert.
strokeWidth
Linienbreite für Punkte, Linien und Polygone. Angabe in Pixel.
strokeDashstyle
Linienart für Punkte, Linien und Polygone. Mögliche Werte sind solid, dot, dash, dashdot, longdash und longdashdot.
strokeOpacity
Liniendeckkraft für Punkte, Linien und Polygone. Werte zwischen 0 (durchsichtig) bis 1 (deckend).
fillColor
Füllfarbe für Punkte und Polygon. Angabe als Hex- oder RGB-Wert.
fillOpacity
Fülldeckkraft für Punkte und Polygone. Werte zwischen 0 (durchsichtig) bis 1 (deckend).
graphicFile
Grafik für Punkte. graphicWidth und graphicHeight sind mit anzugeben.
graphicWidth
Breite der Grafik. Angabe in Pixel.
graphicHeight
Höhe der Grafik. Angabe in Pixel.
graphicRotation
Winkel um den die Grafik rotiert werden soll.
graphicXAnchor
Horizontale Platzierung der Grafik relativ zur Punktgeometrie. Angabe in Pixel. Wenn nicht angegeben, wird die Grafik horizontal zentriert positioniert.
graphicYAnchor
Vertikale Platzierung der Grafik relativ zur Punktgeometrie. Angabe in Pixel. Wenn nicht angegeben, wird die Grafik vertikal zentriert positioniert.
graphicScale
Skalierungsfaktor für die Grafik. Werte zwischen 0 und 1 verkleinern die Grafik. Werte größer als 1 vergrößern die Grafik. Werte unter 0 spiegeln die Grafik, verhalten sich ansonsten wie positive Werte.
text
Text der als Beschriftung der Geometrie angezeigt werden soll.
propertyLabel
Eigenschaft der Geometrie, die als Beschriftung angezeigt werden soll.
fontWeight
Schriftstärke. Mögliche Werte sind normal, italic und bold.
fontSize
Schriftgröße. Hierbei ist die Einheit mit anzugeben. Erlaubt sind alle gängigen CSS Eigenschaften.
fontFace
Schriftart. Diese muss im System vorhanden sein.
fontColor
Schriftfarbe. Angabe als Hex- oder RGB-Wert.
groups
Liste mit Gruppen, die in der Anwendung verfügbar sein sollen.
Bemerkung
Um einen Layer in der Anwendung anzeigen zu können, muss dieser einer Gruppe zugeordnet werden.
Eine Gruppe wird mit folgenden Attributen konfiguriert:
name
Zur Identifikation genutzter Name der Gruppe. Muss eindeutig sein.
title
Angezeigter Name der Gruppe.
layers
Liste mit der Gruppe zugeordneten Layern
status
Legt fest, ob die Gruppe aktiv ist. Aktive Gruppen werden, soweit in der default-config.yaml oder einer App-Konfiguration nicht anders angegeben, in der Karte angezeigt.
Mögliche Werte sind active und inactive. Fehlt dieses Attribut, ist Gruppe automatisch auf active gesetzt.
showGroup
Die Gruppe wird in der Layerauswahl wie ein Layer angezeigt. Nur bei Gruppen mit einem Layer verwenden. Standartwert true.
singleSelect
Es kann nur ein Layer innerhalb der Gruppe sichtbar sein. Schaltet der Nutzer einen anderen Layer sichtbar, werden alle weiteren Layer nicht sichtbar.
Dieses Attribut darf nicht zusammen mit defaultVisibleLayers verwendet werden.
defaultVisibleLayers
Legt fest, welche Layer einer Gruppe beim aktivieren der Gruppe sichtbar geschaltet werden. Alle anderen Layer können nur mittels Klick auf den jeweiligen Layer sichtbar geschaltet werden.
Dieses Attribut darf nicht zusammen mit singleSelect verwendet werden.
Beispiel
groups
- name: lichtsignalanlagen
title: 'Ampeln'
layers:
- lichtsignalanlagen_p
- bodenrichtwerte_t
- bodenrichtwerte_brwznr_t
defaultVisibleLayers:
- lichtsignalanlagen_p
catalog
Soll die Gruppe im Katalog auftauchen kann dies hier eingesetllt werden. Standartwert false. Zusätzlich kann hier auch noch ein Titel mit angegeben werden.
catalog:
title: Parken Mobilität
abstract
Beschreibung welche Daten in der Gruppe angezeigt werden, wird u.a. in der Darstellung des Katalogs verwendet.
legend
Konfiguration der anzuzeigenden Legende des Gruppe. Fehlt dieses Attribut oder ist der Wert null gesetzt, erfolgt keine Anzeige einer Legende für diesen Gruppe.
Ist eine Legende in der Gruppe definiert werden alle Legenden der Layer unterdrückt. Es wird nur die Angabe einer URL unterstützt und keine GetLegendGraphics wie zum Beispiel bei Layern.
metadataUrl
Externe URL zum Anzeigen von Metadaten, wird u.a. im Katalog verwendet.
Beispiel
groups
- name: lichtsignalanlagen
title: 'Ampeln'
catalog: true
status: inactive
showGroup: false
abstract: Ampeln Abstract
metadataUrl: 'http://www.example.org'
layers:
- lichtsignalanlagen_p
- name: bodenrichtwerte
title: Bodenrichtwerte 2016
layers:
- bodenrichtwerte_t
- bodenrichtwerte_brwznr_t
Layer für den Druck
Um den Druck zu optimieren gibt es die Möglichkeit, über die Namenserweiterungen _print und _raw alternative Dienste zu konfigurieren. So kann z.B. ein Layer karte im Druck automatisch durch den Layer karte_print ausgetauscht werden. Der print_karte Layer kann hierbei gesondert konfiguriert werden (WMS statt WMTS, höhere DPI, etc.). Layer mit einer Namenserweiterung dürfen weder nicht in groups auftauchen.
[name]_print
Wird im Druck anstelle des in der Karte sichtbaren Layers verwendet. So kann z.B. eine hoch aufgelöste Variante des Layers benutzt werden.
Beispiel:
layers:
- name: example_layer
title: Example Layer
type: wms
source:
[...]
- name: example_layer_print
title: Example Layer
type: wms
source:
[...]
[name]_raw
Wird im Druck anstelle des in der Karte sichtbaren Layers verwendet, wenn ein Vektor-Formate gedruckt wird.
Beispiel:
layers:
- name: example_layer
title: Example Layer
type: wms
source:
[...]
- name: example_layer_raw
title: Example Layer
type: wms
source:
[...]
Layer Quellen
Konfiguration der Datenquelle eines Layers. Je nach Layer-type werden unterschiedliche Attribute benötigt. Nachfolgend sind die source-Attribute zum zugehörigen Layer-type aufgeführt.
wms
- url
URL des Dienstes. Diese muss mit ? oder & enden.
- format
Bildtyp. Z.B. ‚image/png‘.
- layers
Liste zu verwendender Layer.
- srs
Zu verwendendes Koordinatensystem.
- encoding
Zeichenencoding der Antwort auf eine GetFeatureInfo-Anfrage. Fehlt das Attribut wird utf-8 verwendet.
- styles
Styles die vom WMS abgfragt werden sollen. Hier muss eine Liste angegeben werden.
- transparent
Bestimmt, ob der WMS mit dem TRANSPARENT parameter auf TRUE oder FALSE abgefragt wird.
layers:
- name: example_layer
title: Example Layer
type: wms
source:
url: "http://www.example.org/wms/service?"
format: "image/png"
layers:
- example
srs: "EPSG:4326"
encoding: "iso8859-15"
tiledwms
Wie WMS, Karten werden jedoch in 256x256 Pixel große Kacheln abgerufen.
wmts
- url
URL des Dienstes. Diese muss mit / enden.
- format
Bildtyp. Z.B. ‚image/png‘.
- layer
Layer des Dienstes, der verwendet werden soll.
- srs
Zu verwendendes Koordinatensystem.
- extent
Gültigkeitsbereich des Dienstes. Siehe Capabilities-Dokument des Dienstes.
- matrixSet
Zu verwendendes Matrix-Set.
- levels
Anzahl im Matrix-Set enthaltener Detailstufen.
- hqUrl
URL des Dienstes, der für Clients mit hochaufgelösten Displays verwendet werden soll.
- hqLayer
Layer des Dienstes, der für Clients mit hochaufgelösten Displays verwendet werden soll.
- hqMatrixSet
Matrix-Set des Dienstes, das für Clients mit hochaufgelösten Displays verwendet werden soll.
layers:
- name: example_layer
title: Example Layer
type: wmts
source:
url: "http://www.example.org/wmts/"
format: "image/png"
layer: example
srs: "EPSG:4326"
extent: [6, 47, 15, 54]
matrixSet: epsg_4326
levels: 19
hqUrl: "http://www.example.org/wmts_hq/"
hqLayer: example_hq
hqMatrixSet: epsg_4326_hq
postgis
- type
Geometrietyp, den der SQL-Query zurückliefert
- query
SQL-Query, der anzuzeigende Geometrien aus der Datenbank selektiert.
layers
- name: example_layer
title: Example Layer
type: postgis
source:
type: point
query: SELECT geometry FROM points_table WHERE geometry && !bbox!
style:
radius: 10
strokeColor: '#c00'
fillColor: '#00c'
Bemerkung
Das where-statement geometry && !bbox! sorgt dafür, dass die Anfrage an die Datenbank nur Geometrien des aktuellen Kartenausschnitts zurückliefert.
digitize
- name
Name des Layers. Über diesen Wert wird die Zugehörigkeit eines Features in der Digitalisierungstabelle hergestellt. Daher muss dieser Name eindeutigt sein. Dieses Attribut ist verpflichtend.
- geom_type
Geometrietyp des Layers. Erlaubte Werte: Point, LineString, Polygon. Dieses Attribut ist verpflichtend.
- srs
Koordinatenreferenzsystem des Layers.
- properties
Die Attribute des Layers. Liste von Objekten, mit den Attributen name, type, label, select.
- name
String. Name des Attributs. Dieses Attribut ist verpflichtend.
- type
String. Typ des Attributs. Erlaubte Werte: text, int, float, boolean, date, select. Dieses Attribut ist verpflichtend.
- label
String. Darstellungstext des Attributs. Per default wird der Wert von name verwendet.
- select
Nur bei type: select. Entweder ein String, der eine Auswahlliste referenziert, oder eine direkte Auswahlliste. Siehe dazu auch Auswahllisten-Definition.
layers
- name: example_layer
title: Example Layer
type: digitize
source:
name: example_digitize_layer
geom_type: LineString
srs: 'EPSG:25832'
properties:
- label: Some Text
name: some_text
type: text
- label: Some Int
name: some_int
type: int
- label: Some Float
name: some_float
type: float
- label: Some Boolean
name: some_bool
type: boolean
- label: Some Date
name: some_date
type: date
- label: Direct Select
name: direct_select
type: select
select:
- value: 'foo'
label: 'hans'
- value: 'bar'
label: 'peter'
- label: Referenced Select
name: referenced_select
type: select
select: digitize_dev_select
style:
radius: 10
strokeColor: '#c00'
fillColor: '#00c'