project logo

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, die brandneue Version des erfolgreichen Symfony PHP Web Application Framework.

Auf der Clientseite finden Sie OpenLayers und jQuery (UI) verbunden über MapQuery.

Mit dieser neuen Code-Grundlage setzen wir die Mapbender Idee eines Geoportal Frameworks fort.
  • 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.

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 eigene Anwendung erstellen
  • Benutzer und Gruppen anlegen und Anwendungen zuweisen

Eine Mapbenderanwendung wie folgt aussehen:

../../_images/mapbender3_basic_application.png

Installation

Hinweise zur Installation von Mapbender finden Sie unter installation.

Starten Sie Mapbender

  1. Wählen Sie Mapbender aus dem Startmenü oder besuchen Sie http://localhost/mapbender3/app.php
  2. Die Anwendung braucht ein 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_dep.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.

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

Die Willkommensseite

  1. Die Willkommensseite listet die öffentlichen Anwendungen auf, die von allen Benutzern aufgerufen werden können. Die Anwendungen werden mit Screenshot, Titel und Beschreibung aufgelistet.
  2. Sie können die Anwendung per Klick auf den Titel oder den Startbutton aufrufen.
  3. Bevor Sie Mapbender administrieren können, müssen Sie sich anmelden.
  4. Klicken Sie auf das Mapbender-Logo links, um die Loginseite aufzurufen.
  5. Sie können sich mit den Benutzer anmelden, der während der Installation erzeugt wurde. Es kann root heißen mit dem Kennwort root (Dies ist der Standardbenutzer und 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.).
../../_images/mapbender3_welcome.png

Nach erfolgreicher Anmeldung werden Sie zur Mapbender Administration weiter geleitet.

Anwendungsübersicht

Nach der Anmeldung werden Sie zum Applications mit einer Liste von für Sie freigegebenen Anwendungen weiter geleitet.

Die Anwendungsübersicht bietet folgende Funktionen:

  • Titel und Beschreibung
  • Ein Link zur Anwendung
  • Eine Schaltfläche um die Anwendung zu bearbeiten
  • Ein Icon zum Veröffentlichen der Anwendung
  • Eine Schaltfläche um eine neue Anwendung anzulegen
  • Eine Schaltfläche um die Anwendung zu löschen
../../_images/mapbender3_application_overview.png

Erstellen Sie eine eigene Anwendung

Erstellen Sie eine neue Anwendung, indem Sie einige grundlegende Informationen eingeben. Anschließend können die den Editiermodus benutzen, um Elemente, Layer und Sicherheitseinstellungen zu verwalten.

  1. Wählen Sie Applications ‣ New Application
  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.
  4. Betätigen Sie die Schaltfläche Create, um die Anwendung zu erzeugen.
  5. Gehen Sie zu Edit-Button neben der Anwendung und wählen Sie die neue Anwendung aus.
  6. Ihre Anwendung wurde erstellt. Jetzt brauchen Sie WMSs, die in Ihrer Anwendung dargestellt werden. Dies wird im Abschnitt WMS Management beschrieben.
../../_images/mapbender3_create_application.png

Löschen einer Anwendung

Sie können eine Anwendung aus der Liste Applications über den +-button löschen. Nur die Anwendung wird gelöscht, nicht die Dienste, die in der Anwendung eingebunden waren.

Verwaltung von Datenquellen

Mapbender kann verschiedene Dienste wie OGC WMS, OGC WMTS oder OGC WFS verwalten. Jeder Service muss anders verwaltet werden. Die Administration bietet für jede Quelle eine Administrationsoberfläche (im Moment lediglich WMS).

Überblick des Service Repository

  1. Gehen Sie auf 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, WMTS), Titel und Beschreibung bieten eine erste Information über den Dienst.
  4. Per Klick auf den View-Button bekommen Sie weitere Informationen über die Quelle.
  5. Über den Delete-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 Applikation laden.

Ein WMS liefert eine XML-Datei, wenn das getCapabilities-Dokument angefordert wird. Diese Information wird von Mapbender analysiert, wodurch er alle notwendigen Informationen über den Dienst aus diesem XML erhält.

Tip

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

  1. Wählen Sie Services ‣ Add Service. Geben Sie den Link zur WMS getCapabilities URL in das Textfeld Originurl ein.
  2. Geben Sie Nutzername und Kennwort ein, sofern der Dienst Authentifizierung benötigt.
  3. Klicken Sie Load, um den Dienst in das Repository zu laden.
  4. Nach erfolgreicher Registrierung des Dienstes zeigt Mapbender eine Übersicht der Informationen an, die der Service geliefert hat.
../../_images/mapbender3_wms_load.png

Hier sind einige Beispiel WMS:

Germany demo

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

