Neuerungen des UMN MapServers 5.0

Mapfile
Siehe auch: http://trac.osgeo.org/mapserver/browser/branches/branch-5-0/mapserver/MIGRATION_GUIDE.TXT

Mittlerweile ist es möglich, dass Labelbeschriftungen dynamisch aus einem Wertefeld generiert werden. Dieses funktioniert über „SIZE [meingroessenfeld]“

Eine Anbindung an eine PostGIS-Datenbank z.B., welche in einer Tabelle die Spalte „groesse“ mit unterschiedlichen Integerwerten beinhaltet, produziert dann über folgende Mapfile-Angaben:

LABEL TYPE TRUETYPE FONT 'arial' SIZE [groesse] COLOR 0 0 0 END

z.B. folgende Karte:



In 5.0 funktionieren die LAYER- Parameter LABELANGLEITEM und LABELSIZEITEM nicht mehr, genauso wenig wie die STYLE-Parameter ANGLEITEM und SIZEITEM.

Nicht nur für Labelgrössen können Werte aus einem Tabellenfeld gelesen werden. Dieses funktioniert nun auch im STYLE-Bereich für folgende Parameter:

ANGLE, COLOR, OUTLINECOLOR, SIZE, SYMBOL

bzw. im Label-Bereich für

ANGLE, COLOR, OUTLINECOLOR, SIZE, FONT, PRIORITY

Farbangaben können mittlerweile nicht nur in RGB (z.B. 220 0 0) sondern auch hexadezimal angegeben werden (z.B. #ff00ff).

Einige Parameter scheinen früher oder später ausgetauscht zu werden. So wird im empfohlen im Layerbereich nicht mehr den Parameter TRANSPARENCY sondern ab jetzt OPACITY zu verwenden. Anstelle von MINSCALE,SYMBOLSCLALE etc. wird empfohlen MINSCALEDENOM bzw. SYMBOLSCALEDENOM zu nutzen (DENOM steht für „denominator“, zu Deutsch: „Nenner“; somit soll verdeutlicht werden, dass sich der Wert z.B. MINSCALEDENOM 24000 auf den Nenner-Wert des Maßstab 1:24000 bezieht).

Neu ist zudem der Parameter PRIORITY im LABEL-Bereich. Mit diesem kann festgelegt werden, welches Label (sogar bezogen auf Attribute) mit welcher Priorität gezeichnet werden soll.

Im MapServer sind mittlerweile die DEBUGGING-Möglichkeiten gestiegen. Waren früher nur die Parameter DEBUG ON/OFF möglich, so geht jetzt DEBUG 0, DEBUG 1, DEBUG 2,........DEBUG 5. Je höher die Zahl desto mehr Informationen. Bei der Versionsabfrager über ./mapserv -v (z.B.) erscheint nun kein SUPPORTS=DEBUG mehr. Der Debug-Modus ist nun per se aktiviert. Ein "enable-Debug" beim konfigurieren ist nur für Fehlermeldungen während des kompilierens notwendig.

Diagramme (Layertypus Chart)
Seit Version 5.0 kann man im MapServer den Layertypus CHART setzen, welcher für Diagramme zuständig ist.

Siehe dazu auch: http://mapserver.gis.umn.edu/docs/howto/dynamic-charting

Ein einfaches Beispiel:

LAYER NAME        'chart' TYPE       CHART STATUS    DEFAULT PROCESSING "CHART_TYPE=pie" PROCESSING "CHART_SIZE=30" CONNECTIONTYPE postgis CONNECTION 'blablabla' DATA 'the_geom from landkreis' CLASS NAME "Bevölkerung 0-18" STYLE SIZE [bev_0_18] COLOR 220 0 0 END END CLASS NAME "Bevölkerung 19-30" STYLE SIZE [bev_19_30] COLOR 0 0 220 END END END

Ergibt z.B. das (hier fiktive Werte):

Durch das Setzen des Parameters

PROCESSING "CHART_TYPE=BAR"

erhält man dann auch Balkendiagramme



Symbolfile
Im Symbolfile wird empfohlen den STYLE-Parameter durch „Pattern“ zu ersetzen, also von nun an z.B.

SYMBOL Name 'linie_6_1' TYPE VECTOR POINTS 1 1 2 1 2 2 1 2 1 1 END PATTERN 17 2 END END
 * 1) Streitige Grenze,OS 0235

Der Grund ist, dass es in der Vergangenheit immer wieder zu Verwechselungen mit dem STYLE-Parameter im CLASS-Bereich des Mapfiles kam.

Styling/Symbology
In MapServer 5.0 ist es jetzt auch möglich, dass PIXMAP-Symbole entlang einer Linie gezeichnet werden und durch den GAP-Parameter ein Zwischenraum deklariert wrid (mit TrueTypeFonts ging das ja auch zuvor schon).

URL
In früheren MapServer-Versionen war es auf mehr oder minder umständlichem Wege bereits möglich im CGI-Modus Parameter des Mapfiles zu verändern. In Version 5 ist dieses vereinfacht worden, es lassen sich nun ganze Bereiche austauschen.

Beispiel für Veränderung der Maßstabsleiste:

...&map.scalebar=UNITS+MILES+COLOR+121+121+121+SIZE+300+2&...

PHP/Mapscript
Auch hier gibt es einige Umbenennungen. Der Parameter für die Layertransparenz heißt nun „Opacity“. Parameter, welche „scale“ enthalten (symbolscale, maxscale, etc.), erhalten nun die Endung „denom“, also z.B. symblscaledenom, maxscaledenom etc. Der Parameter „style“ des SymbolObjects heisst jetzt pattern. “Stylelength”, “setStyle” und “getStyleArray” warden in patternlength, setPattern and getPatternArray umbenannt. layer.getShape(int tileindex, int shapeindex) ändert sich in layer.getFeature(int shapeindex [, int tileindex = -1]). class.getExpression and layer.getFilter sollten durch class.getExpressionString bzw. layer.getFilterString(= ersetzt warden.

OGC WMS
In der Vergangenheit brauchte man bei WMS-Aufrufen in Verbindung mit dem UMN nicht alle von der OGC vorgeschriebenen Parameter aufrufen. Siehe dazu auch:

http://www.selbstverwaltung-bundesweit.de/mapserver/anleitungen/wms_wfs_anleitung.pdf (S.9-10)

Um OGC-WMS-Konformität zu erzeugen werden nun die von der OGC terminierten Parameter auch verpflichtend vom UMN erwartet. Ein Aufruf der Art von: http://localhost/cgi-bin/mapserv.exe?map=C:/ms4w/Apache/htdocs/umnkursII/ wms_wfs/wms_ogc/wms_server.map&SERVICE=WMS&Request=GetMap&VERSION=1.1.1& layers=landkreis_wms,punktdaten_wms&BBOX=3430000,5899000,3490000,5953000& FORMAT=image/png&width=400&height=400&STYLES=,,

würde also eine Fehlermeldung produzieren, weil der SRS-Parameter fehlt.

AGG-Rendering
MapServer arbeitet jetzt mit der AGG-Rendering-Bibliothek.

Siehe dazu: http://mapserver.gis.umn.edu/docs/howto/agg-rendering-specifics

Die deutschsprachige Übersetzung dieses Dokumentes stammt von Kai Behncke.