搭建开发环境

@H_450_120@mapServer 的安装和使用

从 MapServer 产品页面下载最新版本。尽管官方文档对 Unix 和 Window 平台下的源代码安装步骤给出了详细的说明，但是笔者通过实践可以发现，在 Win32 平台下，从源代码编译安装 MapServer 是一个复杂的任务，所以推荐使用 MapServer 给出的已编译安装包 MS4W，从而能快速搭建开发环境。

将下载的 MS4W 解压到硬盘指定的目录，然后在命令提示符窗口切换到 MS4W 所在的目录，运行 apache-install，如果结果如下图所示则表示安装成功，或者使用浏览器访问http://127.0.0.1/cgi-bin/mapserv.exe，验证 MapServer 返回的提示信息。

图 2 MS4W 安装成功

使用 MapServer 发布地图数据，关键就是要编写一个后缀名为 map 的 Mapfile 配置文件。在官方文档中，介绍了手工编写该配置文件的方法，关于手工编写的格式和注意事项会在后面的实例中有所介绍；同样读者还可以通过其他图形化配置界面工具或者是开源桌面软件来生成 Mapfile 文件。

@H_450_120@PostgIS 的安装和使用

安装 PostgIS 空间数据库的前提条件是有关系型的 POSTGResql 数据库，而且值得注意的是 postgreSQL8.3 以上的版本才支持 PostgIS 空间数据库。

这样，首先从 POSTGResql 产品页面下载最新 windows 版本的安装文件，接下来按照安装进度依次选择安装目录、数据目录、密码和端口，等待 POSTGResql 安装完成之后，会出现如下界面：

图 3 POSTGReSQL 安装完成

点击完成按钮之后选择所需要的 PostgIS 版本以及下载地址后进行安装：

图 4 安装 PostgIS

PostgIS 空间数据库安装完成后，可以做如下的验证：

• 利用 PostgIS 提供的 Shape 文件和 DBF 文件图形化加载工具，将一个 Shape 文件导入到空间数据库中。打开"PostgIS 1.5 for Postgresql 9.0 -> PostgIS Shapefile and DBF Loader"，如下图所示导入 PostgIS 中

图 5 导入 Shape 文件

• 在 sql 命令行（psql）或者图形化管理工具中验证上述文件是否导入到 PostgIS 中，打开"POSTGResql 9.0 -> sql SHell(psql)"，做如下验证：

图 6 验证 PostgIS 数据库和导入 Shape 文件

如果能得到如上述的结果，说明 PostgIS 安装成功，并且顺利导入 Shape 格式的矢量数据。

@H_450_120@构建 GIS 应用程序

利用上述搭建的开发环境，接下来将展示如何使用 OpenScales，并且在 MapServer 和 PostgIS 的帮助下快速构建一个 GIS 应用程序。在这个应用程序中，将展示如下几个关键内容点，包括：

• 编写 Mapfile 文件，利用 MapServer 搭建的开源 GIS 引擎
• 支持三种数据源，分别是 PostgIS 空间数据库、Shape 和 KML 格式的矢量数据和图片格式的光栅数据；
• 使用 OpenScales 来完成前端展示以及用户交互响应。

准备三种数据源

为了能演示支持三种不同形式的数据，需要准备三个数据源，分别是：

• 数据库数据 - 已导入到 PostgIS 数据库中的数据
• 矢量数据 - Shape 格式或者 KML 格式的文件
• 光栅数据 - GIF、PNG 或者 JPEG 格式的文件

编写 Mapfile 文件

准备好数据之后，接下来要利用 MapServer 搭建的 GIS 引擎来获得上述的数据，完成这一步最最为关键的就是编写 Mapfile 文件了。在这里，为了方便介绍细节，我们采用手工编写 Mapfile 文件的方式。以下是一个示例的 Mapfile 文件。

MAP Object 是 Mapfile 的根对象，它包含了一系列的属性，结合下面的示例文件，介绍 MAP Object 的结构和部分常用属性。

清单 1. Mapfile 文件示例 - MAP Object