WhereGroup OSM WMS (siehe auch http://www.wheregroup.com/de/osmwms)

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

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 Applications ‣ Edit-Button ‣ Layers ‣ Edit-Button.
  2. Wählen Sie den +-button um ein layerset hinzuzufügen. Ein Layerset präsentiert mehrere Layer (ein möglicher Name könnte main 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 in Ihrer Anwendung über drag & drop ändern.
../../_images/mapbender3_add_source_to_application.png

Konfigurieren von Diensten

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

  1. Wählen Sie Applications ‣ edit-Button ‣ Layers ‣ edit-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.
../../_images/mapbender3_wms_application_settings.png

Servicekonfiguration

  • format - wählen Sie das Format für den getMap-Requests
  • infoformat - wählen Sie das Format für getFeatureInfo-Requests
  • exceptionformat - wählen Sie das Format für exceptions
  • opacity - wählen Sie die Opazität (Deckkraft) in Prozent
  • visible
  • proxy
  • transparency
  • tiled - Sie können eine WMS in Kacheln anfordern, Standard ist nicht gekachelt.

Layerkonfiguration

  • title - layer title von der Service Information
  • active (on/off) - schaltet einen Layer in dieser Anwendung ein/aus
  • select on - auswählbar im Geodatenexplorer (Layerbaum)
  • select allow - Layer ist bei Anwendungsstart aktiv
  • info on - der Layer reagiert auf feature info requests, info default aktiviert diese Funktionalität in der Anwendung
  • info allow
  • minscale / maxscale - Der Maßstabsbereich, in dem der Layer angezeigt wird. 0 bedeutet keine Maßstabsbeschränkung
  • toggle
  • reorder
  • ... -> öffnet einen Dialog mit weiteren Informationen
  • name
  • style - wenn ein WMS mehr als einen Style anbietet, können Sie einen anderen Style als den default Style wählen.

Fügen Sie Elemente zu Ihrer Anwendung hinzu

Mapbender biete eine Reihe von Elementen. Sie können diese Anwendung in verschiedene Bereiche (Toolbar, Sidepane, Content, Footer) ihrer Anwendung hinzufügen.

../../_images/mapbender3_application_add_element.png
  1. Wählen Sie :menuselection:Applications ‣ edit-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 verschienden Bereiche, die Sie in Ihrer Anwendung haben. Stellen Sie sicher, dass sie das Element zum richtigen Bereich hinzufügen.
  4. Sehen Sie sich ihre Anwendung an. Öffnen Sie Ihre Anwendung über Applications ‣ Applications Overview
../../_images/mapbender3_application_elements.png

Wenn Sie ein Element, z.B. map auswählen, sehen Sie die Optionen für dieses Element und können es entsprechend konfigurieren.

Beispiele für Elemente, die Mapbender3 anbietet:

  • About Dialog
  • Activity Indicator
  • Button
  • Coordinates Display
  • Copyright
  • Feature Info
  • GPS-Position
  • Legend
  • Layertree - Table of Content
  • Map
  • Overview
  • PrintClient
  • Ruler Line/Area
  • Scale Selector
  • ScaleBar
  • Search Router
  • SRS Selector
  • Spatial Reference System Selector (SRS Selector)
  • Navigation Toolbar (Zoombar)
  • WMS Loader

Sie finden detaillierte Informationen zu jedem Element unter MapbenderCoreBundle element documentation.

Versuchen Sie es selber

  • Fügen Sie eine Karte (Map-Element) zum content-Bereich Ihrer Anwendung hinzu.
  • Fügen Sie ein Inhaltsverzeichnis (Layertree) zum content-Bereich Ihrer Anwendung hinzu.
  • Fügen Sie einen Butten hinzu, der das den Layertree öffnet.
  • Fügen Sie das Navigationselement 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

Zugriff auf eine Mapbenderanwendung benötigt Authentifizierung. Nur öffentliche Anwendungen können von allen genutzt werden.

Ein Benutzer hat Berechtigungen, 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.
../../_images/mapbender3_create_user.png

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.
../../_images/mapbender3_assign_user_to_group.png

Rollen

Mapbender3 bietet verschiedene Rollen an, die Sie einer Gruppe zuweisen können.

  • Kann alles administrieren (super admin)
  • Kann Benutzer & Gruppen administrieren
  • Kann Anwendungen administrieren
  1. Weisen Sie einer Gruppe eine Rolle über Users ‣ Edit your User ‣ Security zu.
../../_images/mapbender3_roles.png

Zuweisen einer Anwendung zu einem Benutzer/einer Gruppe

  1. Bearbeiten Sie Ihre Anwendung über Application ‣ Edit-Button.
  2. Wählen Sie Security
  3. Setzten Sie Berechtigungen wie view edit delete operator master owner
  4. Weisen Sie eine Anwendung einem Benutzern/einer Gruppe zu
  5. Testen Sie die Konfiguration!
  6. Melden Sie sich über Logout ab.
  7. Melden Sie sich unter der neuen Benutzerbezeichnung an
../../_images/mapbender3_security.png

Weitere Aufgaben

Hier sind einige weiter Dinge, die Sie ausprobieren sollten:

  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

Lernen Sie Mapbender kennen

http://projects.mapbender.osgeo.org

Beteiligen Sie sich

http://www.mapbender.org/Community