MapServer Documentation Release 5.6.6 The MapServer Team 12. 05. 2011 Inhaltsverzeichnis 1 Übersicht 3 2 Einführung zum MapServer 5 2.1 MapServer Überblick..........................................5 2.2 Anatomie einer MapServer Anwendung.................................6 2.3 Systemanforderungen und Installationshinweise............................8 2.4 Einführung zum Mapfile ......................................... 14 2.5 Eine eigene MapServer-Anwendung................................... 21 2.6 Die eigene Anwendung erweitern.................................... 22 2.7 Wie bekomme ich Hilfe?......................................... 23 3 MapServer Tutorial 25 3.1 Tutorial Timeframe............................................ 25 3.2 Tutorial Data............................................... 25 3.3 Before Using the Tutorial........................................ 26 3.4 Windows, UNIX/Linux Issues...................................... 26 3.5 Other Resources............................................. 27 3.6 Section 1: Static Maps and the MapFile................................. 27 3.7 Section 2: CGI variables and the User Interface............................. 28 3.8 Section 3: Query and more HTML Templates.............................. 29 3.9 Section 4: Advanced User Interfaces................................... 29 4 Installation 31 4.1 Compiling on Unix............................................ 31 4.2 Compiling on Win32........................................... 39 4.3 PHP MapScript Installation....................................... 45 4.4 .NET MapScript Compilation...................................... 51 4.5 IIS Setup for MapServer......................................... 56 4.6 Oracle Installation............................................ 59 5 Mapfile 63 5.1 CLASS.................................................. 63 5.2 Expressions................................................ 66 5.3 FEATURE................................................ 71 i 5.4 FONTSET................................................ 72 5.5 INCLUDE................................................ 73 5.6 GRID................................................... 74 5.7 JOIN................................................... 75 5.8 LABEL.................................................. 80 5.9 LAYER.................................................. 83 5.10 LEGEND................................................. 89 5.11 MAP................................................... 90 5.12 OUTPUTFORMAT........................................... 93 5.13 PROJECTION.............................................. 96 5.14 QUERYMAP............................................... 97 5.15 REFERENCE.............................................. 98 5.16 SCALE.................................................. 98 5.17 STYLE.................................................. 99 5.18 SYMBOL................................................ 102 5.19 Konstruktion von kartographischen Signaturen............................. 103 5.20 Signaturbeispiele............................................. 124 5.21 Templating................................................ 126 5.22 Variable Substitution........................................... 135 5.23 WEB................................................... 136 5.24 Notes................................................... 137 6 MapScript 139 6.1 Introduction............................................... 139 6.2 SWIG MapScript API Reference.................................... 140 6.3 PHP MapScript.............................................. 174 6.4 Python MapScript Appendix....................................... 207 6.5 Python MapScript Image Generation.................................. 209 6.6 Mapfile Manipulation.......................................... 211 6.7 Querying................................................. 214 6.8 MapScript Variables........................................... 216 7 Data Input 223 7.1 Vector Data................................................ 223 7.2 Raster Data................................................ 284 8 Output Generation 297 8.1 AGG Rendering Specifics........................................ 297 8.2 AntiAliasing with MapServer...................................... 299 8.3 Dynamic Charting............................................ 302 8.4 Flash Output............................................... 306 8.5 HTML Legends with MapServer.................................... 312 8.6 HTML Imagemaps............................................ 321 8.7 PDF Output................................................ 323 8.8 SVG................................................... 328 8.9 Tile Mode................................................ 334 9 OGC Support and Configuration 339 9.1 WMS Server............................................... 339 9.2 WMS Client............................................... 359 9.3 WMS Time................................................ 366 9.4 Map Context............................................... 370 9.5 WFS Server............................................... 377 9.6 WFS Client................................................ 386 9.7 WFS Filter Encoding........................................... 389 ii 9.8 SLD.................................................... 396 9.9 WCS Server............................................... 405 9.10 WCS Use Cases............................................. 415 9.11 SOS Server................................................ 420 9.12 MapScript Wrappers for WxS Services................................. 430 10 Optimization 439 10.1 Debugging MapServer.......................................... 439 10.2 FastCGI.................................................. 450 10.3 Mapfile.................................................. 453 10.4 Raster................................................... 455 10.5 Tile Indexes............................................... 456 10.6 Vector................................................... 458 11 Werkzeuge 461 11.1 legend.................................................. 461 11.2 msencrypt................................................ 461 11.3 scalebar.................................................. 463 11.4 shp2img................................................. 463 11.5 shptree.................................................. 465 11.6 shptreevis................................................. 466 11.7 sortshp.................................................. 467 11.8 sym2img................................................. 469 11.9 tile4ms.................................................. 470 11.10 Stapelverarbeitung............................................ 474 12 CGI 475 12.1 MapServer CGI Introduction....................................... 475 12.2 mapserv.................................................. 476 12.3 Map Context Files............................................ 476 12.4 MapServer CGI Controls......................................... 477 12.5 Run-time Substitution.......................................... 481 12.6 A Simple CGI Wrapper Script...................................... 483 13 Community Activities 485 13.1 IRC.................................................... 485 13.2 Mailing Lists............................................... 486 13.3 MapServer Wiki Pages.......................................... 487 13.4 MapServer Service Providers...................................... 487 14 Development 489 14.1 Sponsors................................................. 489 14.2 Bug Submission............................................. 490 14.3 Subversion................................................ 490 14.4 Documentation Development Guide................................... 491 14.5 Testing.................................................. 498 14.6 Request for Comments.......................................... 504 14.7 Mapfile Editing.............................................. 703 14.8 External Links.............................................. 705 15 Download 707 15.1 Source.................................................. 707 15.2 Documentation.............................................. 707 15.3 Binaries.................................................. 708 15.4 Demo Application............................................ 709 iii 16 Glossary 711 17 Errors 715 17.1 drawEPP(): EPPL7 support is not available............................... 715 17.2 loadMapInternal(): Given map extent is invalid............................. 715 17.3 msSaveImageGD(): Unable to access file................................ 716 17.4 msLoadMap(): Failed to open map file................................. 717 17.5 msQueryByPoint: search returned no results.............................. 717 17.6 msLoadFontset(): Error opening fontset................................. 717 17.7 msGetLabelSize(): Requested font not found.............................. 718 17.8 loadLayer(): Unknown identifier. Maximum number of classes reached................ 718 17.9 msReturnPage(): Web application error. Malformed template name.................. 718 17.10 Unable to load dll (MapScript)...................................... 718 17.11 msProcessProjection(): Projection library error.major axis or radius = 0 not given........... 719 17.12 msProcessProjection(): no options found in ‘init’ file.......................... 719 17.13 msProcessProjection(): No such file or directory............................ 720 17.14 msQueryByPoint: search returned no results.............................. 720 18 FAQ 723 18.1 Where is the MapServer log