3.2. 交互式地图与浏览模型#

3.2.1. 查看示例#

上面的地图在 map 在模式下生成。它是静态地图(当您单击时不会发生任何变化)。

但打开下面的地图，你可以使用鼠标点击来进行互操作。

https://webgis.cn/cgi-bin/mapserv?map=/owg/mdc1.map&layer=states_line&layer=topo&mode=browse

3.2.2. 使用POST表单提交CGI变量#

以前，您将MapServer需要的所有参数放在URL中，这是显式使用参数的方式，但这可能会导致URL变得非常长。

说明#

另一种方法是使用表单提交参数。这是一张表格：

邮寄表格#

这部分代码如下所示

<form method=POST action="/cgi-bin/mapserv">
<input type="submit" value="Use forms to generate maps">
<input type="hidden" name="map" value="/owg/mfc1.map">
<input type="hidden" name="layer" value="modis">
<input type="hidden" name="layer" value="states_line">
</form>
<IMG SRC="[img]" width=400 height=300 border=0>

对于POST提交，需要将参数放置在表单中。

3.2.3. 映射文件和模板文件描述#

映射文件描述#

现在，我们来看一下 Mapfile ：

 1MAP
 2    NAME "mapv19"
 3    IMAGETYPE "PNG24"
 4    EXTENT -180 -90 180 90
 5    SIZE 600 300
 6    SHAPEPATH "/gdata"
 7    SYMBOLSET "../symbols/symbols35.sym"
 8    FONTSET "../fonts/fonts.list"
 9    IMAGECOLOR 255 255 255
10    WEB
11        TEMPLATE "tmpl-pan.html"
12        IMAGEPATH "/owg/ms_tmp/"
13        IMAGEURL "/ms_tmp/"
14    END
15    LAYER
16        NAME "topo"
17        DATA "land_shallow_topo_8192.tif"
18        STATUS OFF
19        TYPE RASTER
20        PROCESSING "BANDS=1,2,3"
21        OFFSITE 71 74 65
22    END
23    LAYER
24        NAME "states_line"
25        DATA "wcountry.shp"
26        STATUS OFF
27        TYPE LINE
28        CLASS
29            NAME "State Boundary"
30            STYLE
31                SYMBOL "line5"
32                COLOR 255 255 0
33                SIZE 1
34            END
35        END
36    END
37END

与静态映射相比，只有以下行实际添加到Mapfile中：

TEMPLATE 'example1-9.html'

这会告知MapServer使用该页面 example1-9.html 作为模板文件。在将该文件发送到Web浏览器之前，MapServer将处理该文件并替换其遇到的标记。这是MapServer实现动态页面的机制。

