Android定位API使用手册.docVIP

Android定位API使用手册 版本 1.0.1目录 1. 综述 3 1.1 目的 3 1.2 业务分析 3 1.3 客户端调用 3 2. API具体说明 3 3. 定位API组成 3 4. 定位API接口 4 4.1 异步回调接口 4 4.2 定位依据管理类 4 5. 定位API使用范例 5 6. 在项目中使用API 6 Android定位API使用手册 综述 目的 本文档用于说明在Android平台上定位API的使用。 业务分析 定位API供第三方在其客户端产品中实现定位功能。 驴博士为第三方提供定位服务。定位服务器是由该公司维护的一组服务器，提供定位服务。 应用服务器是由第三方维护的一组服务器，为客户端提供业务服务。 定位时，客户端通过定位API获取定位依据(一组加密的数据)，然后由其向应用服务器提交该定位依据。 应用服务器再将定位依据通过简单的HTTP接口提交给定位服务器，定位服务器返回定位结果，包括当前的位置及其误差评估。 应用服务器根据自己的业务逻辑对定位结果进行处理后返回给客户端。 客户端调用 在Android平台上实现定位功能，API负责采集并组织定位依据，然后按照协议给定的格式封装好返回给调用者，调用者将该定位依据上报应用服务器, 由其向定位服务器请求解析当前位置的经纬度。 定位API组成 用jar包形式提供。名字为and_lbs_v1.0.jar。 API具体说明 1. 定位API只提供包装好的定位依据给第三方应用程序，第三方应用程序使用定位依据向定位服务器请求当前的位置。 2. 第三方应用可以通过异步回调或同步获取的方式使用定位API： 异步：LBSListener.onLocationChanged(String dataByte); 同步：PepLocationManager.getLastKnownLocationInfo(); 3. 定位API可设置一个异步回调的最小时间间隔及一个最大时间间隔(以秒计)。 当位置发生变化时, 如果时间间隔太小, 则忽略变化；如果太长时间位置未变化也应发生一次回调。 如果第三方应用未设置最小时间间隔或最大时间间隔，客户端API默认的时间间隔为最小时间间隔为3分钟（180s），最大时间间隔为10分钟（600s） 4. 定位API可以设置敏感度, 以便第三方应用判断变化以及防抖。目前敏感度定义如下: 高: 希望位置敏感一点； 中:一般应该选择中； 低: 对位置不敏感的用低。 5. 变化通知： 根据应用设定的敏感度及时间间隔, 定位API开始采集定位依据,发生匹配敏感度设置及时间间隔的数据变化后即通知应用。 6. 启动和停止服务 客户端应用主要跟PepLocationManager类打交道。PepLocationManager属于Android的一个服务，继承了android.app.Service，整个定位服务由它提供。所以客户端在使用该服务时应启动它，具体的方法跟启动普通的Service一样， Intent intent = new Intent (Context packageContext , PepLocationManager.class); startService(intent); 当想停止定位服务时： Intent intent = new Intent (Context packageContext , PepLocationManager.class); stopService(intent); 7. 使用序列 用户使用定位API时，应该在主程序启动时即启动定位服务，并在主程序终止前才结束定位服务，这样可以获得较为理想的定位效果。正常调用序列应该是 1,2,2,2,2,,2,2,2,3 （1.start 开始定位服务 2.GetLastKnownLocationInfo() 获取定位依据 3.stop 停止定位服务 ） 8．GPS的使用方法： 客户端在定位服务启动之后可以通过方法PepLocationManager.registerGPS()向定位服务器注册使用GPS。这时如果客户端打开GPS，定位服务器便可完成GPS定位。 如果不再需要GPS定位可以调用PepLocationManager.removeRegisterGPS()解除GPS定位。 GPSListener监听器可以获取当前服务器GPS的可用状态。 在项目中引入定位AP