Mapbender3 Quickstart

Mapbender ist ein web-basiertes Geoportal Framework zum Veröffentlichen, Registrieren, Anzeigen, Navigieren und Überwachen von Diensten, mit der Möglichkeit Dienste gesichert anzubieten.

Administrationsoberflächen ermöglichen es Administratoren Karten- und Datendienste zu verwalten und zu kategorisieren. Über die Administration können einzelnen Benutzern und Gruppen Zugriffe gewährt werden.

Mapbender3 ist die nächste Version in der Mapbender Serie. Es wurde unter Verwendung moderner Webtechnologien komplett neu geschrieben. Die Grundlage bildet Symfony2, das erfolgreiche PHP Web Application Framework. Auf der Clientseite finden Sie OpenLayers und jQuery (UI) verbunden über MapQuery.

Mit dieser neuen Code-Grundlage wird die Mapbender Idee eines Geoportal Frameworks fortgesetzt.

• Anwendungen können direkt im Browser erstellt und konfiguriert werden.
• Dienste wie WMS können in einem Service Repository verwaltet und mit Anwendungen verbunden werden.
• Das Rechtemanagement ist sowohl für einzelne Benutzer als auch Gruppen einfach zu verwalten, egal ob sie in einer Datenbank oder über LDAP gespeichert werden.
• Der Administrator braucht keine Zeile Code zu schreiben, da die Konfiguration über die webbasierte Administrationsoberfläche erfolgt.

Sie brauchen nichts weiter als einen Standard Webbrowser für diesen Schnellstart.

Dieser Quickstart beschreibt, wie Sie:

• Mapbender starten
• eine Anwendung erstellen
• einen Web Map Service (OGC WMS) laden
• WMS konfigurieren
• eine individuelle Anwendung erstellen
• Benutzer und Gruppen anlegen und Anwendungen zuweisen

Eine Mapbender Anwendung kann wie folgt aussehen:

Installation

Hinweise zur Installation von Mapbender3 finden Sie unter http://doc.mapbender3.org/en/book/installation.html.

Starten Sie Mapbender

1. Wählen Sie Mapbender aus dem Startmenü oder besuchen Sie http://localhost/mapbender3/app.php
2. Die Anwendung braucht eine kurze Zeit, um zu starten.

Falls Sie Schwierigkeiten haben, Mapbender zu starten, überprüfen Sie ob der Apache Web Server und die PostgreSQL Datenbank laufen.

Starten Sie Mapbender im Entwicklungsmodus über app_dev.php

Symfony bietet einen Entwicklungsmodus mit einer Reihe von Informationen über die Anwendung an (Logging, Fehlermeldungen, Datenbankabfragen, Speicherverbrauch, Zeit und mehr). Dieser Modus ist nur über localhost verfügbar.

1. Start des Entwicklungsmodus: http://localhost/mapbender3/app_dev.php
2. Schauen Sie sich an, welche Information im Entwicklungsmodus angezeigt werden.

Die Willkommensseite

1. Die Willkommensseite listet die öffentlichen Anwendungen auf, die von allen Benutzern aufgerufen werden können. Die Anwendungen werden mit Vorschaubild, Titel und Beschreibung aufgelistet.
2. Sie können die Anwendung per Klick auf den Titel, das Vorschaubild oder den Startbutton aufrufen.
3. Bevor Sie Mapbender administrieren können, müssen Sie sich anmelden.
4. Klicken Sie auf den Link Anmelden oben rechts, um die Loginseite aufzurufen.
5. Sie können sich mit dem Benutzer anmelden, der während der Installation erzeugt wurde. Er kann root heißen mit dem Kennwort root (Dies ist der Standardbenutzer/Kennwort nach der Installation von Mapbender auf der OSGeo-Live. Bitte ändern Sie das Kennwort, wenn Sie eine Produktivumgebung betreiben. Löschen Sie den Benutzer root nicht.).

Nach erfolgreicher Anmeldung werden Sie zur Mapbender Administration weiter geleitet.

Anwendungsübersicht

Nach der Anmeldung werden Sie zur Anwendungsübersicht (Applications) mit einer Liste der für Sie freigegebenen Anwendungen weiter geleitet.

Die Anwendungsübersicht bietet folgende Funktionen:

• Titel und Beschreibung
• Vorschaubild zur Anwendung (sofern bereitgestellt)
• Link zur Anwendung
• Button, um die Anwendung zu kopieren
• Button, um die Anwendung zu bearbeiten
• Button zum Veröffentlichen der Anwendung
• Button, um die Anwendung zu löschen
• mit dem Filtertextfeld kann nach Anwendungen gesucht werden

