定位支持 原生 AAR 接入 和 組件化接入 兩種接入方式。

前置條件

• 若采用原生 AAR 方式接入，需先完成 將 mPaaS 添加到您的項目中 的前提條件和后續(xù)相關(guān)步驟。

• 若采用組件化方式接入，需先完成 組件化接入流程。

添加 SDK

原生 AAR 方式

參考 AAR 組件管理，通過 組件管理（AAR）在工程中安裝 定位 組件。

組件化方式

在 Portal 和 Bundle 工程中通過 組件管理 安裝 定位 組件。更多信息，參考 管理組件依賴。

申請高德KEY

使用 LBS 之前，在 高德開放平臺 申請賬號并獲取定位 Key。申請的 Key 示例如下：

配置 AndroidManifest

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

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

從 10.1.68.18 版本起，定位的自動簽到功能默認(rèn)關(guān)閉。如需開啟自動簽到，需要在 AndroidManifest 文件中手動添加如下配置：

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

API 說明

調(diào)用定位能力

LBSLocationManagerProxy.getInstance().requestLocationUpdates(MainActivity.this, new LBSLocationListener() {
          @Override
          public void onLocationUpdate(LBSLocation lbsLocation) {
              Toast.makeText(MainActivity.this, "lbsLocation is " + lbsLocation.getAddress(), Toast.LENGTH_LONG).show();
          }
          @Override
          public void onLocationFailed(int i) {
              Toast.makeText(MainActivity.this,
                      "onLocationFailed" + i, Toast.LENGTH_SHORT).show();
          }
      });

其他相關(guān)接口

/**
* 注冊定位,定位到區(qū)縣級別
*/
public void requestLocationUpdates(Context context, LBSLocationListener locationListener)
/**
* 注冊定位，如果需要定位到街道級別，請使用此 API
* gpsEnable: false 表示定位到區(qū)縣級別，true 表示定位到街道級別，精度更高，更耗性能
* miniInterval: 定位間隔時間，可以使用 LBSLocationManagerProxy.DEFAULT_LOCATION_INTERVAL
* overtime： 定位超時時間，可以使用 LBSLocationManagerProxy.LOCATION_TIME_OUT
* isNeedAddress: true 表示逆地理，false 表示僅經(jīng)緯度
* bizType: 業(yè)務(wù)類型，傳 null 即可
*/
public void doRequestLocationUpdates(Context context, boolean gpsEnable, LBSLocationListener locationListener, long miniInterval, long overtime, boolean isNeedAddress, String bizType)
// remove 定位注冊的回調(diào)
public void removeUpdates(Context context, LBSLocationListener listener)
// 獲取最近一次定位成功的位置
public LBSLocation getLastKnownLocation(Context context)