鴻蒙OS 獲取設備的位置信息

場景介紹

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

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

接口說明

獲取設備的位置信息，所使用的接口說明如下。

開發(fā)步驟

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

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

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

訪問設備的位置信息，必須申請 ohos.permission.LOCATION 權限，并且獲得用戶授權。

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

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

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

說明

配置字段詳細說明見權限開發(fā)指導。在使用系統(tǒng)位置能力時，向用戶動態(tài)申請位置權限，申請方式請參考動態(tài)申請權限開發(fā)步驟。

1. 實例化 Locator 對象，所有與基礎定位能力相關的功能 API，都是通過 Locator 提供的。

   Locator locator = new Locator(context);

其中入?yún)⑿枰峁┊斍皯贸绦虻?AbilityInfo 信息，便于系統(tǒng)管理應用的定位請求。

1. 實例化 RequestParam 對象，用于告知系統(tǒng)該向應用提供何種類型的位置服務，以及位置結果上報的頻率。

方式一：

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

以導航場景為例，實例化方式如下：

   RequestParam requestParam = new RequestParam(RequestParam.SCENE_NAVIGATION);

方式二：

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

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

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

后兩個入?yún)⒂糜谙薅ㄏ到y(tǒng)向應用上報定位結果的頻率，分別為位置上報的最小時間間隔，和位置上報的最小距離間隔，開發(fā)者可以參考 API 具體說明進行開發(fā)。

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

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

   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. 啟動定位。

   locator.startLocating(requestParam, locatorCallback);

如果應用不需要持續(xù)獲取位置結果，可以使用如下方式啟動定位，系統(tǒng)會上報一次實時定位結果后，自動結束應用的定位請求。應用不需要執(zhí)行結束定位。

   locator.requestOnce(requestParam, locatorCallback);

1. （可選）結束定位。

   locator.stopLocating(locatorCallback);

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

   locator.getCachedLocation();

此接口的使用需要應用向用戶申請 LOCATION 位置權限。