API-3.1/Konfiguration/Layer-Array/1.-Allgemein.md

+# layer{}
+Einstellungen der Karteninhalte
+
+## Layer konfigurieren
+
+Es gibt die Möglichkeit, OGC-WMS, OGC-WFS und KML in den Kartenviewer einzubinden. In diesem Abschnitt wird erklärt wie diese konfiguriert werden können, und wie Sie eine individuelle Layerstruktur erzeugen können.
+
+Wie schon in  [Erste Schritte](/API-3.1/Erste-Schritte) gezeigt, werden die Kartenebenen in dem **`layers`**-Objekt der `config.json` angegeben.
+
+Für WMS und WFS sind die Angaben name, `url`, `type`, `params` und `options` obligatorich zu füllen. \
+Für KML fällt `params` weg.
+
+### name 
+
+Der Name ist frei wählbar und wird im Kartenebenenbaum dargestellt
+
+### url
+
+Die URL oder der relative Pfad auf dem Server zum Dienst oder zur Datei wird hier angegeben
+
+### type 
+
+wms, wfs oder kml sind möglich.
+
+### params 
+
+Die params enthalten spezifische Angaben, die ein WMS oder WFS benötigen. Hier können neben den Pflichtangaben auch weitere Angaben gemacht werden. Wird bei KML nicht benötigt, da es eine Dateiformat ist und kein OGC-Service.
+
+### options 
+
+In options werden die Optionen festgelegt, die von der Anwendung, dem Viewer, benötigt werden. Neben den Pflichtangaben sind auch hier weitere anwendungsspezifische Angaben möglich.
+
+
+
+
+## Layerstruktur
+Die Layerstruktur kann maximal für drei Hierarchiestufen erzeugt werden (siehe Bilder unten). Die Konfiguration findet allein über die beiden Optionen ``level`` und ``group`` statt.
+
+````javascript
+    group: 'Liegenschaftskataster',
+    level: 'Geobasisdaten',
+````
+
+Die dritte Untergruppierung wird mit wie folgt gebildet:
+
+````javascript
+    group: 'Gruppe-1 #> Untergruppe-1'
+````
+
+Im folgenden Beispiel sind die Untergruppen zur besseren Übersicht nicht ausgeklappt:
+
+{@img bbviewer_lt_02.png}
+
+Mit ausgeklappten Untergruppen sieht es dann beipielsweise wie im folgenden Bild aus:
+
+{@img bbviewer_lt_03.png}
+
+Die zu den Bildern zugehörige Konfiguration sieht man unten. Die Layerkonfiguration wurde kurz gehalten um die Optionen ``level`` und ``group`` in den Vordergrund zu stellen. Beachten Sie, dass der erste layer keiner Gruppe angehört und daher keine Gruppenoption benötigt.
+
+````javascript
+var layer = [{
+	name: "A",
+	url: "url-zum-wms",
+	type: "wms",
+	params:{
+		layers: "layer1"
+	},
+	options: {
+		Keine Gruppe !
+	}
+}, {
+	name: "B",
+	url: "url-zum-wms",
+	type: "wms",
+	params:{
+		layers: "layer1"
+	},
+	options: {
+		group: 'Gruppe 1'
+	}
+}, {
+	name: "C",
+	url: "url-zum-wms",
+	type: "wms",
+	params:{
+		layers: "layer1"
+	},
+	options: {
+		group: 'Gruppe 1'
+	}
+}, {
+	name: "D",
+	url: "url-zum-wms",
+	type: "wms",
+	params:{
+		layers: "layer1"
+	},
+	options: {
+		level: 'Level 1',
+		group: 'Gruppe 1'
+	}
+}, {
+	name: "E",
+	url: "url-zum-wms",
+	type: "wms",
+	params:{
+		layers: "layer1"
+	},
+	options: {
+		level: 'Level 1',
+		group: 'Gruppe 1'
+	}
+}, {
+	name: "F",
+	url: "url-zum-wms",
+	type: "wms",
+	params:{
+		layers: "layer1"
+	},
+	options: {
+		level: 'Level 1',
+		group: 'Gruppe 2'
+	}
+}, {
+	name: "G",
+	url: "url-zum-wms",
+	type: "wms",
+	params:{
+		layers: "layer1"
+	},
+	options: {
+		level: 'Level 1',
+		group: 'Gruppe 2'
+	}
+}, {
+	name: "H",
+	url: "url-zum-wms",
+	type: "wms",
+	params:{
+		layers: "layer1"
+	},
+	options: {
+		level: 'Level 2',
+		group: 'Gruppe 1 #> Untergruppe_1a'
+	}
+}, {
+	name: "I",
+	url: "url-zum-wms",
+	type: "wms",
+	params:{
+		layers: "layer1"
+	},
+	options: {
+		level: 'Level 2',
+		group: 'Gruppe 1 #> Untergruppe_1a'
+	}
+}, {
+	name: "J",
+	url: "url-zum-wms",
+	type: "wms",
+	params:{
+		layers: "layer1"
+	},
+	options: {
+		level: 'Level 2',
+		group: 'Gruppe 1 #> Untergruppe_1b'
+	}
+}, {
+	name: "K",
+	url: "url-zum-wms",
+	type: "wms",
+	params:{
+		layers: "layer1"
+	},
+	options: {
+		level: 'Level 2',
+		group: 'Gruppe 1 #> Untergruppe_1b'
+	}
+}, {
+	name: "L",
+	url: "url-zum-wms",
+	type: "wms",
+	params:{
+		layers: "layer1"
+	},
+	options: {
+		level: 'Level 2',
+		group: 'Gruppe 2 #> Untergruppe_2a'
+	}
+}, {
+	name: "M",
+	url: "url-zum-wms",
+	type: "wms",
+	params:{
+		layers: "layer1"
+	},
+	options: {
+		level: 'Level 2',
+		group: 'Gruppe 2 #> Untergruppe_2a'
+	}
+}, {
+	name: "N",
+	url: "url-zum-wms",
+	type: "wms",
+	params:{
+		layers: "layer1"
+	},
+	options: {
+		level: 'Level 2',
+		group: 'Gruppe 2 #> Untergruppe_2b'
+	}
+}];
+````
+
+
+ToDo:
+
+1.
+
+			// Beispiel für eine OSM Konfiguration
+			"name": "OSM_OEPNV",
+			//"url": "https://{a-c}.tile.openstreetmap.org/{z}/{x}/{y}.png",
+			"url": "https://tile.memomaps.de/tilegen/{z}/{x}/{y}.png",
+			"crossOrigin": null,
+			"wrapX": false,
+			"type": "osm",
+			"params": {
+				"extent": [
+//					-141000,
+//					5240000,
+//					510000,
+//					6140137
+					-40000000,
+					-200000000,
+					21000000,
+					10000000
+				]
+			},
+			"options": {
+				"displayInLayerSwitcher": true,
+				"isBaseLayer": true,
+				"visibility": false,
+				"permalinkID": "osm",
+				"legendUrl": "Hintergrundkarten"			
+			}
+		},
+
+2. 
+
+
+
+
+Für weitere Informationen schauen Sie sich bitte auch die Dokumentation folgender Erweiterungen an:
+