概要设计-基于Android车载导航系统设计与实现

导航模块概要设计总页数 正文 附录 生效日期编制 批准南昌航空大学东软班 概要设计2修 改 履 历修改编号 日期 修改人 版本号 修改内容1 2013.12.10 VER0.1.0 初始做成南昌航空大学东软班 概要设计3目 录1 文档概述 .41.1 文档目的和范围 .41.2 术语/缩略语 .41.3 参考文档 .42 模块概述 .42.1 模块功能定义 .42.2 模块结构 .52.3 模块动作时序 .63 接口说明 .73.1 数据结构定义 .73.2 函数 .93.2.1 模块间接口函数 .93.2.2 模块内接口函数 .12南昌航空大学东软班 概要设计41 文档概述1.1 文档目的和范围该文档主要用于完成导航，包括地图图层、路线规划、定位、事件监听等1.2 术语/缩略语序号 术语/缩略语 说明1 正向地理编码 将中文地址或地名描述转换为地球表面上相应位置2 反向地理编码 将地球表面的地址坐标转换为标准地址3 POI Point of Interest 的缩写，意为信息点1.3 参考文档序号 文档名 作者 时间 版本1 需求分析报告书_邹文爻.doc 邹文爻 v1.02 百度地图 API 文档 v2.3.12 模块概述导航模块主要实现地图图层、定位、路径规划、事件监听等功能。2.1 模块功能定义序号 功能点 功能点详细内容1 地图展示 普通地图、卫星图和实时交通图2 地图操作 可通过接口或手势控制来实现地图的点击、双击、长按、缩放、旋转、改变视角等操作3 正向地理编码 实现了将中文地址或各种地名描述转换为地球表面上相应位置的功能4 反向地理编码 将地球表面的地址坐标转换为标准地址的过程5 公交信息查询 可对公交详细信息进行查询6 公交换乘查询 根据起、终点。查询策略，进行线路规划方案7 驾车线路规划 提供不同策略，规划驾车路线南昌航空大学东软班 概要设计58 步行路径检索 支持步行路径的规划9 定位 采用 GPS、IP 混合定位模式，能够获取当前位置信息10 一般事件监听 用于对初始化地图 Activity 时的监听11 地图事件监听 用于对地图加载完成时、地图移动完成时、点击到地图可点标注时、动画结束时和截图成功后的监听12 地图点击事件监听 用于对地图单击事件、地图双击事件和地图长按事件的监听13 地图状态监听 对地图中心点变化、缩放、平移、视角变化进行监听14 弹出窗事件监听 用于对弹出窗口事件的监听15 搜索事件监听 用于对公交搜索、驾车路线、步行路线搜索的监听2.2 模块结构模块名称 模块类型 概要说明MKGeneralListener 接口 一般事件接口，返回授权验证MKMapStatusChangeListener接口 地图变化监视器MKMapTouchListener 接口 地图点击事件监听器南昌航空大学东软班 概要设计6MKMapViewListener 接口 地图显示事件监听器。该接口监听地图显示事件PopupClickListener 接口 Pop 弹窗事件监控接口MKSearchListener 接口 搜索结果通知窗口。该接口返回公交搜索，驾乘路线，步行路线结果Projection 接口 用于屏幕像素点坐标系统和地球表面经纬度坐标系统之间的变换BDLocationListener 接口 用于定位变化监视器setTraffic 内部模块 设置是否打开实时交通setSatellite 内部模块 设置是否打开卫星图drivingSearch 内部模块 驾车路线搜索setDrivingPolicy 内部模块 设置路线规划策略GeoPoint 内部模块 表示一个地理坐标点，存放经度和纬度onGetDrivingRouteResult 内部模块 返回驾乘路线搜索的结果setData 内部模块 设置 RouteOverlay 数据poiSearchInCity 内部模块 城市 poi 检索onGetBusDetailResult 内部模块 返回公交详情信息搜索结果onGetTransitRouteResult 内部模块 返回公交搜索结果onGetWalkingRouteResult 内部模块 返回步行路线搜索结果onClickMapPoi 内部模块 点击到地图可点标注时的监听onMapDoubleClick 内部模块 地图双击事件onMapLongClick 内部模块 地图长按事件onMapStatusChange 内部模块 地图状态改变事件getLatitude 内部模块 获取纬度getLongitude 内部模块 获取经度getRadius 内部模块 获取定位精度半径getAddrStr 内部模块 获取反地理编码getProvince 内部模块 获取省份信息getCity 内部模块 获取城市信息getDistrict 内部模块 获取区县信息2.3 模块动作时序南昌航空大学东软班 概要设计73 接口说明3.1 数据结构定义public static final java.lang.String VERSION_INFO “2.3.1”/版本信息public static final int DEFAULT_ANIMATION_TIME 300 /默认动画完成时间 300 毫秒public static final int BOTTOM 80 /使用 view 下边对齐public static final int BOTTOM_CENTER 81 /使用 view 下边中心点对齐public static final int CENTER 17 /使用 view 中心点对齐public static final int CENTER_HORIZONTAL 1 /使用 view 上边中心点对齐public static final int CENTER_VERTICAL 16 /使用 view 左边中心点对齐南昌航空大学东软班 概要设计8public static final int LEFT 3 /使用 view 左边对齐public static final int MODE_MAP 0 /布局模式：相对于地图。当地图滚动或缩放时，子视图的位置就会改变public static final int MODE_VIEW 1 /布局模式：相对于地图。子视图的位置相对于父视图保持不变，当地图滚动或缩放时不会移动public static final int RIGHT 5 /使用 view 右上角顶点对齐public static final int TOP 48 /使用 view 上边对齐public static final int TOP_LEFT 51 /使用 view 左上角顶点对齐public static final int ERROR_PERMISSION_DENIED 300 /错误号，授权失败public static final int ERROR_RESULT_NOT_FOUND 100 /错误号，未找到搜索结果public static final int ERROR_ROUTE_ADDR 4 /错误号，路线搜索起点或终点有歧义public static final int MKEVENT_BUS_DEAIL 15 /公交详情搜索事件public static final int MKEVENT_MAP_MOVE_FINISH 14 /地图移动完成事件public static final int MKEVENT_SUGGESTION 16 /联想词搜索事件public static final int EBUS_NO_SUBWAY 6 /公交检索策略常量，不包含地铁public static final int EBUS_TIME_FIRST 3 /公交检索策略，时间优先public static final int EBUS_TRANSFER_FIRST 4 /公交检索策略，最少换乘public static final int EBUS_WALK_FIRST 5 /公交检索策略，最少步行距离public static final int ECAR_AVOID_JAM -1 /驾车策略，躲避拥堵public static final int ECAR_DIS_FIRST 1 /驾乘检索策略常量，最短距离南昌航空大学东软班 概要设计9public static final int ECAR_FEE_FIRST 2 /驾乘检索策略常量，较少费用public static final int ECAR_TIME_FIRET 0 /驾乘检索策略常量，时间优先public static final int ROUTE_TYPE_BUS_LINE 3 /路线规划方式常量，公交线public static final int ROUTE_TYPE_DRIVING 1 /路线规划方式常量，驾车public static final int ROUTE_TYPE_UNKNOW 0 /路线规划方式常量，未知public static final int ROUTE_TYPE_WALKING 2 /路线规划方式常量，步行3.2 函数3.2.1 模块间接口函数3.2.1.1 MKGeneralListener函数名 onGetPermissionState文件名 ./Application.java功能概要 处理授权验证错误记述形式 void onGetPermissionState(int iError)参数类型 变量名 I/O 说明void - - -类型 void 说明返回值值 0 认证通过，非零值表示认证失败详细说明授权认证，认证成功才可以使用 SDK使用注意事项无南昌航空大学东软班 概要设计103.2.1.2 MKMapStatusChangeListener函数名 onMapStatusChange文件名 ./MapControl.java功能概要 地图状态变更回调记述形式 void onMapStatusChange(MKMapStatus mapStatus)参数类型 变量名 I/O 说明MKMapStatus mapStatus - -类型 void 说明- -返回值值- -详细说明地图的缩放会调用该函数产生回调使用注意事项无3.2.1.3 MKMapTouchListener函数名 onMapClick文件名 ./ MapControl.java功能概要 地图单击事件记述形式 void onMapClick(GeoPoint point)参数类型 变量名 I/O 说明GeoPoint point - -类型 void 说明- -返回值值- -详细说明响应地图单击事件使用注意事项无3.2.1.4 MKMapViewListener函数名 onMapMoveFinish文件名 ./ MapControl.java功能概要 地图移动完成时调用记述形式 void onMapMoveFinish()参数类型 变量名 I/O 说明南昌航空大学东软班 概要设计11- - - -类型 void 说明- -返回值值- -详细说明在地图移动完成后，会回调此接口使用注意事项无3.2.1.5 PopupClickListener函数名 onClockedPopup文件名 ./MapControl.java功能概要 Popup 弹出窗口记述形式 void onClickedPopup(int index)参数类型 变量名 I/O 说明int index - 当前点击的区域索引类型 void 说明- -返回值值- -详细说明Popup 弹出窗口使用注意事项无3.2.1.6 MKSearchListener函数名 onGetAddrResult文件名 ./MapSearch.java功能概要 返回地址信息搜索结果记述形式 void onGetAddrResult(MKAddrInfo result)参数类型 变量名 I/O 说明MKAddrInfo result - 搜索结果类型 void 说明- -返回值值- -详细说明返回要搜索地址的搜索结果使用注意事项南昌航空大学东软班 概要设计12无3.2.1.7 Projection函数名 fromPixels文件名 ./MapSearch.java功能概要 创建新的 GeoPoint记述形式 GeoPoint fromPixels(int x, int y)参数类型 变量名 I/O 说明int x - 横坐标int y - 纵坐标类型 GeoPoint 说明- -返回值值- -详细说明给定的像素点是以 MapView 的左上角为原点的坐标系统，MapView 提供了这个像素转换器使用注意事项无3.2.1.8 BDLocationListener函数名 onReceiveLocation文件名 ./BDLocation.java功能概要 获取定位结果记述形式 void onReceiveLocation(BDLocation location)参数类型 变量名 I/O 说明BDLocation location - 当前位置类型 void 说明- -返回值值- -详细说明监听定位结果使用注意事项无南昌航空大学东软班 概要设计133.2.2 模块内接口函数3.2.2.1 setTraffic函数名 setTraffic文件名 ./Map.java功能概要 设置是否打开路况图记述形式 void setTraffic(boolean on)参数类型 变量名 I/O 说明boolean on I on：true 表示打开，false 表示关闭，默认关闭类型 void 说明- -返回值值- -详细说明设置是否需要打开实时路况图使用注意事项无3.2.2.2 setSatellite函数名 setSatellite文件名 ./ Map.java功能概要 设置是否打开卫星图记述形式 void setSatellite(boolean on)参数类型 变量名 I/O 说明boolean on - on：true 表示打开，false 表示关闭，默认关闭类型 void 说明- -返回值值- -详细说明设置是否需要打开卫星图使用注意事项无南昌航空大学东软班 概要设计143.2.2.3 drivingSearch函数名 drivingSearch文件名 ./MapSearch.java功能概要 驾乘路线搜索记述形式 int drivingSearch(java.lang.String startCity,MKPlanNode start,java.lang.String endCity,MKPlanNode end)参数类型 变量名 I/O 说明java.lang.String startCity - 起点所在城市，起点为坐标时可不填MKPlanNode start - 搜索的起点，可以为坐标，名称任意一种java.lang.String endCity - 终点所在城市，终点为坐标是可不填MKPlanNode end - 搜索的终点，可以为坐标，名称任意一种类型 int 说明0 成功返回值值-1 错误详细说明驾车路线搜索使用注意事项无3.2.2.4 setDrivingPolicy函数名 setDrivingPolicy文件名 ./MapSearch.java功能概要 设置驾车路线规划策略记述形式 int setDrivingPolicy(int policy)参数类型 变量名 I/O 说明int policy - ECAR_TIME_FIRST:时间优先；ECAR_DIS_FIRST:距离最短；ECAR_FEE_FIRST:费用最少； ECAR_AVOID_JAM: 躲避拥堵类型 int 说明0 成功返回值值-1 错误详细说明设置驾车路线规划策略，参数为策略常量时，对下次搜索有效使用注意事项南昌航空大学东软班 概要设计15无3.2.2.5 GeoPoint函数名 GeoPoint文件名 ./Map.java功能概要 存放经度和纬度记述形式 GeoPoint(int latitudeE6,int longitudeE6)参数类型 变量名 I/O 说明int latitudeE6 - 经度int longitudeE6 - 纬度类型 - 说明- -返回值值- -详细说明用给定的经度和纬度构造一个 GeoPoint使用注意事项无3.2.2.6 onGetDrivingRouteResult函数名 onGetDrivingRouteResult文件名 ./MapSearch.java功能概要 返回驾乘路线搜索结果记述形式 void onGetDrivingRouteResult(MKDrivingRouteResult result,int iError)参数类型 变量名 I/O 说明MKDrivingRouteResult result - 搜索结果int iError - 错误号，0 表示正确返回类型 void 说明- -返回值值- -详细说明返回驾乘路线的搜索结果使用注意事项无南昌航空大学东软班 概要设计163.2.2.7 setData函数名 setData文件名 ./MapShow.java功能概要 添加一个图形记述形式 long setData(Graphic g)参数类型 变量名 I/O 说明Graphic g - 几何图形类型 long 说明长整型 该图形 ID返回值值- -详细说明添加一个图形使用注意事项无3.2.2.8 poiSearchInCity函数名 poiSearchInCity文件名 ./PoiSearch.java功能概要 城市 poi 搜索记述形式 int poiSearchInCity(java.lang.String city,java.lang.String key)参数类型 变量名 I/O 说明java.lang.String city - 城市名java.lang.String key - 关键词类型 int 说明0 成功返回值值-1 错误详细说明城市 poi 搜索，异步函数，返回结果在 MKSearchListener 里的 onGetPoiResult 方法里通知使用注意事项无3.2.2.9 onGetBusDetailResult函数名 onGetBusDetailResult文件名 ./MapSearch.java功能概要 返回公交车详情信息搜索结果南昌航空大学东软班 概要设计17记述形式 void onGetBusDetailResult(MKBusLineResult result,int iError)参数类型 变量名 I/O 说明MKBusLineResult result - 搜索结果int iError - 错误号，0 表示正确返回类型 void 说明- -返回值值- -详细说明返回公交车详情信息搜索结果使用注意事项无3.2.2.10 onGetTransitRouteResult函数名 onGetTransitRouteResult文件名 ./MapSearch.java功能概要 返回公交搜索结果记述形式 void onGetTransitRouteResult(MKTransitRouteResult result, int iError)参数类型 变量名 I/O 说明MKTransitRouteResultresult - 搜索结果int iError - 错误号，0 表示正确返回类型 void 说明- -返回值值- -详细说明返回公交搜索结果使用注意事项无3.2.2.11 onGetWalkingRouteResult函数名 onGetWalkingRouteResult文件名 ./MapSearch.java功能概要 返回步行路线搜索结果记述形式 void onGetWalkingRouteResult(MKWalkingRouteResult result,int iError)参数类型 变量名 I/O 说明MKWalkingRouteResult result - 搜索结果南昌航空大学东软班 概要设计18int iError - 错误号，0 表示正确返回类型 void 说明- -返回值值- -详细说明返回步行跸搜索结果使用注意事项无3.2.2.12 onClickMapPoi函数名 onClickMapPoi文件名 ./MapPoi.java功能概要 点击到地图可点标注时会回调此接口记述形式 void onClickMapPoi(MapPoi mapPoiInfo)参数类型 变量名 I/O 说明MapPoi mapPoiInfo - poi 信息类型 void 说明- -返回值值- -详细说明点击到地图可点标注时回调该接口使用注意事项无3.2.2.13 onMapDoubleClick函数名 onMapDoubleClick文件名 ./Map.java功能概要 地图双击事件记述形式 void onMapDoubleClick(GeoPoint point)参数类型 变量名 I/O 说明GeoPoint point - 经度纬度类型 void 说明- -返回值值- -详细说明地图双击事件使用注意事项南昌航空大学东软班 概要设计19无3.2.2.14 onMapLongClick函数名 onMapLongClick文件名 ./Map.java功能概要 地图长按事件记述形式 void onMapLongClick(GeoPoint point)参数类型 变量名 I/O 说明GeoPoint point - 经度纬度类型 int 说明- -返回值值- -详细说明显示一个汉字的下半部分使用注意事项无3.2.2.15 onMapStatusChange函数名 onMapStatusChange文件名 ./Map.java功能概要 地图状态变更回调记述形式 void onMapStatusChange(MKMapStatus mapStatus)参数类型 变量名 I/O 说明MKMapStatus mapStatus - 地图状态表示，包括地图缩放级别，旋转角度等类型 void 说明- -返回值值- -详细说明地图状态变更回调使用注意事项无3.2.2.16 getLocType函数名 getLocType南昌航空大学东软班 概要设计20文件名 ./Location.java功能概要 获取 error code记述形式 int getLocType ( )参数类型 变量名 I/O 说明- - - -类型 int 说明61 GPS 定位结果62 扫描整合定位依据失败，此时定位结果无效返回值值161 表示网络定位结果详细说明获取 error code使用注意事项无3.2.2.17 getLatitude函数名 getLatitude文件名 ./Location.java功能概要 获取纬度记述形式 double getLatitude ( )参数类型 变量