Add new maps to Mapbender
From MapbenderWiki
(deutsche Version weiter unten!)
Contents |
English
Mapbender displays maps from remote map servers (for example MapServer). Mapbender itself cannot create maps but manages and displays them.
Include a new Map
To include the maps of an OGC WMS compliant web map server into a Mapbender client interface (GUI), the Capabilities document has to uploaded to the Mapbender database.
Open the administration interface and choose the category 'WMS management' and the menu item 'Load Capabilities' (LOADWMS => Module: mod_loadCapabilities.php). Here choose a gui in which the map service should be loaded. As a good advice: create a new gui, which contains just the references to the wms and no interface elements are needed. Pay attention that other administrators get also access to the loaded map services by allocate the according gui with the authorization module to a user or a group.
|
Choose a GUI from the list. Fill in the URL to the Capabilities document of the OGC WMS server and hit <upload>.
Example for a GetCapabilities of the UMN MapServer:
|
Request for the Capabilities document by clicking the button 'Load'. The map service returns the XML document, which is then analyzed and stored (cached) in the internal Mapbender database. An overview of the map service's data and containing layers confirms a successful loading of the map service. If the service is not available this process may take more than a few seconds and Mapbender will show an SQL error message instead of the map service' data.
Notice
Ensure that your Mapbender server is allowed to read Capability documents from external sources. The most common error is a misconfiguration of the PHP environment variable allow_url_fopen.
Deutsch
Mapbender zeigt Karten an, die von externen Diensten eingebunden werden (z.B. UMN MapServer). Mapbender selbst ist kein Kartendienst, sondern dient der Verwaltung und Anzeige von lokalen und fernen Diensten.
Neuen Kartendienst einbinden
Um auf die Karten eines OGC WMS-konformen Web Map Server Kartendienstes zugreifen zu können, wird zunächst das Capabilities Dokument angefordert und als Kopie in Mapbender hochgeladen. Alternativ kann das Capabilities Dokument auch temporär eingebunden werden, z.B. über das Modul AddWMS.
Um die Verbindung zum Kartendienst dauerhaft herzustellen öffnen Sie eine Administrationsoberfläche, und gehen in der Rubrik WMS Verwaltung auf das Modul Capabilities hochladen (LOADWMS => Modul: mod_loadCapabilities.php).
Wählen Sie eine GUI aus, in die der Kartendienste geladen werden soll, die Auswahl zeigt nur GUI an für die Sie als Owner eingetragen sind. Es bietet sich an, für das Hochladen neuer Dienste eigene leere GUI anzulegen, die lediglich Verweise auf die WMS enthalten und keine Oberflächenelemente benötigen. Das erleichtert später das Management der Dienste, die Vorkonfiguration der Eigenschaften, Aktualisierung, Monitoring, etc. Aus diesen Gründen sollten Sie neue WMS-Dienste niemals direkt in Kartenoberflächen laden.
Die Installations-Version enthält mehrere solcher GUI, die durch ein vorangestelltes wms_ gekennzeichnet sind. Der Name ist beliebig und hat keinen Einfluss auf die Sichtbarkeit oder Nutzbarkeit der GUI.
Achten Sie darauf, dass Sie anderen Administratoren Zugriff auf die geladenen Kartendienste gestatten, indem Sie den entsprechenden Benutzern Zugriffsrechte auf die GUI einräumen.
|
|
Wählen Sie in der oberen Auswahlliste eine GUI aus, in welche der Kartendienst eingebunden werden soll. Tragen Sie anschließend im unteren Textfeld die URL zu dem entsprechenden Capabilities-Dokument des Kartendienstes ein.
Beispiel für GetCapabilities-Aufruf UMN MapServer:
|
|
Über die Schaltfläche Load wird der getCapabilities Aufruf abgeschickt. Der Kartendienst antwortet mit einem XML Dokument, welches von Mapbender ausgewertet wird. Eine Übersicht der Daten des Kartendienstes und seiner Ebenen bestätigt das erfolgreiche Hochladen des Kartendienstes.
Sollte dieser Prozess länger dauern als ca. eine halbe Minute kann es sein, dass der Dienst nicht verfügbar ist. Mapbender zeigt dann statt der Daten des Kartendienstes eine SQL Fehlermeldung an.
Hinweis
Bitte beachten Sie, dass Mapbender für den Zugriff auf externe Dienste Zugang zum Internet benötigt. Eine fehlerhafte PHP-Einstellung der Variable allow_url_fopen ist die mit Abstand häufigste Ursache für Fehler beim Hochladen von Capabilities Dokumenten.
