MapServer Documentation Release 5.6.6 The MapServer Team May 12, 2011 Contents 1 About 3 2 An Introduction to MapServer5 2.1 MapServer Overview...........................................5 2.2 Anatomy of a MapServer Application..................................6 2.3 Installation and Requirements......................................8 2.4 Introduction to the Mapfile ........................................ 14 2.5 Making the Site Your Own........................................ 21 2.6 Enhancing your site........................................... 22 2.7 How do I get Help?............................................ 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 Cartographic Symbol Construction with MapServer.......................... 63 5.2 CLASS.................................................. 84 5.3 Display of International Characters in MapServer............................ 86 i 5.4 Expressions................................................ 89 5.5 FEATURE................................................ 94 5.6 FONTSET................................................ 95 5.7 INCLUDE................................................ 96 5.8 GRID................................................... 97 5.9 JOIN................................................... 98 5.10 LABEL.................................................. 104 5.11 LAYER.................................................. 107 5.12 LEGEND................................................. 114 5.13 MAP................................................... 114 5.14 OUTPUTFORMAT........................................... 118 5.15 PROJECTION.............................................. 120 5.16 QUERYMAP............................................... 121 5.17 REFERENCE.............................................. 122 5.18 SCALEBAR............................................... 122 5.19 STYLE.................................................. 123 5.20 SYMBOL................................................ 126 5.21 Symbology Examples.......................................... 127 5.22 Templating................................................ 130 5.23 Variable Substitution........................................... 139 5.24 WEB................................................... 140 5.25 Notes................................................... 141 6 MapScript 143 6.1 Introduction............................................... 143 6.2 SWIG MapScript API Reference.................................... 144 6.3 PHP MapScript.............................................. 178 6.4 Python MapScript Appendix....................................... 212 6.5 Python MapScript Image Generation.................................. 214 6.6 Mapfile Manipulation.......................................... 216 6.7 Querying................................................. 219 6.8 MapScript Variables........................................... 221 7 Data Input 229 7.1 Vector Data................................................ 229 7.2 Raster Data................................................ 290 8 Output Generation 303 8.1 AGG Rendering Specifics........................................ 303 8.2 AntiAliasing with MapServer...................................... 305 8.3 Dynamic Charting............................................ 308 8.4 Flash Output............................................... 312 8.5 HTML Legends with MapServer.................................... 318 8.6 HTML Imagemaps............................................ 327 8.7 PDF Output................................................ 329 8.8 SVG................................................... 334 8.9 Tile Mode................................................ 340 9 OGC Support and Configuration 345 9.1 WMS Server............................................... 345 9.2 WMS Client............................................... 365 9.3 WMS Time................................................ 372 9.4 Map Context............................................... 376 9.5 WFS Server............................................... 383 9.6 WFS Client................................................ 392 ii 9.7 WFS Filter Encoding........................................... 395 9.8 SLD.................................................... 402 9.9 WCS Server............................................... 411 9.10 WCS Use Cases............................................. 421 9.11 SOS Server................................................ 426 9.12 MapScript Wrappers for WxS Services................................. 436 10 Optimization 445 10.1 Debugging MapServer.......................................... 445 10.2 FastCGI.................................................. 456 10.3 Mapfile.................................................. 459 10.4 Raster................................................... 461 10.5 Tile Indexes............................................... 462 10.6 Vector................................................... 464 11 Utilities 467 11.1 legend.................................................. 467 11.2 msencrypt................................................ 467 11.3 scalebar.................................................. 469 11.4 shp2img................................................. 469 11.5 shptree.................................................. 471 11.6 shptreetst................................................. 472 11.7 shptreevis................................................. 473 11.8 sortshp.................................................. 474 11.9 sym2img................................................. 476 11.10 tile4ms.................................................. 477 11.11 Batch Scripting.............................................. 481 11.12 File Management............................................. 481 12 CGI 483 12.1 MapServer CGI Introduction....................................... 483 12.2 mapserv.................................................. 484 12.3 Map Context Files............................................ 484 12.4 MapServer CGI Controls......................................... 485 12.5 Run-time Substitution.......................................... 489 12.6 A Simple CGI Wrapper Script...................................... 491 13 Community Activities 493 13.1 IRC.................................................... 493 13.2 Mailing Lists............................................... 494 13.3 MapServer Wiki Pages.......................................... 495 13.4 MapServer Service Providers...................................... 495 14 Development 497 14.1 Sponsors................................................. 497 14.2 Bug Submission............................................. 498 14.3 Subversion................................................ 498 14.4 Documentation Development Guide................................... 499 14.5 Testing.................................................. 506 14.6 Request for Comments.......................................... 512 14.7 Mapfile Editing.............................................. 711 14.8 External Links.............................................. 713 15 Download 715 15.1 Source.................................................. 715 iii 15.2 Documentation.............................................. 715 15.3 Binaries.................................................. 716 15.4 Demo Application............................................ 717 16 Glossary 719 17 Errors 723 17.1 drawEPP(): EPPL7 support is not available............................... 723 17.2 loadMapInternal(): Given map extent is invalid............................. 723 17.3 msSaveImageGD(): Unable to access file................................ 724 17.4 msLoadMap(): Failed to open map file................................. 725 17.5 msQueryByPoint: search returned no results.............................. 725 17.6 msLoadFontset(): Error opening fontset................................. 725 17.7 msGetLabelSize(): Requested font not found.............................. 726 17.8 loadLayer(): Unknown identifier. Maximum number of classes reached................ 726 17.9 msReturnPage(): Web application error. Malformed template name.................. 726 17.10 Unable to load dll (MapScript)...................................... 726 17.11 msProcessProjection(): Projection library error.major axis or radius = 0 not given........... 727 17.12 msProcessProjection(): no options found in ‘init’ file.......................... 727