diff --git a/conf.py b/conf.py index 4a657c5e..3a6862f9 100644 --- a/conf.py +++ b/conf.py @@ -49,7 +49,7 @@ # General information about the project. project = u'Mapbender' -copyright = u'2025, The Mapbender Team' +copyright = u'2026, The Mapbender Team' # The version info for the project you're documenting, acts as replacement for # |version| and |release|, also used in various other places throughout the diff --git a/de/backend.rst b/de/backend.rst index 239e3a15..25940b09 100644 --- a/de/backend.rst +++ b/de/backend.rst @@ -2,7 +2,8 @@ Backend ======= -Das Backend ist die Verwaltungsoberfläche von Mapbender: Mit ihm können Anwendungen und Datenquellen verwaltet und über Benutzer und Gruppen abgesichert werden. +Das Backend ist die Verwaltungsoberfläche von Mapbender: Mit ihm können Anwendungen und Datenquellen verwaltet und über Benutzer und Gruppen abgesichert werden. Außerdem können Stile für Vektordatenquellen verwaltet werden. + Zur Installation und Einrichtung von Mapbender besuchen Sie bitte die Seiten zur :ref:`installation_de` bzw. den :ref:`Schnellstart `. In einer lokalen Standardkonfiguration kann das Backend über ``http://localhost/mapbender`` aufgerufen werden. Nach der erfolgreichen Anmeldung mit dem root-Benutzer stehen folgende Seiten zur Verfügung: @@ -16,8 +17,9 @@ In einer lokalen Standardkonfiguration kann das Backend über ``http://localhost :maxdepth: 2 backend/sources.rst + backend/styles.rst .. toctree:: :maxdepth: 2 - backend/FOM/index.rst \ No newline at end of file + backend/FOM/index.rst diff --git a/de/backend/applications/layerset.rst b/de/backend/applications/layerset.rst index 636428d0..1a34b83c 100644 --- a/de/backend/applications/layerset.rst +++ b/de/backend/applications/layerset.rst @@ -288,7 +288,7 @@ Die Vector Tiles-Instanz-Einstellungen bieten folgende Konfigurationsmöglichkei * **Ursprungs-URL**: Die URL zur JSON-Datei. * **Titel**: Der Titel der Instanz, wie er im Ebenenbaum angezeigt wird. * **Deckkraft**: Die Transparenz der Instanz. -* **Minimaler/Maximaler Maßstab(Nenner)**: Der Maßstabsbereich, in dem der Layer angezeigt wird. +* **Minimaler/Maximaler Maßstab (Nenner)**: Der Maßstabsbereich, in dem der Layer angezeigt wird. * **Auflösungskorrektur für den Druck**: Gibt an, ob eine Auflösungskorrektur für den Druck angewendet werden soll. * **BaseSource**: Gibt an, ob die Instanz als Basisquelle behandelt werden soll. * **Bei Anwendungsstart aktivieren**: Checkbox, ob die Instanz beim Start der Anwendung aktiviert sein soll. @@ -329,4 +329,56 @@ Beispiel: .. image:: ../../../figures/de/layerset/layerset_vector_tiles_visualisation.png :width: 100% -Der Screenshot zeigt eine Mapbender-Anwendung mit aktivierter Legende und Feature-Information. +Der Screenshot zeigt eine Mapbender-Anwendung mit Vector Tiles Dienst und aktivierter Legende und Feature-Information. + + +OGC API Features Service Instanz-Konfiguration +---------------------------------------------- + +.. image:: ../../../figures/de/layerset/layerset_ogc_api_features_instance.png + :scale: 80 + +Die OGC API Features Dienst-Instanz-Einstellungen bieten folgende Konfigurationsmöglichkeiten: + +* **Ursprungs-URL**: Die URL zum OGC API Features Dienst +* **Titel**: Der Titel der Instanz, der im Ebenenbaum angezeigt werden soll. +* **Deckkraft**: Die Transparenz der Instanz. +* **Max.-Anzahl Features**: Definition wie viele Objekte von den Collections angefordert werden sollen. +* **Minimaler/Maximaler Maßstab (Nenner)**: Der Maßstabsbereich, in dem die Collections angezeigt werden sollen. + +* **BaseSource**: Gibt an, ob die Instanz als Basisquelle behandelt werden soll. +* **Ausgewählt**: Checkbox, ob die Instanz beim Start der Anwendung aktiviert sein soll. +* **Auswahl erlauben**: Checkbox, ob der Benutzer die Instanz im Ebenenbaum auswählen darf. +* **Aufgeklappt**: Checkbox, ob die Instanz beim Start der Anwendung aktiviert sein soll. +* **Aufklappen erlauben**: Checkbox, ob der Benutzer die Instanz im Ebenenbaum aufklappen darf. +* **Aufklappen**: Gibt an, ob der Ordner beim Start der Anwendung aufgeklappt sein soll. + +* **Feld-Information & Übersetzung**: YAML-Array zur Definition von Feldern und Übersetzungen für die Informationsausgabe. +Beispiel: + + .. code-block:: yaml + + - name: Name + - objid: ID + - flaeche: 'Fläche' + - land: Bundesland + +**Collections** + +* **Titel**: Titel für die Collection, der im Ebenenbaum angezeigt werden soll. +* **Max.-Anzahl Features**: Definition wie viele Objekte für die Collection angefordert werden sollen. +* **Minimaler/Maximaler Maßstab (Nenner)**: Der Maßstabsbereich, in dem die Collection angezeigt werden soll. +* **Aktiv an/aus**: Aktiviert/deaktiviert eine Collection in dieser Anwendung. Sobald dieser Haken nicht gesetzt ist, werden alle anderen Haken derselben Instanz ignoriert. + +* **Auswählen erlauben**: Die Collection ist im Ebenenbaum auswählbar. +* **Auswählen an**: Die Collection ist bei Anwendungsstart im Ebenenbaum aktiv. +* **Info erlauben**: Die Infoabfrage wird für diese Collection zugelassen. +* **Info an**: Die Infoabfrage wird beim Start aktiviert. +* **...** (Drei-Punkte-Menü): Öffnet einen Dialog mit weiteren Informationen: +* **Collection Name**: Layername der Service Information +* **Style**: Sie können einen Standard-Stil und weitere Stile auswählen. + +.. image:: ../../../figures/de/layerset/layerset_ogc_api_features_visualisation.png + :width: 100% + +Der Screenshot zeigt eine Mapbender-Anwendung mit OGC API Features Dienst. diff --git a/de/backend/sources.rst b/de/backend/sources.rst index dacb7741..c5f66adc 100644 --- a/de/backend/sources.rst +++ b/de/backend/sources.rst @@ -8,6 +8,7 @@ Datenquellen (Sources) * **OGC WMS**: Web Map Service * **OGC WMTS/TMS**: Web Map Tile Service / Tile Map Service * **Vector Tiles** +* **OGC API Features** Informationen zum Einbinden von Diensten und die Nutzung in Anwendungen finden Sie im Schnellstart-Kapitel :ref:`de/quickstart:Laden von Datenquellen`. @@ -235,3 +236,18 @@ YAML * **bbox**: Begrenzungsrahmen (Array xmin, ymin, xmax, ymax) für die Quelle + +OGC API Features +---------------- + +OGC API Features + +Lesen Sie mehr über OGC API Features in der `OGC documentation https://ogcapi.ogc.org/features/ `_. + +Laden einer OGC API Features Quelle ++++++++++++++++++++++++++++++++++++ + +.. image:: ../../figures/de/mapbender_add_ogc_api_features_source.png + :width: 100% + +* **URL zum OGC API Features Dienst**: URL zum Dienst (z. B. `pygeoapi Demo https://demo.pygeoapi.io/stable `_ or `Daten des Liegenschaftskatasters in NRW https://ogc-api.nrw.de/lika/v1 `_ ) diff --git a/de/backend/styles.rst b/de/backend/styles.rst new file mode 100644 index 00000000..d79fa076 --- /dev/null +++ b/de/backend/styles.rst @@ -0,0 +1,35 @@ +.. _styles_de: + +Stile +===== + +Vektor-Daten benötigen eine Stil-Definition (Style), um in einem individuellen Stil dargestellt zu werden. + +Dieser Stil muss in Mapbender registriert werden und kann dann Vektor-Datenquellen zugewiesen werden. + +Sie können Stile hochladen oder auch Stile in mapbender erzeugen. + +Supported Styles are: + +* Mapbox Style https://docs.mapbox.com/style-spec/guides/ +* SLD Styled Layer Descriptor https://www.ogc.org/standards/sld/ + +.. tip:: Sie können ihren gewünschten Stil mit QGIS erzeugen und exportieren. Anschließend kann der Stil in Mapbender geladen werden und zur Darstellung von Vektordaten verwendet werden. Das QGIS Plugin GeoCatBridge kann für das Exportieren von Stilen empfohlen werden. + +.. image:: ../../figures/de/style.png + :scale: 80 + +Stile laden +----------- + +.. image:: ../../figures/de/style_upload.png + :scale: 80 + + + +Stil mit dem Style-Generator erstellen +-------------------------------------- + +.. image:: ../../figures/de/style_generator.png + :scale: 80 + diff --git a/en/backend.rst b/en/backend.rst index da9c8faa..bcb0af73 100644 --- a/en/backend.rst +++ b/en/backend.rst @@ -2,7 +2,8 @@ Backend ======= -The backend is the administration interface of Mapbender: It allows the management of applications and data sources as well as securing them through users and groups. +The backend is the administration interface of Mapbender: It allows the management of applications and data sources as well as securing them through users and groups. You can also administrate styles for vector data. + To install and set up Mapbender, please visit the :ref:`installation` pages or the :ref:`Quickstart `. In its local standard configuration, the backend can be accessed via ``http://localhost/mapbender``. After a successful login with the root user, the following pages are available: @@ -15,8 +16,9 @@ In its local standard configuration, the backend can be accessed via ``http://lo :maxdepth: 2 backend/sources.rst + backend/styles.rst .. toctree:: :maxdepth: 2 - backend/FOM/index.rst \ No newline at end of file + backend/FOM/index.rst diff --git a/en/backend/applications/layerset.rst b/en/backend/applications/layerset.rst index 5804f5b7..a4accb9a 100644 --- a/en/backend/applications/layerset.rst +++ b/en/backend/applications/layerset.rst @@ -325,3 +325,53 @@ Example: :width: 100% The screenshot shows a Mapbender application with an active legend and feature information. + +OGC API Features Service Instance Configuration +----------------------------------------------- + +.. image:: ../../../figures/layerset/layerset_ogc_api_features_instance.png + :scale: 80 + +The OGC API Features Service instance settings offer the following configuration options: + +* **Origin URL**: The URL to the OGC API Features Service. +* **Title**: The title of the instance as displayed in the layer tree. +* **Opacity**: The transparency of the instance. +* **Max features**: Specifies how many features to fetch from the collections. +* **Minimum/Maximum Scale Denominator**: The scale range in which the layer should be displayed. + +* **BaseSource**: Indicates whether the instance should be treated as a base source. +* **Selected**: Service is active when the application starts. +* **Allow Selected**: Selectable in geodata explorer. +* **Toggle**: Opens the folder on start of the application. +* **Allow Toggle**: Folder can be opened via Layertree. + +* **Field information & translation**: YAML array for fields and translation. +Example: + + .. code-block:: yaml + + - name: Name + - objid: ID + - flaeche: 'Area' + - land: Province + +**Collections** + +* **Title**: The title for the collection, that shall be displayed in the layer tree. +* **Max features**: Specifies how many features to fetch from the collections. +* **Minimum/Maximum Scale Denominator**: The scale range in which the layer should be displayed. + +* **Active** (on/off): Enables/disables collection for the individual application. If not set, all other checkboxes of the same collection will be ignored. +* **Select allow**: Collection is active when the application starts. +* **Select on**: Selectable in geodata explorer. +* **Info allow**: Collection info is active when the application starts. +* **Info**: Collection provides feature info requests, info default activates the feature info functionality. +* **...** -> Opens a dialog with more information: +* **Collection name**: Collection name of the service information +* **Style**: You can choose a default style and offer other styles. + +.. image:: ../../../figures/layerset/layerset_ogc_api_features_visualisation.png + :width: 100% + +The screenshot shows a Mapbender application with an OGC API Features Service. diff --git a/en/backend/sources.rst b/en/backend/sources.rst index b177b959..1dc2620f 100644 --- a/en/backend/sources.rst +++ b/en/backend/sources.rst @@ -8,6 +8,7 @@ With Sources, you can register: * **OGC WMS**: Web Map Service * **OGC WMTS/TMS**: Web Map Tile Service / Tile Map Service * **Vector Tiles** +* **OGC API Features** Further information about the registration process of services and their usage in applications is available in the Quickstart chapter :ref:`en/quickstart:Load sources`. @@ -237,3 +238,19 @@ YAML Transport: Public Transport * **bbox**: Bounding box (array xmin, ymin, xmax, ymax) for the source + + +OGC API Features +---------------- + +OGC API Features + +Read more about OGC API Features at the `OGC documentation https://ogcapi.ogc.org/features/ `_. + +Loading an OGC API Features Service ++++++++++++++++++++++++++++++++++++ + +.. image:: ../../figures/mapbender_add_ogc_api_features_source.png + :width: 100% + +* **URL to an OGC API Features Service**: Service URL (for example `bm_web_col https://sgx.geodatenzentrum.de/gdz_basemapde_vektor/styles/bm_web_col.json `_ oder `Daten des Liegenschaftskatasters in NRW https://ogc-api.nrw.de/lika/v1 `_ ) diff --git a/en/backend/styles.rst b/en/backend/styles.rst new file mode 100644 index 00000000..0764fb94 --- /dev/null +++ b/en/backend/styles.rst @@ -0,0 +1,33 @@ +.. _styles: + +Styles +====== + +Vector data need a style definition to be visualized in an individual style. This style has to be registered in Mapbender and can then be used with vector data. + +You can upload styles or create new styles. + +Unterstützte Stile sind: + +* Mapbox Style https://docs.mapbox.com/style-spec/guides/ +* SLD Styled Layer Descriptor https://www.ogc.org/standards/sld/ + +.. tip:: You can create your favorite style with QGIS and export is as SLD. Then you can upload it to Mapbender and use it to visualize vector data. A nice QGIS plugin for style exort is the GeoCatBridge Plugin. + + +.. image:: ../../figures/style.png + :scale: 80 + +Upload Style +----------------- + +.. image:: ../../figures/style_upload.png + :scale: 80 + + + +Create a Style with the Style generator +--------------------------------------- + +.. image:: ../../figures/style_generator.png + :scale: 80 diff --git a/figures/de/layerset/layerset_ogc_api_features_instance.png b/figures/de/layerset/layerset_ogc_api_features_instance.png new file mode 100644 index 00000000..1e1e8001 Binary files /dev/null and b/figures/de/layerset/layerset_ogc_api_features_instance.png differ diff --git a/figures/de/layerset/layerset_ogc_api_features_visualisation.png b/figures/de/layerset/layerset_ogc_api_features_visualisation.png new file mode 100644 index 00000000..43f2c706 Binary files /dev/null and b/figures/de/layerset/layerset_ogc_api_features_visualisation.png differ diff --git a/figures/de/mapbender_add_ogc_api_features_source.png b/figures/de/mapbender_add_ogc_api_features_source.png new file mode 100644 index 00000000..20c754ff Binary files /dev/null and b/figures/de/mapbender_add_ogc_api_features_source.png differ diff --git a/figures/layerset/layerset_ogc_api_features_instance.png b/figures/layerset/layerset_ogc_api_features_instance.png new file mode 100644 index 00000000..1e1e8001 Binary files /dev/null and b/figures/layerset/layerset_ogc_api_features_instance.png differ diff --git a/figures/layerset/layerset_ogc_api_features_visualisation.png b/figures/layerset/layerset_ogc_api_features_visualisation.png new file mode 100644 index 00000000..43f2c706 Binary files /dev/null and b/figures/layerset/layerset_ogc_api_features_visualisation.png differ diff --git a/figures/mapbender_add_ogc_api_features_source.png b/figures/mapbender_add_ogc_api_features_source.png new file mode 100644 index 00000000..f5960860 Binary files /dev/null and b/figures/mapbender_add_ogc_api_features_source.png differ