@H_419_242@ 1 MAP 2 name "china" 3 SIZE 400 300 4 IMAGEcolor 255 255 255 5 IMAGETYPE JPEG 6 SHAPEPATH "data" 7 EXTENT 73.447 3.408 135.086 53.558 8 9 PROjeCTION 10 "init=epsg:4326" 11 END 12 13 WEB 14 TEMPLATE "/ms4w/apps/testshapefile/index.HTML" 15 IMAGEPATH "/ms4w/tmp/ms_tmp/" 16 IMAGEURL "/ms_tmp/" 17 END 18 19 LAYER 20 ……

代码 1 中出现的一般参数及含义如下：

• EXTENT 是从空间上指定要创建的地图文件的大小；
• SIZE 是从图片像素上指定输出 Map 的宽和高；
• IMAGEcolor 指定默认的图片背景颜色；
• IMAGETYPE 指定当前的输出格式；
• SHAPEPATH 指定 shape 文件或瓦片所在的文件目录，绝对路径和相对于当前 Mapfile 文件的路径均可。

同时，MAP Object 允许一些嵌套的对象：PROjeCTION,querymAP,REFERENCE,SCALEbar,SymBol,WEB. LAYER,LEgend。接下来将介绍在示例文件中用到的三个嵌套对象，其他对象的详细用法可以参考 MapServer 的官方文档：

• PROjeCTION Object 设置投影，有两种投影对象可以定义，一种是在 Map Object 中用于说明输出图像投影，另一种是在各个图层中定义；
• WEB Object 定义如何处理 Web 接口，比如 TEMPLATE 指明用于展示查询结果并和用户交互的文件或 URL 地址，IMAGEPATH 存储临时文件和图像的路径，IMAGEURL 配置 IMAGEPATH 的 URL 访问路径；
• LAYER Object 定义所使用的全部图层信息，一个 Mapfile 允许多个图层，且可以通过修改源码的方式改变。在 Mapfile 文件中首先定义的 LAYER 处在地图底层，最后定义的地图顶层。

下面是一段 LAYER Object 的示例代码，分别介绍了如何展示从空间数据库，Shape 文件（矢量数据）和 GIF 文件（光栅数据）导入的地理数据。

清单 2. Mapfile 文件示例 - LAYER Object

1 LAYER 2 name "chinalayer" 3 STATUS ON 4 TYPE line 5 CONNECTIONTYPE Postgis 6 CONNECTION "host=** port=* dbname=Postgis user=POSTGRes password=passw0rd" 7 DATA "the_geom from bou2_4l" 8 9 CLASS 10 STYLE 11 color 255 0 0 12 END 13 14 LABEL 15 color 255 0 0 16 SIZE smaLL 17 END 18 END 19 END 20 21 LAYER 22 name "chinalayer2" 23 STATUS default 24 TYPE line 25 DATA "BOUNT_line" 26 27 CLASS 28 STYLE 29 color 0 0 0 30 END 31 32 LABEL 33 color 0 0 0 34 SIZE smaLL 35 END 36 END 37 END 38 39 LAYER 40 name "chinalayer3" 41 DATA "test_gif.gif" 42 STATUS ON 43 TYPE RASTER 44 #PROCESSING "SCALE=-10,10" 45 PROCESSING "SCALE_BUCKETS=2" 46 47 CLASS 48 STYLE 49 color 0 0 0 50 END 51 52 LABEL 53 color 0 0 0 54 SIZE TinY 55 END 56 END 57 END

从代码 2 中可以发现，从第 1 行到第 19 行配置的是从空间数据库中获取数据，从第 21 行到第 37 行配置的是从 Shape 文件获取数据，从第 39 行到 57 行是从 GIF 文件获取数据，其中部分属性介绍如下：

• name 用来指定图层的名称，它允许有 20 个字符并且作为标识来连接 mapfile 文件和 web interfaces，一般情况下它是唯一的；
• STATUS 用来设置图层的当前状态。缺省是 ON；
• TYPE 用来指明如何绘制数据，指定的类型并不要求与 shape 文件类型一致；
• CONNECTIONTYPE 指定连接的类型，缺省是本地；
• CONNECTION 配置远程数据连接，可以是 SDE，PostgIS，Oracle；
• DATA 指定使用的空间数据文件，不要求一定要 shape 文件格式，例如 PostgIS 图层的参数格式："<columnname> from <tablename>"，其中"columnname" 是含有 geometry objects 的列；
• PROCESSING 表示向图层发送的处理指令，不同的图层类型支持不同的指令，例如光栅数据支持 SCALE,BANDS 指令。

