地图WEB发布服务器.doc

XemeServer UserterServer UserWMS MAP Service 地图WEB发布服务器使用手册 乌鲁木齐菩提树软件技术有限公司.c录一、安 装51.1、运行环境51.2、安装TerServer5二、web.xml配置6三、进入系统管理界面93.1、启动Tomcat93.2、进入系统管理界面93.3、增加地图图层93.4、缩放级数和地图范围设置103.5、卫星图像的选择113.6、各种分辨率下地图范围设置113.7、设置地图图层属性113.8、删除地图图层143.9、地图切片143.10、刷新地图服务15四、地图主页面要包含的内容16五、JavaScript函数175.1、初始化OpenLayers函数175.2、图上查询函数185.3、查找地理位置函数185.4、根据坐标查位置185.5、在给定图层上，以给定的ID值查找地理位置函数185.6、在给定图层上，以给定的字段名称和值查找地理位置函数195.7、在给定图层上全局查询，查找地理位置函数195.8、全局查询，查找地理位置函数195.9、提交数据19六、编辑地图206.1、增加xml文件206.2、增加为“独立图层”206.3、增加为OpenLayers图层206.5、在地图的状态栏选择编辑图层206.6、选择工具进行绘制21七、xeme许可配置22八、运行TerServer example23TerServer 是一款Web Map Service地图服务器软件，可读取tab(Mapinfo), shp(Arcinfo)及XML格式的地图数据(数据的投影必须为WGS84)，以PNG格式发布。支持多种类型客户端浏览；支持 Web 2.0。TerServer应用简单、方便。TerServer地图发布软件，纯Java开发，可用于Windows,Linux,Unix等不同的平台；可运行在Tomcat 、Glassfish等可运行Servlet的web服务器上；TerServer可在服务器端预生成地图瓦片，加快地图浏览速度；可与google map 、microsoft VirtualEarth或Yahoo map 叠加显示；客户端使用OpenLayers；功能包括地图移动、缩放、图上查询、根据输入文字查找地图位置、距离测量、面积测量、地图编辑等。为正确显示叠加功能，请使用ie7以上或Firefox浏览器。欢迎使用TerServer！一、安 装1.1、运行环境1、 Java JDK6, 下载地：2、 Tomcat5.5以上(或Glassfish 2.x), 下载地：增加tomcat使用内存。Java、Tomcat的安装请参考相关文档。 1.2、安装TerServer将terserver.war文件拷贝至Tomcat的安装目录下的webapps 目录下，如：Apache Software FoundationTomcat 5.5webapps。将地图数据拷至web.xml中规定的datapath目录下。二、web.xml配置在terserver的“WEB-INF”目录有一个web.xml文件，一般不需要修改。TerServer terserver init com.pipal.xeme.TerServer mapbasicpath c:/temp cache yes admin admin password datapath c:data texturepath images 1 wms com.pipal.xeme.WMSServer wms /wms admin com.pipal.xeme.AdminServer admin /admin 1 /index.html 用户需要修改的内容如下： 节点内容不能修改，节点内容可以修改。 mapbasicpath c:/temp c:/temp为保存瓦片地图的目录，用户可以自行设置不同的目录。admin admin 管理员登录帐号，初始为“admin”。password 管理员登录密码，初始为“”。datapath c:/data 数据存放绝对目录，一定要有盘符。存放mapinfo tab、arcinfo shp、xml文件。数据目录下允许有二级目录(不能有更多级的目录)，二级目录不用在web.xml中说明。如：data为数据目录，其下可有：datacity1、datacity2、datacity3. 二级目录的名称不能命名为“config”，data config目录用于存放配置文件layers.xml和config.xml文件，不能在此目录下存放数据文件。 所有数据的投影必须为WGS84。texturepath images 贴图文件目录，是相对目录，必须在Tomcat的webapp目录下。贴图文件主要用于shp、xml文件，tab文件可以使用自身的样式来显示。 三、进入系统管理界面3.1、启动Tomcat 启动Tomcat服务器。3.2、进入系统管理界面启动浏览器，在地址栏内输入：“:8080/terserver”“”为用户安装应用的计算机ip地址。“8080”为用户安装Tomcat时的端口。“terserver”为项目名称。在弹出的页面中输入用户名称和密码(初始名称为admin，密码都为空)，即可登录到系统管理界面。用户名称和密码是在web.xml中设定的。3.3、增加地图图层首先，要把地图文件拷贝到服务器web.xml中规定的datapath目录下。进入管理界面后，第一要做的事就是增加图层。选择菜单“增加图层”，在弹出的窗口中选择要增加的文件名称，然后设定图层的属性。对于基本图层：排列在最下面的图层要最先加入。例如：背景应是最先增加的图层。如果在“文件名称”下拉框中没有出现要选择的文件，可能是没有把地图数据拷贝到指定的目录下；也可能已完成图层的增加。所有要增加的图层完成以后，要“刷新服务”，再进行地图范围的设置、地图图层属性的设置等。“基础图层”：所有的基本图层按合并图像返回图片，基础图层可预生成地图瓦片，不能在基础图层上进行地图编辑。“独立图层”：独立图层不可预生成地图瓦片，单独返回图片，对于xml文件格式的独立图层，可进行地图的编辑(点、线、面)。3.4、缩放级数和地图范围设置选择菜单“设置”-“缩放级数和地图范围设置”。开始，系统将从地图数据读取地图的范围。因此，建议地图数据在加入前，要对其进行“数据紧缩”。如：MapInfo数据可使用MapInfo Professional软件进行紧缩，选择菜单“表”-“维护”-“紧缩表”即可完成。“缩放级数”：设置地图显示缩放级数。缩放级数，最高为20(0-19级)，19级的分辨率约为0.3米。“地图范围”：增加完成所有图层后，刷新服务，系统会检测地图数据的实际最大范围，并写入config.xml文件中，用户如需要不同于地图数据的范围，可自行输入一定的值，并保存。设置好以后，Openlayers客户端以及地图切片都以该范围为准。如果地图切片以后，再进行地图范围修改的话，原来所切瓦片地图需要手工删除(在web.xml中设定的mapbasicpath的目录下)，然后重新进行地图切片(切记：如不删除原来的瓦片，系统不会自动覆盖。)。按“保存”按键保存设置数据。按“刷新服务”刷新服务，重新装载地图数据。3.5、卫星图像的选择选择菜单“设置”-“卫星图像选择”。在弹出的窗口中选择卫星图像，并设定基础图层与卫星图像的关系。如果没有选择卫星图像，则其关系一定选择“不叠加”。基础图像与卫星图像的关系选择为“叠加”时，基础图像在卫星图像之上叠加显示。3.6、各种分辨率下地图范围设置选择菜单“切片范围”。这是一个可选设置，仅仅是为了节约切片的时间，如果不设置，系统使用3.4节中设置的地图范围做为各种分辨率下的地图范围；各种分辨率下地图范围的设定可去掉在该分辨率下不需要切片的范围；选择一分辨率，显示右图的工具。增加区域，增加一个地图切片区域。选中一个已有的区域。选中后，可进行移动区域、改变区域大小、删除区域等操作。删除一个选中的区域。保存地图切片区域范围设置。3.7、设置地图图层属性选择菜单“图层管理”，选择要进行设置属性的图层名称。“数据类型”：数据类型有：点、线、面和文本。如果是混合图层，可选点、线、面之一。对于xml文件，在绘图时，按“数据类型”来绘制，一定要进行正确的设置。“图层名称”：可输入易于分别的名称。不能有重复的图层名称。“图层类型”：可选“基本图层”或“独立图层”之一。“标注字段名称”：选择用于自动在图上生成标注及查询时优先考虑的字段，如果没有字段可选，则选“null”。“可选”：决定图上对象是否可用鼠标点击选择查询。“可标注”：决定图上对象是否可自动标注，如果选自动标注，则“标注字段名称”不能为“null”。“填充样式”：决定面对象的填充样式。“N”为不填充。“img”为图片填充，使用在“填充图片名称”中设定的图片文件进行填充。“填充背景是否透明”：可选“背景不透明”或“背景透明”。“填充前景色”：设置填充的前景色。使用系统提供的设色板选择颜色。“填充背景色”：设置填充背景色。“填充图片名称”：选择填充图片名称，图片文件必须放在：Web.xml文件中“texturepath”规定的目录下。“线样式”：决定线对象的绘图样式。“N”实际为不显示状态。“线宽”：设置线的宽度。“线颜色”：设置线的颜色。“符号样式”：决定点对象的绘图样式。“N”实际为不显示状态。“img”为图片样式，使用在“符号图片名称”中设定的图片文件进行显示。“符号大小”：决定符号的大小。“符号颜色”：决定符号的颜色。“符号图片名称”：选择符号图片名称，图片文件必须放在：Web.xml文件中“texturepath”规定的目录下。“字体名称”：选择用于标注的字体名称。“字体效果”：可选择“常规”、“粗体”、“斜体”。“字体颜色”：选择标注字体颜色。“字体大小”：决定标注字体的大小。“可显示最小分辨率”：小于该分辨率时，地图将不显示。可在列出的分辨率中选择，数字越大，表示分辨率越小。“可显示最大分辨率”：大于该分辨率时，地图将不显示。“标注最小分辨率”：小于该分辨率时，地图将不标注。“标注最大分辨率”：大于该分辨率时，地图将不标注。按“保存”键保存地图属性设置。按“刷新服务”刷新。3.8、删除地图图层选中某一图层后，按“删除”菜单，删除选中的图层。按“刷新服务”刷新。3.9、地图切片选择“地图切片”进入地图切片选项。地图切片不是必须的，但是有必要的。如果不切片地图，使用系统的用户自动分割第一次浏览到的地图区域。地图切片增加地图的浏览速度。地图切片必须在增加图层完毕、设置好比例尺及地图范围、配置完地图图层属性后进行。地图切片可能需要较长的时间，可以在不同的计算机上进行分割。切片完成后，把图片拷贝到应用程序的地图目录下(we.xml中mapbasicpath规定的路径)。瓦片地图按3度带分子目录，每个分带下按缩放级别分子目录存放瓦片地图。选择一个分辨率，按“确定”按键生成。完成后将提示“分割完成”。3.10、刷新地图服务修改配置以后都要刷新地图服务，才能启用新的配置。编辑地图的过程中，有可能文件不能解锁，此时可刷新地图服务。四、地图主页面要包含的内容完整的页面内容如下(增加到你的主页中，参考example.html。)： 五、JavaScript函数5.1、初始化OpenLayers函数/全局变量var TER_WMS=wms; var TER_MAP;/OpenLayers.Map对象 var TER_BASIC;/基本图层 var TER_TRACK;/临时图层。用于选择突出显示、跟踪及编辑对象。 var TER_FIELDS;/字段名称 var TER_DATATYPE=0;/数据类型 var TER_TRACKSTATE=query;/track图层的状态,query为查询,track为跟踪,find为查找地理位置. var TER_DATASHOW=show;/TER_DATASHOW=show只显示数据，TER_DATASHOW=edit时可编辑数据。 var TER_POSITION;/当前鼠标位置 /json_string,图形对象 var TER_GEOMETRY=type:FeatureCollection,features: type:Feature,geometry: type:MultiPoint,coordinates:77,37, properties:ID:0,NAME:,GID:0, layername:STATION; var TER_EDITER=; /当前可编辑图层名称 var TER_TOOLS;/测量 function init() TER_MAP = new OpenLayers.Map(map,TER_MAPOPTION); /*定义基本图层*/ TER_BASIC = new OpenLayers.Layer.WMS( terServer, TER_LOCATION+TER_WMS, layers: basic, /定义的基本图层layers的名称必须为basic; tiled: true, /transparent: true, reproject: true , isBaseLayer: true ); /*定义临时图层。用于选择突出显示、跟踪及编辑对象。*/ TER_TRACK = new OpenLayers.Layer.Vector(track); TER_MAP.addLayers(TER_BASIC,TER_TRACK); /*增加图层控制开关*/ TER_MAP.addControl(new OpenLayers.Control.LayerSwitcher(); /*全幅显示*/ TER_MAP.zoomToExtent(TER_MAXEXTENT); /*记住鼠标当前位置*/ TER_POSITION=new OpenLayers.Control.MousePosition() TER_MAP.addControl(TER_POSITION); TER_MAP.events.register(click, TER_MAP, function (e) /*注册图上查询*/ getMapFeatureInfo(e); ); /*初始化图上操作工具*/ initTools();5.2、图上查询函数图上查询函数在query.js中。/*OpenLayer图上查询*/getMapFeatureInfo(e);/*数据显示*/dataview(lonlat,features);5.3、查找地理位置函数查找地理位置函数在find.js中。/*openlayer上查找地理位置。*querytype为查询类型：0为在给定图层上，按ID号查询；1为在给定图层上按给定的字段名称和字段值查询；2为在给定图层上全局查询；3为全局查询。*/5.4、根据坐标查位置/根据坐标查位置findMapByCoord(cx,cy);5.5、在给定图层上，以给定的ID值查找地理位置函数/在一层上,给定geoid查询findMapByID(layername,geoid;/layername为图层名称/geoid为id值/如：findMapByID(station,1234);5.6、在给定图层上，以给定的字段名称和值查找地理位置函数/在一层上,给定字段和值的查询findMapByField(layername,fieldname,fieldvalue);/layername为图层名称/fieldname为字段名称/fieldvalue为字段值/如：findMapByField(道路,名称,学院路);5.7、在给定图层上全局查询，查找地理位置函数/在一层上全局查询findMapByLayer(layername,querystring);/layername为图层名称/querystring为查询字符串/如：findMapByLayer(道路,学院路);5.8、全局查询，查找地理位置函数/全局查询findMapByStr(querystring);/querystring为查询字符串/如：findMapByStr(学院路);5.9、提交数据/*提交,type=0为增加,1为修改,2为删除*/getMapCommit(type);六、编辑地图6.1、增加xml文件 Xml文件格式：一个空的xml文件： 名称,代码 定义后保存在Web.xml文件中“datapath”规定的目录下。如：line.xml6.2、增加为“独立图层”在图层增加时，把要进行图形编辑的line.xml文件增加为“独立图层”。增加