GIS-API详细计文档-V0.1.docxVIP

德邦物流网点规划项目GIS-API需求详细设计说明书文档控制文档名称网点规划GIS-API详细设计文档文档全称网点规划GIS-API详细设计文档文档描述网点规划项目电子地图功能组件接口的详细设计版本信息修改日期版本描述作者2013-08.05V1.0创建童冬冬目录1.引言 -4-2.系统结构设计及子系统划分 -4-3.设计说明 -5-3.1模块 -5-3.1.1模块要点 -5-3.1.2类图 -6-3.1.3接口设计 -7-3.1.4调用关系 -8-4技术要点 -8-4.1默认功能开启 -8-4.2圆形区域内搜索 -9-4.3多（10个以上）关键字搜索 -9-4.4重叠区域搜索 -10-4.5搜索结果的数据处理 -11-4.6多方式搜索封装 -12-5性能 -13-5.1网络方面 -13-5.2搜索类型及关键字 -14-1. 引言目前进行网点规划时，有大量的重复工作，比如在ERP中重复查询网点的分布，数据的重复处理，占用了很大一部分时间。2012年公司平均找点时长是50天，找点期间确定目标区域以及市场调研的时间需要花费30天，如果运用GIS选址系统可以在找点时快速确定目标区域，并且可以清楚的知道目标区域的企业分布情况和货源结构，这一环节可以节省10天的时间，可为公司节省大量成本，进一占提升公司的综合竞争力。于是开发一个性能强大的GIS选址系统，变得十分有必要。网点规划GIS-API(以下简称本API)，是在baidumapAPI的基础之上将相关功能，进一步的扩展与封装的应该程序接口，完成在各种条件限制下，在地图上进行用户POI数据的搜索、处理以及展示的功能，并将相关的数据返回给后续部门的同事，为公司的网点规划提供科学合理的参考建议。2. 系统结构设计及子系统划分本API的结构如下图：总体上本API的结构分为两部分：自加载部分，功能部分。功能部分从逻辑上又分为三层：base层、service层、componet层。3.设计说明3.1模块3.1.1模块要点自加载模块本API作为一个独立的工作体，就必须具备自我加载并初始化好各项服务以便用户调用的功能，这部分我们的实现方法如下：API文件被下载，首先运行initMap函数，initMap函数先判断当前页面是否有名为“$baidu”的JS文件，这个文件是baidu,提供给我们的基础服务，如果是没有，则立即进行加载此文件，加载完成后，再初始化地图。如果页面已经有$baidu.js，则跳过加载，直接初始化地图。另外，在自我加载部分还定义了一些地图默认开启的几个功能，如：右键菜单、城市列表、实时路况、添加结果展示面板，添加蒙层等功能，其中值得一提的是，城市列表功能和添加结果展示面板。前者需要另外载baidulibrary文件，这个操作不仅会使当前页面凭空增加额外的开销，而且它必须在$baidu.js完全加载后才能加载，否则会报错，所以这个操作要小心地放入$baidu.js文件加载后的回调函数里，为了不明显得影响用户体验，此操作还应放到地图始终化完成之后，在后台进行。后者是用本API对当前页面的DOM进行读写，在DOM树中添加新节点，作为存储搜索结果的容器，并立即为相应的节点梆定事件，以便后期操作。考虑到搜索和展示，这两个功能是密不可分的，所以在地图初始化完毕后，我们就一次性将此必要的节点写到DOM树中，避免了在以后的操作中，对DOM树进行频繁读写，从而提升程序的性能，与用户体验。功能模块此部分从逻辑上分为三层：base、service、componet层。base层完成两个工作，一是封装不同浏览器下JavaScript的差异，提供统一的接口，我们可以依靠它来完成跨浏览器兼容的工作；二是根据我们的实际使用情况扩展JavaScript语言底层提供的接口，让它提供更多更为易用的接口。base层的功能是给common层和componet层提供接口。这层对外是不可见的。service层则是调用base层定义好的接口，直接用baidumapAPI公开给我们的方法，组合封装成我们的业务功能函数，供componet层进行内部调用。这一层里封装的函数，我们会尽可能地保证其功能单一，其本身与外界的通信接口也尽可能的少（或者无接口），这些函数就像是一个个的生产好的“小零件“，以便在需要时组装成“汽车“。本层对外是不可见的。componet层与页面里的具体功能需求直接相关，调用base层提供的接口，还有service层封装好的方法，完成用户需要的功能与操作。这一层所的方法对外公开，以便用户调用，完成所需功能。3.1.2类图本API对外只一个DpMap类，通过此类实现自我加载和始终化，此类大部分的方法对外不可见，我们封装好，给外部调用的，是其子类——ComponetBox。ComponetBox的方法函数直接对外开