鴻蒙OS 獲取設(shè)備的位置信息

場(chǎng)景介紹

開(kāi)發(fā)者可以調(diào)用 HarmonyOS 位置相關(guān)接口，獲取設(shè)備實(shí)時(shí)位置，或者最近的歷史位置。

對(duì)于位置敏感的應(yīng)用業(yè)務(wù)，建議獲取設(shè)備實(shí)時(shí)位置信息。如果不需要設(shè)備實(shí)時(shí)位置信息，并且希望盡可能的節(jié)省耗電，開(kāi)發(fā)者可以考慮獲取最近的歷史位置。

接口說(shuō)明

獲取設(shè)備的位置信息，所使用的接口說(shuō)明如下。

開(kāi)發(fā)步驟

1. 應(yīng)用在使用系統(tǒng)能力前，需要檢查是否已經(jīng)獲取用戶授權(quán)訪問(wèn)設(shè)備位置信息。如未獲得授權(quán)，可以向用戶申請(qǐng)需要的位置權(quán)限。

系統(tǒng)提供的定位權(quán)限有：

• ohos.permission.LOCATION
• ohos.permission.LOCATION_IN_BACKGROUND

訪問(wèn)設(shè)備的位置信息，必須申請(qǐng) ohos.permission.LOCATION 權(quán)限，并且獲得用戶授權(quán)。

如果應(yīng)用在后臺(tái)運(yùn)行時(shí)也需要訪問(wèn)設(shè)備位置，除需要將應(yīng)用聲明為允許后臺(tái)運(yùn)行外，還必須申請(qǐng) ohos.permission.LOCATION_IN_BACKGROUND 權(quán)限，這樣應(yīng)用在切入后臺(tái)之后，系統(tǒng)依然可以繼續(xù)上報(bào)位置信息。

開(kāi)發(fā)者可以在應(yīng)用 config.json 文件中聲明所需要的權(quán)限，示例代碼如下：

   {
       "reqPermissions": [{
           "name": "ohos.permission.LOCATION",
           "reason": "$string:reason_description",
           "usedScene": {
               "ability": ["com.myapplication.LocationAbility"],
               "when": "inuse"
           }, {
           ...
           }]
       }]
   }

說(shuō)明

配置字段詳細(xì)說(shuō)明見(jiàn)權(quán)限開(kāi)發(fā)指導(dǎo)。在使用系統(tǒng)位置能力時(shí)，向用戶動(dòng)態(tài)申請(qǐng)位置權(quán)限，申請(qǐng)方式請(qǐng)參考動(dòng)態(tài)申請(qǐng)權(quán)限開(kāi)發(fā)步驟。

1. 實(shí)例化 Locator 對(duì)象，所有與基礎(chǔ)定位能力相關(guān)的功能 API，都是通過(guò) Locator 提供的。

   Locator locator = new Locator(context);

其中入?yún)⑿枰峁┊?dāng)前應(yīng)用程序的 AbilityInfo 信息，便于系統(tǒng)管理應(yīng)用的定位請(qǐng)求。

1. 實(shí)例化 RequestParam 對(duì)象，用于告知系統(tǒng)該向應(yīng)用提供何種類(lèi)型的位置服務(wù)，以及位置結(jié)果上報(bào)的頻率。

方式一：

為了面向開(kāi)發(fā)者提供貼近其使用場(chǎng)景的 API 使用方式，系統(tǒng)定義了幾種常見(jiàn)的位置能力使用場(chǎng)景，并針對(duì)使用場(chǎng)景做了適當(dāng)?shù)膬?yōu)化處理，應(yīng)用可以直接匹配使用，簡(jiǎn)化開(kāi)發(fā)復(fù)雜度。系統(tǒng)當(dāng)前支持場(chǎng)景如下表所示。

以導(dǎo)航場(chǎng)景為例，實(shí)例化方式如下：

   RequestParam requestParam = new RequestParam(RequestParam.SCENE_NAVIGATION);

方式二：

如果定義的現(xiàn)有場(chǎng)景類(lèi)型不能滿足所需的開(kāi)發(fā)場(chǎng)景，系統(tǒng)提供了基本的定位優(yōu)先級(jí)策略類(lèi)型。

以定位精度優(yōu)先策略為例，實(shí)例化方式如下：

   RequestParam requestParam = new RequestParam(RequestParam.PRIORITY_ACCURACY,0,0);

后兩個(gè)入?yún)⒂糜谙薅ㄏ到y(tǒng)向應(yīng)用上報(bào)定位結(jié)果的頻率，分別為位置上報(bào)的最小時(shí)間間隔，和位置上報(bào)的最小距離間隔，開(kāi)發(fā)者可以參考 API 具體說(shuō)明進(jìn)行開(kāi)發(fā)。

1. 實(shí)例化 LocatorCallback 對(duì)象，用于向系統(tǒng)提供位置上報(bào)的途徑。

應(yīng)用需要自行實(shí)現(xiàn)系統(tǒng)定義好的回調(diào)接口，并將其實(shí)例化。系統(tǒng)在定位成功確定設(shè)備的實(shí)時(shí)位置結(jié)果時(shí)，會(huì)通過(guò) onLocationReport 接口上報(bào)給應(yīng)用。應(yīng)用程序可以在 onLocationReport 接口的實(shí)現(xiàn)中完成自己的業(yè)務(wù)邏輯。

   MyLocatorCallback locatorCallback = new MyLocatorCallback();
    
   public class MyLocatorCallback implements LocatorCallback {
       @Override
       public void onLocationReport(Location location) {
       }
    
       @Override
       public void onStatusChanged(int type) {
       }
    
       @Override
       public void onErrorReport(int type) {
       }
   }

1. 啟動(dòng)定位。

   locator.startLocating(requestParam, locatorCallback);

如果應(yīng)用不需要持續(xù)獲取位置結(jié)果，可以使用如下方式啟動(dòng)定位，系統(tǒng)會(huì)上報(bào)一次實(shí)時(shí)定位結(jié)果后，自動(dòng)結(jié)束應(yīng)用的定位請(qǐng)求。應(yīng)用不需要執(zhí)行結(jié)束定位。

   locator.requestOnce(requestParam, locatorCallback);

1. （可選）結(jié)束定位。

   locator.stopLocating(locatorCallback);

如果應(yīng)用使用場(chǎng)景不需要實(shí)時(shí)的設(shè)備位置，可以獲取系統(tǒng)緩存的最近一次歷史定位結(jié)果。

   locator.getCachedLocation();

此接口的使用需要應(yīng)用向用戶申請(qǐng) LOCATION 位置權(quán)限。