如何申請(qǐng)key

1、創(chuàng)建新應(yīng)用

進(jìn)入[控制臺(tái)]，創(chuàng)建一個(gè)新應(yīng)用。如果您之前已經(jīng)創(chuàng)建過應(yīng)用，可直接跳過這個(gè)步驟。

2、添加新Key

在創(chuàng)建的應(yīng)用上點(diǎn)擊"添加新Key"按鈕，在彈出的對(duì)話框中，依次：輸入應(yīng)用名名稱，選擇綁定的服務(wù)為“HarmonyOS平臺(tái)”，輸入AppID，如下圖所示：

注意

1個(gè)KEY只能用于一個(gè)應(yīng)用（多渠道安裝包屬于多個(gè)應(yīng)用），1個(gè)Key在多個(gè)應(yīng)用上使用會(huì)出現(xiàn)服務(wù)調(diào)用失敗。

在閱讀完高德地圖API服務(wù)條款后，勾選此選項(xiàng)，點(diǎn)擊“提交”，完成 Key 的申請(qǐng)，此時(shí)您可以在所創(chuàng)建的應(yīng)用下面看到剛申請(qǐng)的 Key 了。

如何獲取AppID

請(qǐng)?jiān)诋?dāng)前應(yīng)用的Ablitiy中使用如下代碼獲取

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

注意事項(xiàng)

1. 獲取AppID之前需要先配置應(yīng)用的簽名信息。
2. 目前通過DevEco Studio連接云真機(jī)獲取到的appId不全，只獲取到了"包名_", 使用云真機(jī)調(diào)試高德地圖SDK時(shí)會(huì)導(dǎo)致鑒權(quán)不通過，正確的appId形式為："包名_簽名信息"， 例如：com.amap.demo_BGtGgVB3ASqU7ar1nHkwX4s0nIexDbEwqNrVoatUDs17GrClWC7V2/zhoYh6tFQHAd5DASWVTEAgvZfzrEGljjs=

獲取定位數(shù)據(jù)

使用定位SDK之前，需要在 config.json 文件中進(jìn)行相關(guān)權(quán)限設(shè)置，確保定位功能可以正常使用。

第一步，配置module.json5

首先，聲明權(quán)限

...
 "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"
        }
      }
    ]
...

第二步，向工程中添加定位開發(fā)包

從ohpm倉(cāng)庫(kù)獲取定位包，依次添加依賴。

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

第三步，初始化定位

首先，設(shè)置Key

[獲取Key]

AMapLocationManagerImpl.setApiKey("您的key");

初始化隱私政策

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

創(chuàng)建AMapLocationManagerImpl

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

動(dòng)態(tài)申請(qǐng)相關(guān)權(quán)限

reqPermissionsFromUser(permissions: Array< Permissions >): void {
    let context: Context = getContext(this) as common.UIAbilityContext;
    let atManager: abilityAccessCtrl.AtManager = abilityAccessCtrl.createAtManager();
    // requestPermissionsFromUser會(huì)判斷權(quán)限的授權(quán)狀態(tài)來決定是否喚起彈窗
    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) {
          // 用戶授權(quán)，可以繼續(xù)訪問目標(biāo)操作
        } else {
          // 用戶拒絕授權(quán)，提示用戶必須授權(quán)才能訪問當(dāng)前頁(yè)面的功能，并引導(dǎo)用戶到系統(tǒng)設(shè)置中打開相應(yīng)的權(quán)限
          return;
        }
      }
      // 授權(quán)成功
    }).catch((err: BusinessError) = > {
      console.error(`Failed to request permissions from user. Code is ${err.code}, message is ${err.message}`);
    })
  }

最后，開始請(qǐng)求相關(guān)定位信息

如：連續(xù)定位

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()

如需在后臺(tái)定位，則要在應(yīng)用切入后臺(tái)前調(diào)用開啟后臺(tái)定位任務(wù)

this.locationManger?.startContinuousTask()

回到前臺(tái)可以停止后臺(tái)任務(wù)

this.locationManger?.stopContinuousTask()

至此就可以看到定位相關(guān)信息。也可依據(jù)參考手冊(cè)實(shí)現(xiàn)單次定位、最后位置等操作。

審核編輯 黃宇