用户登录
Android

注:驴博士 SDK for Android 的当前版本为 3.x。旧版(1.x 和 2.x) 仍可使用,但不再进行技术支持和 bug 修正。

驴博士 SDK for Android

驴博士 SDK for Android

概述

所谓“驴博士 SDK for Android”就是一个JAR包,提供了如下功能:

  1. 获取定位依据。所谓定位依据就是一个字符串,里面编码了驴博士混合定位所需的信息,核心内容是基站ID、WIFI接入点的MAC地址、GPS坐标。 驴博士 SDK v3.x 输出的定位依据版本是 3,所以在驴博士定位服务器请求位置时,上行XML中的 /location[@ver] 属性应写 "3"。
  2. 把定位依据提交到驴博士服务器,从而获得位置信息。

其中第2项功能的核心任务是网络操作(HTTP请求),应用程序也可以自己来做。所以使用驴博士SDK的方式有2种:

  1. 应用程序获得定位依据后,直接向驴博士服务器请求位置,或者把定位依据发送到开发者自己的服务器,让后者转发定位请求,这就是“server-server”说法的由来。
  2. 应用程序把驴博士SDK的定位功能当成一个黑盒子,不关心定位依据、HTTP请求,直接要求得到位置。由于从驴博士服务器的立场来看,请求来自客户端而非开发者的服务器,所以此方式被称为“client-server模式”。

自己做网络操作的好处是,

  • 可以得到驴博士服务器的第一手应答数据,里面可能包含更丰富的出错信息。
  • 统一地执行网络操作。

让驴博士SDK负责网络操作的好处是,

  • 省事,不需要与驴博士服务器打交道,不需要解析XML,不需要为定位操作维护工作线程。

SDK的内容

  • JAR包在 lib/ 里
  • LbsDemo 是一个demo的源代码,采用 client-server 模式,演示了如何利用驴博士获得位置变化通知。
  • loc 是另一个demo的源代码,采用 server-server 模式,演示了如何获取定位依据、如何向驴博士服务器发起HTTP请求、如何解析驴博士服务器应答的XML。
  • 开发文档