Android

注:驴博士 SDK for Android 的当前版本为 3.x。旧版(1.x 和 2.x) 仍可使用,但不再进行技术支持和 bug 修正。
驴博士 SDK for Android
驴博士 SDK for Android
概述
所谓“驴博士 SDK for Android”就是一个JAR包,提供了如下功能:
- 获取定位依据。所谓定位依据就是一个字符串,里面编码了驴博士混合定位所需的信息,核心内容是基站ID、WIFI接入点的MAC地址、GPS坐标。
驴博士 SDK v3.x 输出的定位依据版本是 3,所以在驴博士定位服务器请求位置时,上行XML中的 /location[@ver] 属性应写 "3"。
- 把定位依据提交到驴博士服务器,从而获得位置信息。
其中第2项功能的核心任务是网络操作(HTTP请求),应用程序也可以自己来做。所以使用驴博士SDK的方式有2种:
- 应用程序获得定位依据后,直接向驴博士服务器请求位置,或者把定位依据发送到开发者自己的服务器,让后者转发定位请求,这就是“server-server”说法的由来。
- 应用程序把驴博士SDK的定位功能当成一个黑盒子,不关心定位依据、HTTP请求,直接要求得到位置。由于从驴博士服务器的立场来看,请求来自客户端而非开发者的服务器,所以此方式被称为“client-server模式”。
自己做网络操作的好处是,
- 可以得到驴博士服务器的第一手应答数据,里面可能包含更丰富的出错信息。
- 统一地执行网络操作。
让驴博士SDK负责网络操作的好处是,
- 省事,不需要与驴博士服务器打交道,不需要解析XML,不需要为定位操作维护工作线程。
SDK的内容
- JAR包在 lib/ 里
- LbsDemo 是一个demo的源代码,采用 client-server 模式,演示了如何利用驴博士获得位置变化通知。
- loc 是另一个demo的源代码,采用 server-server 模式,演示了如何获取定位依据、如何向驴博士服务器发起HTTP请求、如何解析驴博士服务器应答的XML。
- 开发文档