針對兒童和老人，可穿戴的智慧手錶用處很大。市場也有許多類似的產品，支援接打電話、支付掃碼、定位等功能，屬於新興的商業機會。依託華為品牌，鴻蒙手錶也致力為使用者打造精品的、產品質量佳、可穿戴的智慧體驗。對此，[HMS Core 定位服務](https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/introduction-0000001050706106?ha_source=hms1)（Location Kit）可以提供三個主要能力，包括融合定位、活動識別和地理圍欄。接下來，小編邀請開發者們透過簡單快速的幾步，體驗定位服務在鴻蒙手錶上開發的定位功能。

### 一、	定位服務的優勢和限制

1.	**定位低功耗**：利用晶片實現地理圍欄，功耗更低。

2.	**定位高精度**：最佳化城市峽谷下道路兩側的定位準確率，準確率高。基於RTK（Real - time kinematic）技術，實現開闊地亞米級高精定位能力。

3.	最新版本SDK需要使用者手機上安裝HMS Core（APK）6.0.0以上版本。若未安裝，或安裝了其他版本的HMS Core（APK），功能可以正常使用，但不支援版本自動升級。

4.	HarmonyOS透過數字證書和Profile檔案來對應用進行管控，只有簽名過的HarmonyOS Ability Package（以下簡稱“HAP”）才被允許安裝到裝置上執行。

![](https://oscimg.oschina.net/oscnet/up-e6f2043e435d9bffd23045846383604c3df.jpg)

### 二、	Demo介紹

為了讓開發者更好的瞭解鴻蒙手錶定位功能的實現，這裡提供了一個簡單的整合案例，邀請大家用簡單的程式碼執行Demo。**程式碼能力包括請求回撥定位功能，獲取快取定位資訊，查詢定位資訊是否可用及檢查設定許可權等**。

### 三、	開發實戰

下面為開發者們介紹如何根據原始碼將這個Demo執行起來，以便於瞭解實現細節。

開發準備

#### 1.	工具準備

**測試裝置  HarmonyOS 2.0及以上的華為智慧手錶**

**開發工具  DevEco Studio 2.1.0.201及以上**

#### 2.	開發前準備

1)	註冊[成為華為開發者](https://developer.huawei.com/consumer/en/?ha_source=hms1)，建立一個應用

參考[定位服務開發準備](https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/introduction-0000001050706106?ha_source=hms1)在華為應用市場建立一個您的應用。

2)	生成數字證書和Profile檔案

詳細步驟包括[申請應用除錯證書](https://developer.harmonyos.com/cn/docs/documentation/doc-guides/publish_app-0000001053223745#section9752152162813?ha_source=hms1)、[註冊除錯裝置](https://developer.huawei.com/consumer/cn/doc/distribution/app/agc-help-harmonyos-debugapp-manual-0000001177608893#section13331154632718?ha_source=hms1)和[申請除錯Profile](https://developer.huawei.com/consumer/cn/doc/distribution/app/agc-help-harmonyos-debugapp-manual-0000001177608893#section1774717395304?ha_source=hms1) ,配置簽名資訊。
							
3)	[生成簽名證書指紋](https://developer.harmonyos.com/cn/docs/documentation/doc-guides/publish_app-0000001053223745#section9752152162813?ha_source=hms1) ，配置簽名證書指紋。

4)	整合HMS Core SDK

•	將AGC的agconnect-services.json檔案下載到本地，並放應用級根目錄 “entry\src\main\resources\rawfile” 路徑下。

•	在檔案頭部宣告下一行新增如下配置apply plugin: 'com.huawei.agconnect'. 專案級“build.gradle”檔案，新增Maven倉地址和agconnect服務依賴。
```
buildscript {
    repositories {
        maven {url 'https://repo.huaweicloud.com/repository/maven/'}
        // 配置HMS Core SDK的Maven倉地址
        maven {url 'https://developer.huawei.com/repo/'}
        jcenter()
    }
    dependencies {
        classpath 'com.huawei.ohos:hap:2.4.4.2'
        // 新增agconnect服務依賴
        classpath 'com.huawei.agconnect:agcp-harmony:1.1.0.300'
        classpath 'com.huawei.ohos:decctest:1.2.4.0'
    }
}

allprojects {
    repositories {
        maven {url 'https://repo.huaweicloud.com/repository/maven/'}
        // 配置HMS Core SDK的Maven倉地址
        maven {url 'https://developer.huawei.com/repo/'}
        jcenter()
    }
}
```

•	應用級的build.gradle檔案新增依賴（實際中按照需要設定版本號） 或者在本地“libs”目錄放在Location Kit的har包。
```
dependencies {
implementation 'com.huawei.hms:location-ohos:6.0.0.300'
// agconnect依賴元件
implementation 'com.huawei.agconnect:agconnect-core-harmony:1.1.0.300'
}
```

•	如需混淆程式碼 開啟應用級根目錄下的混淆配置檔案“proguard-rules.pro”，加入排除HMS Core SDK的混淆配置。

