Project logo OSGeo Project

MapServer Quickstart

MapServer ist eine Open Source serverbasierte Anwendung, mit der geografische Kartenbilder und Vektordaten im Internet mittels OGC standards wie etwa WMS , WFS und WCS veröffentlicht werden können.

Dieser Quickstart beschreibt:

MapServer mit einem “mapfile” konfigurieren

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.

Was ist ein MapFile ?

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. ..).

Erstellen eines ersten MapFile

  1. Öffnen Sie einen Texteditor (e.g. Applications ‣ Accessories ‣ Leafpad).
  2. Erstellen Sie eine Datei “mapserver_quickstart.map” in Ihrem Home Verzeichnis: /home/user/mapserver_quickstart.map

Fügen Sie folgenden Text ein:

MAP
  NAME "MAPSERVER QUICKSTART"
  EXTENT -137 29 -53 88
  UNITS DD
  SHAPEPATH "/home/user/data/natural_earth2/"
  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 "ne_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_earth2 (eine Abkürzung für: /usr/local/share/data/natural_earth2)

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.

Lassen Sie uns einen Blick auf einige Objekte (und Eigenschaften) werfen, die in unserem mapfile definiert sind:
  • EXTENT : definiert die Standard GIS BoundingBox für diese Konfiguration.
  • LAYER : definiert den Zugriff und die Anzeige-Eigenschaften für einen räumlichen Datensatz. Wir werden weitere Karten später hinzufügen.
  • SHAPEPATH : definiert einen Basispfad für Datei-basierte Daten (z.B. Shape-Dateien oder TIFF-Bilder).
Wenn wir genauer auf das Objekt LAYER in unserem mapfile schauen, sehen wir, dass es auch eine Reihe von Objekten und Eigenschaften enthält.
  • STATUS : ob die Karte gezeichnet (ON), nicht gezeichnet (OFF) oder immer gezeichet werden soll (DEFAULT).
  • TYPE : der Geometrietyp, den der MapServer benutzen soll, wenn die Daten als Bild gezeichnet werden. In unserem mapfile werden die Daten als Polygon dargestellt.
  • DATA : der Name des Datentyps der Karte, in diesem Fall ein Shapefile.
  • CLASS : legt fest, wie eine Karte gezeichnet werden soll (styling). Wir gehen darauf später noch genauer ein.

Note

Eine komplette Liste von Objekten und Eigenschaften, die ein Mapfile haben kann, finden Sie in der MapServer Dokumentation.

Erzeugen eines Kartenbildes über die Kommandozeile

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.

Darstellen einer Karte mit MapServer mittels eines WMS GetMap Requests

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:

../../_images/mapserver_map1.png

Note

Alle Parameter des Requests sind WMS-spezifisch, außer “?map=/home/user/mapserver_quickstart.map”, welcher MapServer-spezifisch ist.

Einen neuen Layer im “mapfile” ergänzen, um eine Shapefile darzustellen

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 "ne_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:

../../_images/mapserver_lakes1.png

Darstellung eines Layers anpassen mit “mapfile” Konfigurationen

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 ON
 TYPE POLYGON
 DATA "ne_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:

../../_images/mapserver_lakes_scalerank1.png

Note

Lernen Sie mehr über EXPRESSIONS im MapServer.