搜狐地图开发文档-搜狗地图.doc

中国电子地图标注网 中国电子地图标注网 搜狗地图 北京地图 电子地图 网上地图 地图标注搜狗地图 北京地图 电子地图 网上地图 地图标注 LSPLSPLSP 应用开发指南应用开发指南应用开发指南 Go2masp Go2masp Go2masp LSPLSPLSP ClientClientClient Developer sDeveloper sDeveloper s GuideGuideGuide 版权所有 C 2005 2008 搜狗信息有限公司 中国电子地图标注网 中国电子地图标注网 MIP 客户端开发指南 搜狗地图 北京地图 电子地图 网上地图 地图标注搜狗地图 北京地图 电子地图 网上地图 地图标注 搜狗信息有限公司 1 目目 录录 1引言引言 2 1 1编写目的 2 1 2预期读者 2 2术语术语 3 3LSP 应用开发示例应用开发示例 3 3 1地图应用的 HELLO WORD 3 3 2显示地图 4 3 3加载模块 4 3 4添加控制 5 3 5事件侦听 5 3 6移到指定点 5 3 7添加对象 5 3 8模块开发 7 3 9部署 8 中国电子地图标注网 中国电子地图标注网 MIP 客户端开发指南 搜狗地图 北京地图 电子地图 网上地图 地图标注搜狗地图 北京地图 电子地图 网上地图 地图标注 搜狗信息有限公司 2 1 1 引言引言 1 11 1 编写目的编写目的 本文档对基于 Go2map LSP 开发的 B S 架构的地图应用进行了系统的介绍 以帮助程序员更好的理解 Go2map LSP 的应用开发 从而能够开发出自己的地图应用系统 1 21 2 预期读者预期读者 Go2map LSP 应用开发和维护人员 开发和维护人员需掌握以下知识 精通 DHTML 精通 JavaScript 了解 javascript 面向对象的编程 了解 CSS 中国电子地图标注网 中国电子地图标注网 MIP 客户端开发指南 搜狗地图 北京地图 电子地图 网上地图 地图标注搜狗地图 北京地图 电子地图 网上地图 地图标注 搜狗信息有限公司 3 2 2 术语术语 Go2map LSP Go2map 位置服务平台 客户端 客户端 为用户提供地图应用的程序 它负责向地图引擎发出地图服务请求消息 并接收地图服务 应答消息 可以是因特网浏览器程序也可以是其它程序 MapService 即地图服务 表示一个具体的地图功能 如地图放大 范围查询等 不同的 MapService 代表不同的地图功能 有不同的请求消息参数和应答消息参数 例如 EntireMap 服务将 执行显示全图功能 为完成一个地图服务 包括两个步骤 服务请求和服务应答 客户端向地图引 擎发出服务请求 地图引擎接收到服务请求消息后进行相应的处理 然后将处理结果 即服务应答 消息 返回给客户端 地图应用客户端与地图引擎之间的信息交互是通过 WMSP 协议来完成的 3 3 LSPLSP 应用开发应用开发示例示例 3 13 1 地图应用的地图应用的 HelloHello wordword 以下是一个最简单的应用开发示例 将创建一个 800 500 的地图区域 并显示地图 Go2map LSP API Example 打开 应用开发示例 的压缩包中的 helloworld htm 可以看到以上代码 要开发地图应用 首先需要添加一个 script 标记 加入这个 script 标记就添加了 LSP 客户端基础类库 另 script 标记的属性 modules 可以要来指定要加载功能模块 script 标记的属性 sect 用来指定是否要分段下载代码 默认是 false 后面有详细的介绍 地图需要显示在一个 div 网页元素中 这个 div 网页元素的需要一个 ID 如 map 可以通过 style 属性或 者 css 来控制 div 网页元素的大小重而设置地图的大小 3 23 2 显示地图显示地图 上面的 Hello World 中有以下代码 中国电子地图标注网 中国电子地图标注网 MIP 客户端开发指南 搜狗地图 北京地图 电子地图 网上地图 地图标注搜狗地图 北京地图 电子地图 网上地图 地图标注 搜狗信息有限公司 4 var m new MapClient document getElementById map m setAppId 1361 m createMapArea var entiremap new EntireMapOperation m entiremap submit 以上代码创建地图区域并显示初始化的地图 第一行 创建一个 MapClient 对象 第二行 设置要访问的城市地图的 ID 如无特殊要求 可以省略可以省略 第三行 创建地图区域 第四行 创建一个EntireMapOperation 对象 第五行 向服务器提交请求 装载地图 3 33 3 加载模块加载模块 客户端类库的支持功能的扩展 可以开发自己的功能模块 然后加载进去 目前已经有很多功能模块 可以根 据需要进行加载 没用到的模块就不必下载 以减少下载的代码量 要加载模块只要在加载基础类库的 script 标签上加modules属性即可 比如 加载 zoomin 和 zoomout 模块 为方便升级和管理 每个模块都有版本号 加载时的格式为 示例如下 以上的示例是基础类库和功能模块同时加载 在某些应用中 为了在最短的时间内看到地图 可以使用分段下载的模式 分段下载是指先下载基础类库 而指定的功能模块暂时不下载 初始化完地图区域后 再继续下载和初始化功 能模块 要分段下载先在加载基础类库的 script 标签上加sect属性 取值为 true 或 false sect 属性可以省略 省略时默认是 false 即不不分段下载 示例 添加 sect true 之后 功能模块就不暂时下载了 那么就要在合适的时机 如 初始化完地图区域后 通知继 续下载 通过添加以下方式来实现 为了兼容 firefox 加载模块必须指定一个新的 script 标签 需要添加如下代码 注意 script 标签都增加了 id 属性 在初始化完地图区域后执行以下代码 注 当 sect false 时 以下代码无效 var obj document getElementById scriptloader1 定义回调 obj onModulesLoaded function alert 模块装载完毕回调 装载其他脚本代码 loadOtherScripts 装载模块 参数用来指定装载器 obj loadModules document getElementById scriptloader2 注意 其中的 scriptloader1 和 scriptloader2 对应 script 标签的 id 详细例子请打开 应用开发示例 的压缩包中的 dynamicload htm 3 43 4 添加控制添加控制 再添加控制之前 需先添加模块 中国电子地图标注网 中国电子地图标注网 MIP 客户端开发指南 搜狗地图 北京地图 电子地图 网上地图 地图标注搜狗地图 北京地图 电子地图 网上地图 地图标注 搜狗信息有限公司 5 这是 3 1 中的 script 标记 需要在 modules 中增加相应的模块 如 component 2 0 则增加后为 然后就可以添加控制了 以下添加了 8 个方向箭头 var m new MapClient document getElementById map var panArrow new PanArrow m 注意注意 如果你要添加的控制不在 component 模块中 则添加的是其他模块 而不是 component 详细例子请打开 应用开发示例 的压缩包中的 controls htm 3 53 5 事件侦听事件侦听 LSP 客户端的大部分接口是事件驱动的 所以事件侦听在 LSP 客户端中很重要 var m new MapClient document getElementById map Event addListener m sdschange function a sds alert 发生 sdschange 事件 var entiremap new EntireMapOperation m entiremap submit 以上例子是当发生 sdschange 事件时 弹出一个信息对话框 注意 注意 事件侦听是要在该事件发生前绑定 不能等事件已经发生了才绑定侦听 如 sdschange 事件一定要在 第一次提交 如 EntireMap 到服务器前侦听 详细例子请打开 应用开发示例 的压缩包中的 event htm 3 63 6 移到指定点移到指定点 有时打开地图时需要自动将地图的中心移到某个地方 var m new MapClient document getElementById map Event addListener m sdschange function a sds m coordRecenterTo 15960000 4251000 3 x y zoomLevel var entiremap new EntireMapOperation m entiremap submit 详细例子请打开 应用开发示例 的压缩包中的 resetcenter htm 3 73 7 添加对象添加对象 添加点对象 var m new MapClient document getElementById map Event addListener m sdschange function a sds m map addPoint 11312000 4760000 我添的点 var entiremap new EntireMapOperation m entiremap submit 详细例子请打开 应用开发示例 的压缩包中的 addpoint htm 添加线对象 var m new MapClient document getElementById map Event addListener m sdschange function a sds var points new Array points push new Point 11312000 4760000 points push new Point 12312000 4860000 中国电子地图标注网 中国电子地图标注网 MIP 客户端开发指南 搜狗地图 北京地图 电子地图 网上地图 地图标注搜狗地图 北京地图 电子地图 网上地图 地图标注 搜狗信息有限公司 6 points push new Point 13312000 4560000 points push new Point 10312000 4060000 m map addLine points 我添的线 var entiremap new EntireMapOperation m entiremap submit 详细例子请打开 应用开发示例 的压缩包中的 addline htm 批量添加对象 可从数据库中取数据 经过组织成约定的格式批量装载 约定的数据格式为 其中一个 Feature 节点表示一个对象 Feature 可为 1 个或多个 注意注意 节点名称首字母大写 属性全部小写 var m new MapClient document getElementById map Event addListener m sdschange function a sds var data 9380000 3108000 9380000 4508000 10780000 4508000 10780000 3108000 m map loadDataXML data var entiremap new EntireMapOperation m entiremap submit 详细例子请打开 应用开发示例 的压缩包中的 addfeature htm 3 83 8 模块开发模块开发 在前面的例子中提到添加某某模块 即在 script 标记中的属性 modules 中添加模块的名称和版本 如 entiremap 2 0 中国电子地图标注网 中国电子地图标注网 MIP 客户端开发指南 搜狗地图 北京地图 电子地图 网上地图 地图标注搜狗地图 北京地图 电子地图 网上地图 地图标注 搜狗信息有限公司 7 大部分模块是已经开发好的 直接添加使用就可以 如果有新的功能 而目前的类库还没有提供 该怎么办 那么就要自己开发新模块了 模块分两种 一种是组件类型的 另一种是地图服务类型的 组件类型的主要时用于控制 如 漫游箭头和鱼 骨头之类的 只要创建一个新类即可 就不多叙述 地图服务类型的要与地图区域的事件或者通过协议与服 务器交互 则需要继承指定的超类 MapOperation 类 实现相应的接口 如果通过协议与服务器端交互 还要 新建一个类来继承 WmspVariant 类 拿 entiremap 这个模块来举例 entiremap 是需要向服务器请求初始化信息的 就要创建 2 个类 第 1 个类 EntireMapVariant 继承 WmspVariant function EntireMapVariant extends MapService class this base WmspVariant this base 第 2 个类 EntireMapOperation 继承 MapOperation function EntireMapOperation a mapClient extends this base MapOperation this base private property var mapServiceName map EntireMap var mapClient a public method this submit function isFakeStatic var a ma