MapServer ist eine Open Source serverbasierte Anwendung, mit der geografische Kartenbilder und Vektordaten im Internet mittels OGC standards wie etwa WMS und WFS veröffentlicht werden können.
Dieser Quickstart beschreibt:
Note
Was werden wir lernen ? In diesem Abschnitt werden Sie lernen, was ein mapfile ist und wie man ihn so konfiguriert, dass MapServer ein Shapefile als Bilder bereitstellt, die mittels einer WMS Anfrage abgerufen werden können.
Der Mapfile ist die Konfigurationsdatei, die MapServer nutzt, um raumbezogene Daten wie Bilder oder Vektordaten zu bereitzustellen. Sein Hauptzweck ist es, die Karten die er zeichnet zu lesen und festzulegen, wie diese dargestellt werden (z.B. Farbe, Symbole, Labels, etc. ..).
Fügen Sie folgenden Text ein:
MAP
NAME "MAPSERVER QUICKSTART"
EXTENT -137 29 -53 88
UNITS DD
SHAPEPATH "/home/user/data/natural_earth/"
SIZE 800 600
IMAGETYPE PNG24
PROJECTION
"init=epsg:4326"
END
WEB
METADATA
ows_enable_request "*"
END
END
LAYER
NAME "Admin Countries"
STATUS ON
TYPE POLYGON
DATA "10m_admin_0_countries"
CLASS
STYLE
COLOR 246 241 223
OUTLINECOLOR 0 0 0
END
END
END
END
Note
Das Beispiel verwendet den natural earth Datensatz, der bereits auf der Live-DVD installiert ist: ~/data/natural_earth (eine Abkürzung für: /usr/local/share/data/natural_earth)
Jedes Objekt einem mapfile beginnt mit seinem Namen (z.B. MAP) und endet mit einem END. Ein mapfile beginnt immer mit dem Objekt MAP und sollte eine Liste von LAYER Objekten enthalten, die der Mapfile lesen und zeichnen kann. In unserem mapfile haben wir nur eine Karte definiert.
Note
Eine komplette Liste von Objekten und Eigenschaften, die ein Mapfile haben kann, finden Sie in der MapServer Dokumentation.
Obwohl MapServer für den Einsatz in Webanwendungen ausgerichtet ist, können Bilder auch über die Kommandozeile erzeugt werden. Dies kann beispielsweise bei sich wiederholenden Kartendarstellungen oder beim Debuggen hilfreich sein.
Öffnen Sie ein Terminak und tippen Sie:
shp2img -m mapserver_quickstart.map -o mymap.png
Wenn dieser Aufruf erfolgreich ausgeführt wird, finden Sie ein unter file:///home/user/mymap.png ein generiertes Kartenbild.
Note
Was werden wir lernen ? Sie werden lernen, wie man von einem MapServer ein Bild aus in einem mapfile definierten Karten mittels eines OGC WMS Requests abfragen kann.
Öffnen Sie den Webbrowser mit folgender URL:
http://localhost/cgi-bin/mapserv?map=/home/user/mapserver_quickstart.map&SERVICE=WMS&REQUEST=Getmap&VERSION=1.1.1&LAYERS=Admin%20Countries&SRS=EPSG:4326&BBOX=-137,29,-53,88&FORMAT=PNG&WIDTH=800&HEIGHT=600
Was bedeutet das Obige ? Einfach gesagt, es ist ein Web Map Service (WMS) GetMap Request, der dem mapserver sagt, er soll den angegebenen mapfile verwenden, um bestimmte Karten als PNG Bild mit festgelegten Eigenschaften wie Bildgröße, Ausdehnung, Projektion, etc.* darzustellen. Alle Karten im “&LAYERS=...” Bereich, die STATUS ON oder STATUS DEFAULT im mapfile haben, werden nun dargestellt. Das Ergebnis sollte so aussehen:
Note
Alle Parameter des Requests sind WMS-spezifisch, außer “?map=/home/user/mapserver_quickstart.map“, welcher MapServer-spezifisch ist.
Note
Was werden wir lernen ? Sie werden lernen, wie man neue layer Objekte in einem mapfile definiert.
Wir ergänzen jetzt einen weiteren layer zu unserem mapfile. Vor dem letzten END im mapfile, fügen wir folgende layer konfiguration hinzu:
LAYER
NAME "Lakes"
STATUS ON
TYPE POLYGON
DATA "10m_lakes"
CLASS
STYLE
COLOR 153 179 204
END
END
END
Nun haben wir 2 layer Definitionen in unserem mapfile. Dieser layer hat die “STATUS ON” Eigenschaft. Das heisst, solange wir ihn nicht explizit anfragen, wird er nicht dargestellt.
Nehmen wir nun unseren vorherigen WMS GetMap Request und ergänzen den neuen layer “Lakes” zu dem erzeugten Bild. Dazu müssen wir einfach nur den neuen layer Namen zur “LAYERS” liste hinzufügen:
http://localhost/cgi-bin/mapserv?map=/home/user/mapserver_quickstart.map&SERVICE=WMS&REQUEST=Getmap&VERSION=1.1.1&LAYERS=Admin%20Countries,Lakes&SRS=EPSG:4326&BBOX=-137,29,-53,88&FORMAT=PNG&WIDTH=800&HEIGHT=600
Das Bild, das nun vom MapServer dargestellt wird sieht aus wie das vorherige, nur mit dem zusätzlichen neuen lake Layer:
Note
Was werden wir lernen ? Sie sehen ein Beispiel für die Darstellungselemente eines Layers in Abhängigkeit von seinen Eigenschaften.
In einem MapFile kann ein Layer-Objekt eine unendliche Anzahl von CLASS-Objekten enthalten. Diese werden verwendet, um die Darstellung von Elementen einer Karte (DATA) zu definieren. Zum Beispiel, wenn wir uns die “10m_lakes” Datei mit einem Tool wie ogrinfo <http://www.gdal.org/ogrinfo.html> anzeigen lassen _, sehen wir die Geometrie und Attribut-Definitionen der Objekte . Diese Attributwerte können verwendet werden, um die Objekte innerhalb eines Datensatzes mit mehreren unterschiedlichen CLASS-Objekten unterschiedlich darzustellen.
Im “10m_lakes” Datensatz haben wir das ScaleRank Attribut, welches in Bezug zur Größe der Seen steht. Wir können es benutzen, um die Seen unterschiedlich darzustellen. Im LAYER-Objekt fügen wir ein weiteres CLASS-Objekt hinzu:
LAYER
NAME "Lakes"
STATUS DEFAULT
TYPE POLYGON
DATA "10m_lakes"
CLASSITEM "ScaleRank"
CLASS
EXPRESSION /0|1/
STYLE
COLOR 153 179 204
OUTLINECOLOR 0 0 0
END
END
CLASS
STYLE
COLOR 153 179 204
END
END
END
Was macht dieses neue CLASS-Objekt?
Im Grunde sagt es, das Elemente mit der “ScaleRank”-Eigenschaft gleich “0” oder “1” mit einem schwarzen Umriss gezeichnet werden sollen. CLASS-Objekte werden immer von oben nach unten für jede Funktion gelesen. Wenn ein Objekt mit der “EXPRESSION” in einer Klasse übereinstimmt, wird diese Klasse verwendet, um das Objekt darzustellen. Wenn das Objekt nicht mit einer Klasse übereinstimmt, wird es anhand der nächsten Klasse überprüft. Wenn ein Objekt mit keiner Klasse übereinstimmt, und die letzte Klasse in einem LAYER-Objekt keine “EXPRESSION” enthält, dann wird diese Klasse als Standard benutzt. Das LAYER-Objekt “CLASSITEM” teilt MapServer mit, welches Attribut bei der Auswertung von EXPRESSIONs benutzt werden soll.
Das Ergebnis dieser Ergänzung bewirkt, dass große Seen mit einem schwarzen Umriss gezeichnet werden:
Note
Lernen Sie mehr über EXPRESSIONS im MapServer.
Dies ist ein einfaches Beispiel und Sie können noch viel, viel mehr machen. Die MapServer Projekt Webseite enthält zahlreiche Hilfen, um ihnen einen Start zu ermöglichen. Hier sind ein paar Tipps, wo sie als nächstes nachschauen können:
