2.概要设计说明书示例

1、移动端街景导航系统概要设计说明书编制：编制部门：街景部模版文件版本：V2.0.0适用项目范围：街景导航项目文件修改表文件表名称签字（可多人）签字日期日期版本变更说明作者2014-6-101.0初始版本2014-8-102.0第二版目录移动端街景导航系统11引言背景4编写目的4读者对象4文档书写约定4术语定义4范围42总体设计52.1概述.22.1.3功能描述5运行环境5开发环境6设计.3系统构思7与算法10关键数据结构112.3人工处理过程113系统功能设计113.1定位功能11定位获取子功能11街景模块

2、13地图模块14搜索模块15模块..43.1.54系统数据结构设计174.1 说明17数据结构18数据结构与系统元素的关系19接口设计2155.1用户接口215.1.1商户管理模块用户接口216运行设计系统初始化23运行控制23系统结束237系统出错处理设计247.17.2出错信息24补救措施24设计24检测点的设计2488.18.2检测模块的设计24.2491尚待解决引言1.1 背景的系统名称：移动端街景导航系统本项目的提出者：杰图技术本项目的任务开发者：杰图技术本项目的用户：互联网用户1.2 编写目的.明确说明系统各

3、功能的实现方式。确定的全部需求和组成模块。确定各模块的功能和用户接口，以此作为详细设计的依据和基础。供程序设计阅读。1.3 读者对象本概要设计说明书书的适用读者，一般为：需求分析、设计及开发者和相关的测试。1.4 文档书写约定无。1.5 术语定义GIS：地理信息系统GPS: Globalitioning System (全球)POI：Po oferest（信息点）1.6 范围在确认需求规格说明书后，根据需求规格说明书的描述对系统的功能进行模块化设计和分配，得出系统的体系结构和所有模块，以及系统的界面和接口。系统的基本框架和模块如图 1.1 所示，该系统主要有定位模块、街景模块、地图模块、搜索模

4、块、模块、五大模块。图 1.12总体设计2.1 概述2.1.1功能描述系统包括的范围：定位模块、街景模块、地图模块、搜索模块、模块、五大模块。2.1.2运行环境环境 硬件环境服务器最低配置配置应用和数据库服务器DELL R630DELL R710分类名称版本语种操作系统IOS6.0英文操作系统的附加功能2.1.3开发环境服务器环境服务器硬件环境开发机器环境分类名称版本语种操作系统Windows7简体中文操作系统的附加功能数据库应用开发VS20107.5英文客户端ernet Explorer7.0简体中文服务器最低配置配置应用服务器、数据库服务器、邮件服务器、目录服务器1.9GHz CPU2.4

5、GHz CPU80G 硬盘160G 硬盘2G 内存4G 内存分类名称版本语种操作系统Windows2008简体中文操作系统的附加功能数据库SQL2008英文数据库补丁应用应用补丁版本控制系统CVS目录服务系统邮件系统客户端 开发机器硬件环境2.2 设计2.2.1系统构思该部分主要表示系统的功能层次。系统主要有定位模块、街景模块、地图模块、搜索模块、模块、五大模块。 定位模块定位管理模块主要功能为获取当前设备的 GPS 位置信息。GPS 定位模块图分类最低配置配置开发机器1.9GHz CPU2.4GHz CPU60G 硬盘160G 硬盘1G 内存2G 内存 街景管理模块街景管理模块主要功能为街景

6、的调用显示，最近的街景判断是否存在功能街景模块图 地图模块地图模块主要是利用二纬地图提供电子地图的查询，位置定位，POI 定位、路线查询功能实现。地图模块图 搜索模块搜索模块主要功能为在 30 多个分类的 2000 多万的 POI 数据中寻找匹配数据。搜索模块图模块模块主要功能为将当前的街景地址和地图进行打包，并且生成一个独立的连接，可以到各个。2.2.2本系统采与算法型的 J2EE 三层结构，分为表现层、中间层（即业务逻辑层）和数据服务层。三层体系将业务规则、数据及校验等工作放在中间层处理。客户端不直接与数据库交互，而是通过组件与中间层建立连接，再由中间层与数据库交互。 JSP在本系统中，表

7、现层采用传统的 JSP 技术。 Struts在本系统中，Struts 负责流程控制。Struts 是一种 J2EE MVC 实现方式，它的是一个 MVC 风格的控制器。 Struts 控制器搭起了 M和 View 之间的桥梁。 Spring在本系统中，Spring负责业务流转。Spring将Web层、Service层、它的作用贯穿了整个中间层。层及PO无缝整合。 Ibatis在本系统中，Ibatis 负责数据库操作。主要通过连接池等实现数据库操作的一致性和正确性，防止数据的产生而危害到整个数据库，它还能系统的管理那些与直接操作数据库的文件，这样当更改数据库时，将不需要重新开发整个系统，只需修改

8、接口即可，很大程度的提高了的重用性。2.2.3关键数据结构 SQL 数据库本系统的关键数据结构为数据库，与数据库相关的 E-R 图等将在第四部分列出。2.3 人工处理过程3系统功能设计3.1 定位功能获得当前的位置信息，和服务器进行通信。3.1.1 定位获取子功能此功能实现当有 GPS 信号下获取位置功能。图 3.3目前移动设备包括APPLE系列 IPad 系列，支持 GPS，定位系统，wifi来获取当前的位子，其中 GPS在空旷地区精度最高，和 wifi 定位可以在没有 GPS定位的情况下大致确定当前位置。本项目中利用通过CoreLocation 定位（APPLE IOS系统）来获取位置。3

9、.1.2 街景模块街景显示模块设计是本系统区别其他系统的一个明显特征，设计首先是需要对几千万的街景数据进行建立索引，每一张街景都含有一个唯一的信息，对几千万的经纬度信息，采取 9 宫格的算法，让每个街景都属于一个具有唯一的，长宽在5KM 的范围能，一旦给出一个，就能在毫秒级别计算出属于哪个区域，然后计算距离最近的一个点，返回出这个点的街景。街景前后行走功能设计，通过街景的关系，建立物理空间的拓扑结构信息，让街景之间有了相互的路网关系，一个街景位置包括了，前后顺序的 10 张街景信息，以及周边1 公里内的街景的距离和方位信息。3.1.3 地图模块地图显示项目中采用腾讯地图提供的公共API 接口实

10、现。设计通过地图可以查看任何一点坐标，拖动地图当地图位置变动后相应的调用获取信息返回给街景系统。同时利用几千万的 POI（位置信息）可以获取当前位置对应的附近一个具体的地址，返回显示在系统中。3.1.4 搜索模块设计通过关键字输入后首先对进行分词切割，比如：“东方明珠”，分词切割为“”、“东方明珠”两个词语，分析语义后搜索结果从城市的信息 POI 库中找到和“东方明珠”最匹配的数据，返回该数据的信息，调动地图模块和街景模块显示出目的地的街景数据。3.1.5模块是目前移动化设备比较重要的功能点，通过将当前位置街景生成一个，比如“http/pano123123_DSSDA_all”,来到主流的比如

11、，好友，好友，人人网，腾讯等社交化，扩大系统的。4系统数据结构设计4.1 说明在面象的设计方法中，数据也可以作为一个对象来处理，如果数据附属于某一对象，可以将其纳入该对象的属性管理之中。所以在面象的设计过程中，对数据的设计是在对对象的设计过程中完成的。4.2 数据结构数据结构商户通申请表c8beta3_shanghutong_apply实景表c8beta3_Panoshop券表c8beta3_coupon标题namevarchar100说明addrvarchar 200路径image_urldatetime开始时间start_timedatetime结束时间end_time折扣promote价

12、格price对应idshop_idvarchar20是否有效isvalid名称namevarchar100地址addrvarchar 200varchar 50详细信息infovarchar 1000人气visit_count价位price商户通指数shanghutong_countvarchar 20券 idcoupon_idvarchar20对应实景 idpoi_idvarchar20tagvarchar 100营业时间shop_hoursvarchar 20urlvarchar100是否有效isvalid会员级别shanghutong_grade名称namevarchar100套餐类型a

13、ddrvarchar 200电子邮件image_urldatetimestart_timedatetime传真end_time商户通 blog 相关商户产品表c8beta3_shop_product商户动态c8beta3_shop_news商户留言表c8beta3_shop_news4.3 数据结构与系统元素的关系实体关系图：留言内容infovarchar 500用户 iduser_id日期pub_datedatetimeidshop_idvarchar20标题namevarchar100信息addrvarchar 200添加时间image_urldatetimeidshop_idvarcha

14、r20名称namevarchar100路径addrvarchar 200添加时间image_urldatetime开始时间start_timedatetime结束时间end_time折扣promote价格price对应idshop_idvarchar20是否有效isvalidC8PlayerMap.js 这个 js 文件名称对大小写敏感；url 可以传入的 4 个参数 c8key、mapabckey、useMap、usePano。这 4 个参数对大小写也敏感；c8key mapabckey useMapusePano实景器mapabc 地图keykey必须必须可选是否显示地图（0 或 1）是否

15、使用器（0 或 1）可选如果要使用 mapabc 的地图服务，必须向 MapABC 公司申请 key 的服务，。；联系2、调用方法：var pm = new C8PlayerMap(str_panoObjID, str_mapObjID, optionObj);构造函数包括个参数：str_panoObjID str_mapObjIDoptionObj器放置的 div 的 id地图放置的div 的id初始化参数必须必须可选optionObj 可用的属性包括：shono是否显示实景是否显示地图 初始化的 panoid器（true，false）器（true，false）可选可选可选可选可选可选可选器

16、将显示默认实景showMap panoID cityCode mapCxx mapCyyplayerOptions初始化panoid 的 citycode初始化地图加密x 坐标初始化地图加密y 坐标实景初始化参数对象3、调用代码事例 1：不设置任何参数，显示器和地图，var pm = new C8PlayerMap(panoObj_divID, mapObj_divID);调用代码事例 2：使用参数来初始化C8PlayerMap 对象 var opt = new Object();4、opt.shono = true;opt.showMap = false;var playerOptions

17、= nenoOption();= ajaxplayerOptions.playerOptions.ajax=;playerOptions.panoLib= panoLib;playerOptions.cityCode = citycode; playerOptions.panoID = panoid; opt.playerOption = playerOptions; opt.mapCxx = lnigmplkooJOMI; opt.mapCyy = nmfknotlnFGIM;var pm = new C8PlayerMap(panoObj_divID, mapObj_divID, opt)

18、;对实景对象和地图对象更深入的交互控制5、获取地图对象的方法是： pm.map，地图的接口，请参考MapABC 文档；获取PanoPlayer 对象的方法：pm.player目前主要提供以下 3 个：a)切换城市pm.player.setValue(,ajax,panoLib/);主ajax，例如：h，例如：hajax panoLib通过给定/ajax/服务器，例如：ht实景/panolib/b)，来pm.player.flashProxy.callFlashAPI(shox，y：nobyThlite, x, y, MapABC, citycode);type：类型，只能是“MapABC”citycode：城市编码，例如“021”注意在调用前，先切换到相应的城市去。通过给定PanoID，来调用实景 pm.player.setPanoInfo(, citycode);：panoidcitycode：城市编码，例如“021”注意在调用前，先切换到相应的城市去。c)6、 注意：首批提供的 28 个城市中，citycode 对应的urls 和panoid 等，请参考