Erstellen Sie eine eigene Anwendung

Erstellen Sie eine neue Anwendung, indem Sie einen Titel, eine Beschreibung sowie einen URL-Titel eingeben. Anschließend können Sie die Anwendung bearbeiten und Elemente, Themen, Stil (CSS-Editor) und Sicherheitseinstellungen zu verwalten.

1. Wählen Sie Anwendungen --> Neue Anwendung
2. Geben Sie einen Titel und eine Beschreibung der Anwendung ein
3. Geben Sie einen URL-Titel an, der in der URL benutzt wird, um die Anwendung zu starten. Er kann identisch zum Titel sein und sollte keine Leer- und Sonderzeichen enthalten.
4. Laden Sie eine png-Datei und definieren so ein Vorschaubild für die Anwendungsübersicht.
5. Wählen Sie eine Layoutvorlage für die Anwendung. Die Vorlage bestimmt den Aufbau der Anwendung. Mapbender3 stellt Ihnen einige Vorlagen (Templates) zur Verfügung (Fullscreen, Classic..). Sie können aber auch eigene Vorlagen anlegen.
6. Betätigen Sie die Schaltfläche Create, um die Anwendung zu erzeugen.
7. Über den Bearbeiten-Button neben der Anwendung können Sie nun weitere Bearbeitungen durchführen.

Ihre Anwendung wurde erstellt. Jetzt brauchen Sie Elemente (z.B. ein Kartenelement, Navigation, Legende) und Kartendienste, um die Anwendung mit Leben zu füllen.

Tip

Beachten Sie, dass derzeit die Layout-, Icon- und Farbanpassungen im online über den CSS_Editor oder in css- und twig-Dateien erfolgen. Lesen Sie dazu die Dokumentation unter http://doc.mapbender3.org/en/book/templates.html

Kopieren und Umbenennen einer Anwendung

Sie können eine neue Anwendung auch durch Kopieren einer vorhandenen erzeugen. Jede Anwendung, auf die Sie schreibend zugreifen können, verfügt über den Button kopieren . Beim Kopieren wird die Anwendung mitsamt der Dienste kopiert. Die kopierte Anwendung erhält einen abgeleiteten Namen, den Sie im nächsten Schritt anpassen können.

Löschen einer Anwendung

Sie können eine Anwendung aus der Liste Applications über den -Button löschen. Es wird lediglich die Anwendung gelöscht. Die Dienste sind weiterhin im Dienste-Repository vorhanden.

Exportieren und Importieren von Anwendungen und Daten

Sie können eine Anwendung als JSON oder YAML über Applications --> Export exportieren. Für den Export können ein oder mehrere Anwendungen ausgewählt werden. Die Datenquellen können ebenfalls beim Export ausgegeben werden.

Die Export-Datei beinhaltet alle Definitionen, die zum Aufbau der Anwendung (Datenquellen) erforderlich sind. Die Export-Datei kann über Applications --> Import in andere Mapbender3 Installationen oder in die gleiche Installation geladen werden.

Verwaltung von Datenquellen

Mapbender soll verschiedene Dienste wie OGC WMS, OGC WMTS oder OGC WFS verwalten. Jeder Service muss dabei anders verwaltet werden. In der Administration ist dabei für jede Quelle eine eigene Administrationsmöglichkeit (im Moment lediglich WMS) vorgesehen.

Service Repository

1. Gehen Sie auf Datenquelle (Services) und schauen sich die Dienstquellen an.
2. Sie bekommen einen Überblick über die Dienste, die bereits in Mapbender geladen wurden.
3. Typ (z.B. WMS), Titel und Beschreibung bieten eine erste Information über den Dienst.
4. Per Klick auf den Anzeigen-Button bekommen Sie weitere Informationen über die Quelle.
5. Über den Button können Sie die Datenquelle aus Ihrem Repository löschen.

Laden von Web Map Services

Sie können OGC Web Map Services (WMS) in Ihre Anwendung laden. Mapbender3 unterstützt dabei die Versionen 1.1.1 und 1.3.0.

Ein WMS liefert ein XML, wenn das getCapabilities-Dokument angefordert wird. Diese Information wird von Mapbender ausgelesen. Der Client erhält alle notwendigen Informationen über den Dienst aus diesem XML.

Tip

Sie sollten das Capabilities-Dokument zuerst in Ihrem Browser überprüfen, bevor Sie versuchen, den Dienst in Mapbender zu laden.