上面的代码片段定义了Web对象的参数，从关键字开始 WEB 并以关键字结束 END 。这个 WEB 对象向地图服务器告知该HTML模板文件的名称(在本例中，只有一个名为 example1-9.html )、要创建的图像的路径以及指向这些图像的URL。与前面一样，IMAGEPATH指定由MapServer创建的图像的路径。在这种情况下，您使用绝对路径，但也可以使用来自映射文件位置的相对路径。请注意，不能删除前导斜杠或末尾斜杠 / 来自IMAGEURL。由IMAGEURL定义的字符串被附加到基本URL(即，http://localhost)，以生成页面上呈现的图像的URL。

请注意，如果您不确定 / ，或者阿帕奇的什么 DocumentRoot 是，你可以在http://httpd.apache.org/docs/mod/core.html#documentroot.上查到

超文本标记语言文件#

在模板文件中，除了HTML文本内容之外，关键是该页面中的表单代码块(在浏览器页面上单击鼠标右键并选择“查看源代码”或类似的内容)：

现在，让我们为我们的应用程序构建一个交互界面。

下面显示了如何使用表单提交，并通过输入控件传递各种参数。

<!-- START OF MAPSERVER FORM -->
<form name="mapserv" method="GET" action="/cgi-bin/mapserv">
    <input type="hidden" name="root" value="/owg">

用户每次单击地图时，此块都会执行MapServer CGI程序( /cgi-bin/mapserv )。可以使用以下内容定义此处的程序：

<input type="hidden" name="program" value="/cgi-bin/mapserv">

以下两个变量是用户定义的变量。如果它在方括号中找到正确的标记 [] ，MapServer将把它的值传递给HTML模板。

map 和 layer 变量是MapServer内部变量。它们是MapServer地图应用程序所必需的。

  <!-- HIDDEN MAPSERVER CGI VARIABLES -->
  <input type="hidden" name="map" value="[map]">
  <input type="hidden" name="imgext" value="[mapext]">
  <input type="hidden" name="imgxy" value="199.5 149.5">
  <input type="hidden" name="zoom" value="1">
  <input type="hidden" name="mode" value="browse">

  <div align="center">
  <table border="1" cellpadding="0" cellspacing="0">
  <tr>
        <td>
          <!-- THE INTERACTIVE, DYNAMICALLY CREATED MAP --
          <input type="image" name="img" src="[img]"
            width="400" height="300">
        </td>
      </tr>
    </table>
  </div>
</form>

这个 map_web_template 变量将替换映射文件中Web对象中的模板参数。

这张地图实际上是另一种形式。 input 使用以下代码表示：

<input type="image" name="img" src="[img]" width="400" height="300">

方括号中的项目 ([map] ， [mapext] ，以及 [img] )是所谓的MapServer标记-这些是MapServer CGI变量，它们是用于赋值的MapServer CGI程序。标签 [map] 是 Mapfile 路径的占位符，因此当MapServer运行时，它将被替换为 "/owg/mfc1.map" 。标签 [mapext] 将替换为当前地图范围，该范围将随着您在地图上的单击而更改； [img] 标记将被替换为MapServer CGI程序创建的图像的路径，在MapServer在服务器端呈现图像后，该名称将传递给客户端。在服务器上，路径 IMAGEPATH ( /owg/ms_tmp/ )必须存在并且具有适当的权限。您可以检查映像是否存在(在服务器上)的 IMAGEPATH ( /owg/ms_tmp/ )路径。

请注意，上面的调用也有一个隐藏变量 "mode" 具有价值的 "browse"" ，它告诉MapServer在 tmp 目录。然后，该图像被引用为 [img] ，这就是您在浏览器中看到的内容。

3.2.4. 对MapServer模板文件的要求#

地图服务器模板文件必须包含特定字符串 mapserver template 在第一行，通常以HTML、JavasSript或XML注释的形式给出。这一行不会传递给客户端。此特定字符串不区分大小写。

MapServer的模板文件名后缀有限。可用的后缀包括： .gml ， .html ， .htm ， .js ， .kml ， .svg ， .tmpl ， .wml ， .xml 。

CGI变量#

所有CGI参数都可以替换模板中的引用、MapServer特定参数和用户定义的参数。原则上，参数由MapServer直接传递，无需任何处理。此功能对于实现MapServer应用程序至关重要。

以下参考仅列出了获取有关MapServer修改的信息(如新比例尺、查询结果等)所需的模板占位符特定字符串。

模板的占位符字符串区分大小写。

属性项替换必须与dBASE文件中的项名称相同。

ArcView和ArcInfo通常生成项目名称全部为大写的dBASE文件。当模板为URL时，应用适当的URL编码(即， ' ' 至 '+' )。

某些占位符字符串也可以转义形式提供，例如URL编码。

特殊字符#

模板只是一个包含在每次处理模板时被mapserv替换的特殊字符的HTML文件或URL字符串。简单的替换允许将活动层或空间范围等信息从用户传递到映射服务器，然后再传递回来。在大多数情况下，新值被转储到将再次传递的表单变量中。以下是特殊字符和表单变量的列表。HTML模板可以包含任何内容，包括JavaScript和Java调用。

在HTML文件中，属性值可以用引号引起来 ("" )。通过在引号中写入属性值，您可以设置值通常不使用的特殊字符(例如： ] ， = ， " 和空格。要在属性值中使用单引号，请仅使用两个引号 ("" )。