全部产品

接入 Android

更新时间:2020-11-24 11:03:53

定位 SDK 是一套简单的 LBS(Location-based services)定位接口,您可以使用这套定位 API 获取定位结果。

定位支持 原生 AAR 接入mPaaS Inside 接入组件化接入 三种接入方式。

前置条件

添加 SDK

原生 AAR 方式

参考 AAR 组件管理,通过 组件管理(AAR)在工程中安装 定位 组件。

mPaaS Inside 方式

在工程中通过 组件管理 安装 定位 组件。
更多信息,参考 管理组件依赖

组件化方式

在 Portal 和 Bundle 工程中通过 组件管理 安装 定位 组件。
更多信息,参考 管理组件依赖

申请高德KEY

使用 LBS 之前,在 高德开放平台 申请账号并获取定位 Key。申请的 Key 示例如下:

2

配置 AndroidManifest

AndroidManifest.xml 文件中添加高德定位的 Key 和高德定位 Service。

  1. <!--高德定位 Key-->
  2. <meta-data
  3. android:name="com.amap.api.v2.apikey"
  4. android:value="填入您申请的高德 Key" />
  5. <!--高德定位 Service-->
  6. <service android:name="com.amap.api.location.APSService"></service>

从 10.1.68.18 版本起,定位的自动签到功能默认关闭。如需开启自动签到,需要在 AndroidManifest 文件中手动添加如下配置:

  1. <meta-data android:name="com.mpaas.lbs.autoCheckIn" android:value="true" />

API 说明

  • 调用定位能力
    1. LBSLocationManagerProxy.getInstance().requestLocationUpdates(MainActivity.this, new LBSLocationListener() {
    2. @Override
    3. public void onLocationUpdate(LBSLocation lbsLocation) {
    4. Toast.makeText(MainActivity.this, "lbsLocation is " + lbsLocation.getAddress(), Toast.LENGTH_LONG).show();
    5. }
    6. @Override
    7. public void onLocationFailed(int i) {
    8. Toast.makeText(MainActivity.this,
    9. "onLocationFailed" + i, Toast.LENGTH_SHORT).show();
    10. }
    11. });
  • 其他相关接口
    1. // 注册定位
    2. public void requestLocationUpdates(Context context, LBSLocationListener locationListener)
    3. // remove 定位注册的回调
    4. public void removeUpdates(Context context, LBSLocationListener listener)
    5. // 获取最近一次定位成功的位置
    6. public LBSLocation getLastKnownLocation(Context context)