1. Wählen Sie Datenquelle --> Neue Datenquelle (Sources --> Add Source). Geben Sie den Link zur WMS getCapabilities URL in das Textfeld Dienste-URL (Service URL) ein.
2. Geben Sie Benutzername und Kennwort ein, sofern der Dienst eine Authentifizierung benötigt.
3. Über die Auswahl only valid können Sie Dienste laden, die dem WMS Schema folgen. Dienste, die diesem Schema nicht folgen, könnten vielleicht Probleme in der Anzeige hervorrufen.
4. Klicken Sie Load, um den Dienst in das Repository zu laden.
5. Nach erfolgreicher Registrierung des Dienstes zeigt Mapbender eine Übersicht der Informationen an, die der Dienst geliefert hat.

Hier sind einige Beispiel WMS:

Germany demo

http://wms.wheregroup.com/cgi-bin/germany_workshop.xml?VERSION=1.1.1&REQUEST=GetCapabilities&SERVICE=WMS

WhereGroup OSM WMS

http://osm-demo.wheregroup.com/service

Omniscale OSM WMS (siehe auch http://osm.omniscale.de/) http://osm.omniscale.net/proxy/service?

Fügen Sie Dienste zur Anwendung hinzu

Nach dem erfolgreichen Hochladen eines WMS möchten Sie diesen zu einer Anwendung hinzufügen.

1. Wählen Sie Anwendungen -->Editier-Button --> Layerset.
2. Wählen Sie den Button , um ein Layerset hinzuzufügen. Ein Layerset präsentiert mehrere Layer (mögliche Namen können main für die Hauptkarte und overview für die Übersichtskarte sein)
3. Jetzt können Sie Dienste zum Layerset hinzufügen.
4. Wählen Sie den Button , um dem neuen Layerset Dienste hinzuzufügen.
5. Sie können die Reihenfolge der Dienste und der Ebenen über drag & drop ändern.

Konfiguration von Diensten

Sie können Dienste für Ihre Anwendung konfigurieren. Vielleicht möchten Sie nicht alle Ebenen anzeigen oder Sie möchten die Reihenfolge oder den Titel der Ebenen ändern, die Info-Abfrage für einzelne Ebenen verhindern oder den Maximalmaßstab ändern.

1. Wählen Sie Anwendung --> Editier-Button --> Layerset --> Editier-Button, um eine Instanz zu konfigurieren.
2. Sie sehen eine Tabelle mit den Layern des Dienstes.
3. Sie können die Reihenfolge der Layer über drag & drop ändern.

Dienstekonfiguration

• format - wählen Sie das Format für den getMap-Requests
• infoformat - wählen Sie das Format für getFeatureInfo-Requests (text/html für die Ausgabe als HTML wird empfohlen)
• exceptionformat - wählen Sie das Format für Fehlermeldungen
• opacity - wählen Sie die Opazität (Deckkraft) in Prozent
• visible -
• basesource - soll der Dienst als BaseSource behandelt werden (BaseSources können beim Ebenenbaum ein-/ausgeblendet werden)
• proxy - bei Aktivierung wird der Dienst über Mapbender als Proxy angefordert
• transparency - Standard ist aktiviert, deaktiviert wird der Dienst ohne transparenten Hintergrund angefordert (getMap-Request mit TRANSPARENT=FALSE)
• tiled - Dienst wird in Kacheln angefordert, Standard ist nicht gekachelt (kann bei großer Karte sehr hilfreich sein, wenn der Dienst die Kartengröße nicht unterstützt)
• BBOX factor - bei Anforderung von Kacheln. Wert 0 - es werden keine zusätzlichen Kacheln außerhalb angefordert
• tile buffer - 1 nur der sichtbare Bereich wird angefordert, 1.25 es wird eine größere Karte angefordert

Layerkonfiguration

• title - Layertitel der Service Information (der Titel ist anpassbar)
• active (on/off) - deaktiviert ein Thema in dieser Anwendung
• select allow - Layer ist auswählbar im Ebenenbaum
• select on - Layer ist bei Anwendungsstart aktiv
• info allow - Infoabfrage wird für diesen Layer zugelassen
• info on - Layer Infoabfrage wird beim Start aktiviert
• minscale / maxscale - Maßstabsbereich, in dem der Layer angezeigt wird.
• toggle - aufklappen beim Start der Anwendung
• reorder - Ebenen können über drag&drop in der Anwendung verschoben werden
• ... -> öffnet einen Dialog mit weiteren Informationen
• name - Layername der Service Information (wird beim getMap-Request verwendet und ist nicht veränderbar)
• style - wenn ein WMS mehr als einen Stil anbietet, können Sie einen anderen Stil als den default Stil wählen.

Fügen Sie Elemente zu Ihrer Anwendung hinzu

Mapbender bietet eine Reihe von Elementen (Modulen) an, aus denen Sie Ihre Anwendung aufbauen können. Ihre Anwendung verfügt wiederum über verschiedene Bereiche (Toolbar, Sidepane, Content, Footer), die Sie mit Elementen bestücken können.

1. Wählen Sie Anwendungen --> Editier-Button --> Layers --> Button , um eine Übersicht über die Mapbender3-Elemente zu erhalten.
2. Wählen Sie ein Element aus der Liste aus.
3. Beachten Sie die verschiedenen Bereiche Ihrer Anwendung. Stellen Sie sicher, dass sie das Element zum richtigen Bereich hinzufügen.
4. Konfigurieren Sie das Element. Hinweis: Wenn Sie ein Element z.B. Karte (map) auswählen, sehen Sie lediglich die Optionen für dieses Element und können es entsprechend konfigurieren.
5. Sie können die Position der Elemente über drag & drop ändern.
6. Schauen Sie sich Ihre Anwendung an. Öffnen Sie Ihre Anwendung über den Button .

Beispiele für Elemente, die Mapbender3 anbietet:

• About Dialog
• Activity Indicator - Aktivitätsanzeige
• BaseSourceSwitcher - Hintergrund wechseln
• Button
• Coordinates Display - Koordinatenanzeige
• Copyright
• Feature Info - Informationsausgabe (getFeatureInfo)
• GPS-Position - Positionierung der Karte über den aktuellen Standort
• HTML - Element zur freien Definition von HTML zur Einbindung von Bilder, Texten, Links
• Image Export - Bild kann als png oder jpg exportiert werden
• Legend - Anzeige der Legende der Dienste
• Layertree - Ebenenbaum
• Map - Karte
• Meetingpoint (POI) - Treffpunkt generiert eine URL, über die eine Anwendung mit Hinweistext positioniert werden kann
• Overview - Übersichtskarte
• PrintClient - Druck
• Ruler Line/Area - Linien- und Flächenmessung
• Scale Selector - Auswahl des Maßstabs über eine Auswahlbox
• ScaleBar - Maßstabsleiste
• SimpleSearch - Einfache Suche über SOLR
• Search Router - konfigurierbare Suche über SQL
• Spatial Reference System Selector (SRS Selector) - Auswahl der Projektion über eine Auswahlbox
• Navigation Toolbar (Zoombar)
• WMS Loader - Laden von OGC WMS Diensten über ein Textfeld (getCapabilities-URL)
• WMC Editor - Speichern von Themenplänen
• WMC Loader - Laden von Themenplänen
• WMC List - Laden von Themenplänen über eine Auswahlbox

Sie finden detaillierte Informationen zu jedem Element unter MapbenderCoreBundle Element Dokumentation , MapbenderWmcBundle Element Dokumentation und MapbenderWmsBundle Element Dokumentation.

Versuchen Sie es selber

• Fügen Sie ein Kartenelement (Map-Element) zum content-Bereich Ihrer Anwendung hinzu.
• Fügen Sie ein Inhaltsverzeichnis (Layertree) zum content-Bereich Ihrer Anwendung hinzu.
• Fügen Sie einen Button in die Toolbar, der den Layertree öffnet.
• Fügen Sie das Navigationselement (Navigation Toolbar) in den content-Bereich hinzu
• Fügen Sie ein Copyright-Element hinzu und ändern Sie den Copyright-Text.
• Fügen Sie einen SRS Selector in den Footer-Bereich ein.

Benutzer- und Gruppenverwaltung

Der Zugriff auf eine Mapbender Anwendung benötigt Authentifizierung. Nur öffentliche Anwendungen können von allen Anwendern genutzt werden.

Ein Benutzer kann die Berechtigungen bekommen, um auf eine oder mehrere Anwendungen und Dienste zuzugreifen.

Benutzer anlegen

1. Um einen Benutzer anzulegen, gehen Sie zu New User oder wählen Sie den Button .
2. Wählen Sie einen Namen und ein Kennwort für Ihren Benutzer.
3. Geben Sie eine E-Mail-Adresse für den Benutzer an.
4. Speichern Sie Ihren neuen Benutzer.
5. Weitere Angaben zum Benutzer können im Reiter Profil erfolgen.

Gruppen anlegen

1. Erzeugen Sie eine Gruppe über New Group.
2. Wählen Sie einen Namen und eine Beschreibung für Ihre Gruppe.
3. Speichern Sie Ihre neue Gruppe.

Benutzer einer Gruppe zuweisen

1. Weisen Sie einen Benutzer einer Gruppe über Users --> Groups zu.
2. Wählen Sie einen oder mehrere Benutzer über Users aus, die Sie der Gruppe zuweisen wollen.
3. Weisen Sie einen Benutzer über Users --> Edit-Button--> Groups einer Gruppe zu.

Rechte

Mapbender3 bietet verschiedene Rechte an, die Sie vergeben können. Diese beruhen auf dem Symfony ACL System http://symfony.com/doc/2.1/cookbook/security/acl_advanced.html#built-in-permission-map

• view - anzeigen
• edit - editieren
• delete - löschen
• operator - kann anzeigen, editieren und löschen
• master - kann anzeigen, editieren und löschen und diese Rechte außerdem weitergeben
• owner - Besitzer, darf alles. Darf master und owner Recht vergeben.

Weisen Sie einem Benutzer über Users --> Edit your User --> Security Rechte zu.

Zuweisen einer Anwendung zu einem Benutzer/einer Gruppe

1. Bearbeiten Sie Ihre Anwendung über Anwendungen --> Button
2. Wählen Sie Sicherheit (Security)
3. Veröffentlichen Sie Ihre Anwendung über die Auswahl aktiviert unter Sicherheit oder den Button zur Veröffentlichung
4. Setzen Sie Berechtigungen wie view, edit, delete, operator, master, owner
5. Weisen Sie eine Anwendung einem Benutzern/einer Gruppe zu
6. Testen Sie die Konfiguration!
7. Melden Sie sich über Logout ab.
8. Melden Sie sich unter der neuen Benutzerbezeichnung an

Zuweisen einzelner Elemente zu Benutzern/Gruppen

Standardmäßig stehen alle Elemente den Benutzern/Gruppen zur Verfügung, die Zugriff auf eine Anwendung haben. Der Zugriff kann darüberhinaus für einzelne Elemente noch genauer definiert werden, so dass diese nur bestimmten Benutzern/Gruppen zur Verfügung stehen.

1. Bearbeiten Sie Ihre Anwendung über Anwendungen --> -Button
2. Wählen Sie Layout
3. Jedes Element verfügt über einen -Button
4. Wählen Sie den -Button zu dem Element, das nur ausgewählten Benutzern/Gruppen zur Verfügung stehen soll
5. Weisen Sie das Element Benutzern/Gruppen zu
6. Testen Sie die Konfiguration!

Anwendung beim Start positionieren

Sie können eine Anwendung beim Start positionieren. Dies kann über einen Punkt oder ein Rechteck erfolgen. Beim Start können dabei auch Texte zur Anzeige mitgegeben werden. Diese Funktionalität nutzt das Element Treffpunkt (Meetingpoint).

Sie können dabei einen oder mehrere Punkte (POIS) in der URL übergeben. Jeder Punkt verfügt dabei über die folgenden Parameter:

• Punkt (point): Koordinatenpaar, die Werte werden mit Komma getrennt (zwingend)
• Beschriftung (label): Beschriftung, die angezeigt werden soll (optional)
• Maßstab (scale): Maßstab, in dem der Punkt angezeigt werden soll (optional. Die Angabe ist nur bei der Anzeige eines Punktes sinnvoll)

Wenn Sie mehr als einen Punkt im Aufruf übergeben, zoomt die Karte auf 150% der Gesamt-Boundingbox.

Format für die Übergabe eines Punktes:

• ?poi[point]=363374,5621936&poi[label]=Hello World&poi[scale]=5000

• http://demo.mapbender3.org/application/mapbender_user?poi[point]=363374,5621936&poi[label]=Hello World&poi[scale]=5000

  

Für die Übergabe vieler Punkte wird das folgende Format verwendet:

• ?poi[0][point]=363374,5621936&poi[0][label]=Hello&poi[1][point]=366761,5623022&poi[1][label]=World

Weitere Aufgaben

Hier sind weitere Aufgaben, die Sie ausprobieren können:

1. Versuchen Sie, einige WMS in Ihre Anwendung zu laden. Versuchen Sie Ihre WMS zu konfigurieren.
2. Versuchen Sie eine eigene Anwendung zu erzeugen.

Was kommt als Nächstes?

Dies waren nur die ersten Schritte mit Mapbender3. Es gibt viele weitere Funktionen, die Sie ausprobieren können.

Mapbender Projektseite

http://mapbender.org

Mapbender3 Webseite

http://mapbender3.org/

Sie finden Tutorials unter

http://doc.mapbender3.org

Die API-Dokumentation finden Sie unter

http://api.mapbender3.org

Mapbender kennenlernen unter

http://projects.mapbender.osgeo.org

Beteiligen Sie sich

http://www.mapbender.org/Community