**執行示例應用效果展示**
 
 ![](https://oscimg.oschina.net/oscnet/up-e4e4e8c436a8f5c1fbcba15e04ec6be02d0.jpg)

#### 1.	宣告系統許可權 在“config.json”檔案中的“reqPermissions”欄位中新增下列許可權

採用HarmonyOS提供了兩種位置許可權：ohos.permission.LOCATION （位置許可權）和ohos.permission.LOCATION_IN_BACKGROUND（後臺定位許可權）。注意還需要網路許可權。
```
"reqPermissions": [
   {
    "reason": "get Local Location",
    "name": "ohos.permission.LOCATION",
    "usedScene": {
      "ability": [
        "com.huawei.codelab.MainAbility",
      ],
      "when": "always"
    }
  },
  {
    "name": "ohos.permission.GET_NETWORK_INFO"
  },
  {
    "name": "ohos.permission. LOCATION_IN_BACKGROUND"
  }
```

2.	在程式碼中動態申請“ohos.permission.LOCATION ”和“ohos.permission.LOCATION_IN_BACKGROUND”許可權
```
//以location許可權為例
if (verifySelfPermission("ohos.permission.LOCATION") != IBundleManager.PERMISSION_GRANTED) {
    printLog(HiLog.INFO, TAG, "Self: LOCATION permission not granted!");
    if (canRequestPermission("ohos.permission.LOCATION")) {
        printLog(HiLog.INFO, TAG, "Self: can request permission here");
        requestPermissionsFromUser(
                new String[]{"ohos.permission.LOCATION"}, REQUEST_CODE);
    } else {
        printLog(HiLog.WARN, TAG, "Self: enter settings to set permission");
    }
} else {
    printLog(HiLog.INFO, TAG, "Self: LOCATION permission granted!");
}
```
**關鍵程式碼說明**

#### 1.	建立定位服務客戶端
在基類BaseAbilitySlice中的onStart()方法中建立一個FusedLocationProviderClient例項，透過該例項呼叫定位相關介面。
```
public FusedLocationProviderClient fusedLocProviderClient;
@Override
protected void onStart(Intent intent) {
    super.onStart(intent);
    fusedLocProviderClient = new FusedLocationClient(this);
}
```

#### 2.	檢查裝置定位設定

呼叫LocationRequest設定定位請求引數（包括設定位置更新的間隔（毫秒：單位），權重，返回地址資訊的語言等），並在請求回撥之前呼叫定位服務檢查定位相關設定。
```
private void checkLocationSettings() {
    LocationRequest locationRequest = new LocationRequest();
    locationRequest.setPriority(100);
    LocationSettingsRequest.Builder builder = new LocationSettingsRequest.Builder();
    LocationSettingsRequest request =
            builder.addLocationRequest(locationRequest).setAlwaysShow(false).setNeedBle(false).build();
    settingsClient.checkLocationSettings(request)
            .addOnSuccessListener(response -> {
                // 設定成功定位條件
            })
            .addOnFailureListener(exp -> {
                // 設定不滿足定位條件
            });
}
```

#### 3.	定位功能相關實現步驟

呼叫requestLocationUpdates()進行持續定位。
```
fusedLocProviderClient.requestLocationUpdates(locationRequest, locationCallback)
        .addOnSuccessListener(var -> {
            // 介面呼叫成功的處理
        })
        .addOnFailureListener(e -> {
            // 介面呼叫失敗的處理           
        });
```
呼叫removeLocationUpdates()停止位置更新。
```
//注意：停止位置更新時，mLocationCallback與requestLocationUpdates()中的LocationCallback引數為同一物件。
fusedLocProviderClient.removeLocationUpdates(locationCallback)
        .addOnSuccessListener(var -> {
            // 介面呼叫成功的處理
        })
        .addOnFailureListener(e -> {
            // 介面呼叫失敗的處理        
        });
```
定義位置更新回撥。
```
LocationCallback locationCallback = new LocationCallback() {
    @Override
    public void onLocationResult(LocationResult locationResult) {
        if (locationResult != null) {
            // 處理位置回撥結果
        }
    }
    @Override
    public void onLocationAvailability(LocationAvailability locationAvailability) {
        super.onLocationAvailability(locationAvailability);
        if (locationAvailability != null) {
            // 處理位置狀態
        }
    }
};
```

### 相關引數說明

#### 1.	設定定位型別，如果請求GNSS位置，則值為100；如請求網路位置，則值為102或104；如不需要主動請求位置，僅需被動接收位置，則值為105。

#### 2.	定位設定的語言。當前僅支援EN和CN。

#### 3.	setNumUpdates請求位置的回撥次數，假如值為3時，則只回撥3次結果給客戶端。如果想要一直持續回撥儘量使用預設值。

欲瞭解更多HMS Core 定位服務詳情，請參閱：
[https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/introduction-0000001050706106?ha_source=hms1](https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/introduction-0000001050706106?ha_source=hms1)
華為開發者聯盟官網：
[https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/harmonyos-introduction-0000001121618904?ha_source=hms1](https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/harmonyos-introduction-0000001121618904?ha_source=hms1)
下載demo和示例程式碼請到Github： 
[https://github.com/HMS-Core/hms-location-demo-harmonyos](https://github.com/HMS-Core/hms-location-demo-harmonyos)
解決整合問題請到Stack Overflow：
[https://stackoverflow.com/questions/tagged/huawei-mobile-services?tab=Newest](https://stackoverflow.com/questions/tagged/huawei-mobile-services?tab=Newest)

**瞭解更多詳情>>**

訪問[華為開發者聯盟官網](http://developer.huawei.com/consumer/cn/hms?ha_source=hms1)  
獲取[開發指導文件](http://developer.huawei.com/consumer/cn/doc/development?ha_source=hms1)  
華為移動服務開源倉庫地址：[GitHub](http://github.com/HMS-Core)、[Gitee](http://gitee.com/hms-core)

**關注我們，第一時間瞭解 HMS Core 最新技術資訊~**

鴻蒙手錶定位功能Demo體驗，適用兒童、老年和外出旅遊安全市場

相關文章