如何申請key

1、創建新應用

進入[控制臺]，創建一個新應用。如果您之前已經創建過應用，可直接跳過這個步驟。

2、添加新Key

在創建的應用上點擊"添加新Key"按鈕，在彈出的對話框中，依次：輸入應用名名稱，選擇綁定的服務為“HarmonyOS平臺”，輸入AppID，如下圖所示：

注意

1個KEY只能用于一個應用（多渠道安裝包屬于多個應用），1個Key在多個應用上使用會出現服務調用失敗。

在閱讀完高德地圖API服務條款后，勾選此選項，點擊“提交”，完成 Key 的申請，此時您可以在所創建的應用下面看到剛申請的 Key 了。

如何獲取AppID

請在當前應用的Ablitiy中使用如下代碼獲取

let flag = bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_SIGNATURE_INFO;
let bundleInfo = bundleManager.getBundleInfoForSelfSync(flag)
let appId = bundleInfo.signatureInfo.appId;

注意事項

1. 獲取AppID之前需要先配置應用的簽名信息。
2. 目前通過DevEco Studio連接云真機獲取到的appId不全，只獲取到了"包名_", 使用云真機調試高德地圖SDK時會導致鑒權不通過，正確的appId形式為："包名_簽名信息"， 例如：com.amap.demo_BGtGgVB3ASqU7ar1nHkwX4s0nIexDbEwqNrVoatUDs17GrClWC7V2/zhoYh6tFQHAd5DASWVTEAgvZfzrEGljjs=

獲取定位數據

使用定位SDK之前，需要在 config.json 文件中進行相關權限設置，確保定位功能可以正常使用。

第一步，配置module.json5

首先，聲明權限

...
 "requestPermissions": [
      {
        "name": "ohos.permission.APPROXIMATELY_LOCATION",
        "usedScene": {
          "abilities": [
            "Harmony_location_demoAbility"
          ],
          "when": "always"
        }
      },
      {
        "name": "ohos.permission.LOCATION",
        "usedScene": {
          "abilities": [
            "Harmony_location_demoAbility"
          ],
          "when": "always"
        }
      },
      {
        "name": "ohos.permission.LOCATION_IN_BACKGROUND",
        "usedScene": {
          "abilities": [
            "Harmony_location_demoAbility"
          ],
          "when": "always"
        }
      },
      {
        "name": "ohos.permission.INTERNET",
        "usedScene": {
          "abilities": [
            "Harmony_location_demoAbility"
          ],
          "when": "always"
        }
      },
      {
        "name": "ohos.permission.KEEP_BACKGROUND_RUNNING",
        "usedScene": {
          "abilities": [
            "Harmony_location_demoAbility"
          ],
          "when": "always"
        }
      }
    ]
...

第二步，向工程中添加定位開發包

從ohpm倉庫獲取定位包，依次添加依賴。

"dependencies": {
    "@amap/amap_lbs_common": "1.0.0",
    "@amap/amap_lbs_location": "1.0.0"
}

第三步，初始化定位

首先，設置Key

[獲取Key]

AMapLocationManagerImpl.setApiKey("您的key");

初始化隱私政策

AMapLocationManagerImpl.updatePrivacyShow(AMapPrivacyShowStatus.DidShow, AMapPrivacyInfoStatus.DidContain, getContext(this))
    AMapLocationManagerImpl.updatePrivacyAgree(AMapPrivacyAgreeStatus.DidAgree, getContext(this))

創建AMapLocationManagerImpl

locationManger?: AMapLocationManagerImpl;
this.locationManger = new AMapLocationManagerImpl(this.context);

動態申請相關權限

reqPermissionsFromUser(permissions: Array< Permissions >): void {
    let context: Context = getContext(this) as common.UIAbilityContext;
    let atManager: abilityAccessCtrl.AtManager = abilityAccessCtrl.createAtManager();
    // requestPermissionsFromUser會判斷權限的授權狀態來決定是否喚起彈窗
    atManager.requestPermissionsFromUser(context, permissions).then((data: PermissionRequestResult) = > {
      let grantStatus: Array< number > = data.authResults;
      let length: number = grantStatus.length;
      for (let i = 0; i < length; i++) {
        if (grantStatus[i] === 0) {
          // 用戶授權，可以繼續訪問目標操作
        } else {
          // 用戶拒絕授權，提示用戶必須授權才能訪問當前頁面的功能，并引導用戶到系統設置中打開相應的權限
          return;
        }
      }
      // 授權成功
    }).catch((err: BusinessError) = > {
      console.error(`Failed to request permissions from user. Code is ${err.code}, message is ${err.message}`);
    })
  }

最后，開始請求相關定位信息

如：連續定位

let listener: IAMapLocationListener = {
                onLocationChanged: (location) = > {
                // todo something
                }, onLocationError: (error) = > {
                // todo something
                }
              };

let options: AMapLocationOption = {
  priority: geoLocationManager.LocationRequestPriority.FIRST_FIX,
  scenario: geoLocationManager.LocationRequestScenario.UNSET,
  timeInterval: 2,
  distanceInterval: 0,
  maxAccuracy: 0,
  allowsBackgroundLocationUpdates: true,
  locatingWithReGeocode: false,
  reGeocodeLanguage: AMapLocationReGeocodeLanguage.Chinese,
  isOffset: true
}

this.locationManger?.setLocationListener(AMapLocationType.Updating,listener)
this.locationManger?.setLocationOption(AMapLocationType.Updating,options)
this.locationManger?.startUpdatingLocation()
//  停止定位
//  this.locationManger?.stopUpdatingLocation()

如需在后臺定位，則要在應用切入后臺前調用開啟后臺定位任務

this.locationManger?.startContinuousTask()

回到前臺可以停止后臺任務

this.locationManger?.stopContinuousTask()

至此就可以看到定位相關信息。也可依據參考手冊實現單次定位、最后位置等操作。

審核編輯 黃宇