这里值得注意的是，如果读者选择了 KML 格式的矢量数据，需要通过 orginfo 命令行查看该文件的 Layer 名字，如下图中的 hz2 就是该 KML 文件的 Layer 名字。

图 7. 查看 KML 文件的 Layer Name

从 KML 文件加载数据的 Mapfile 配置文件片段如下：

清单 3. Mapfile 文件示例 – 从 KML 文件加载数据

1 LAYER 2 name "chinalayer2" 3 STATUS DEFAulT 4 TYPE POINT 5 CONNECTIONTYPE OGR 6 CONNECTION "kml/fountains-hotel.kml" 7 DATA "fountains-hotel" 8 9 CLASS 10 ……

构建应用程序

准备好 GIS 服务器和所需的空间数据后，下面将展示如何构建基于 GIS 的 Flex 示例程序，该示例程序将用于展示不同数据源的空间数据，并提供基本的用户交互能力。接下来将逐步介绍构建 Flex 示例程序的过程。

首先，在 Flex Builder 中创建 Flex 工程，导入开源 GIS 渲染引擎 OpenScales 包，项目结构如下图所示：

图 8. 示例程序项目结构

其中，需要导入引用 4 个 swc 文件；在 src 目录下，最重要的是 osclIEnt.mxml 文件，接下来会重点讲解，另外 ImageMarker.as 文件定义了在地图上显示用的图标类型，icons 文件加下放的是各式不同的图片

在 osclIEnt.mxml 文件中主要完成了两件事情：第一，展示从不同数据源来的空间数据；第二，定义页面布局及一系列交互功能。

清单 4. 展示从不同数据源来的空间数据

<os:Map ID="fxmap" wIDth="100%" height="100%" zoom="3" centerLonLat="105.02831248205241,35.17319551790936" cornerRadius="7"> <os:WMS ID="file_data" url="http://localhost/cgi-bin/mapserv.exe?map=/ms4w/apps/testshapefile/first.map" layers="chinalayer2" isBaseLayer="true" transparent="true" projection="epsg:4326"/> <os:WMS ID="shape_file" url="http://localhost/cgi-bin/mapserv.exe?map=/ms4w/apps/testshapefile/first.map" layers="chinalayer" isBaseLayer="true" transparent="true" projection="epsg:4326" /> <os:Mouseposition x="10" y="{height-20}" displayProjection="epsg:900913"/> <os:Spinner ID="spinner" x="{this.wIDth / 2}" y="{this.height / 2}"/> <os:LayerSwitcher/> <os:DragHandler/> <os:ClickHandler/> <os:WheelHandler/> <os:SELEctFeaturesHandler active="true" enableClickSELEction="false" enableBoxSELEction="false" enabLeoverSELEction="true" /> </os:Map>

上述这段代码所描述的就是如何获取空间数据，这里有两点需要强调一下：第一，每一个 <os:WMS> 元素中所定义的 layers 的值必需和前面所配置的 Mapfile 文件中的 LAYER Object 的 name 匹配；第二，OpenScales 默认的投影 epsg 值是 900913，需要转换成 epsg:4326 的投影值才能得到我们所常用的经纬度数值（经度从 -180 到 180，纬度从 -90 到 90）。

同样，我们可以做如下配置，从而能够使用 OpenStreetMap 数据：

<os:Mapnik name="mapnik" isBaseLayer="true"proxy="http://OpenScales.org/proxy.php?url="/>

清单 5. 定义页面布局及一些交互功能

<os:ControlPanel x="10" y="10" wIDth="140" title="Navigation"> <os:PanComponent map="{_map}"/> <mx:HBox wIDth="100%" paddingleft="5" paddingRight="5"> <os:ZoomComponent map="{_map}"/> <mx:Spacer wIDth="100%"/> <os:ZoomBoxComponent map="{_map}" wIDth="32" height="32"/> </mx:HBox> </os:ControlPanel> <os:ControlPanel title="Drawing Tools" x="150" y="10"> <os:FeatureDrawingComponent map="{_map}" /> </os:ControlPanel>

上述这段代码定义了两个组件，一个用于显示包含缩放比例尺的导航，另外一个用于显示包含一些 OpenScales 自定义的画图工具，在接下来的 GIS 应用展示中会看到这两个组件。

构建应用程序所需要的完整代码可以在下载资源中找到。