一、导读

7月31日，华为HarmonyOS开发者日将在杭州举办。为了不便更多开发者，高德开放平台地图SDK已在业内率先实现鸿蒙化迁徙和重构，全面适配HarmonyOS并面向开发者收费公布。开发者可到高德开放平台官网理解更多内容，获取版本下载、开发文档、常见问题等反对。

拜访高德开放平台：https://lbs.amap.com/

在往年6月2日，华为就正式公布了HarmonyOS。因为HarmonyOS在兼容Android上有特殊要求，如果APP利用是用Android API开发，开发者能够间接应用Android的SDK。

但如果APP用了HarmonyOS的API开发，就不能用Android的SDK而须要应用HarmonyOS版本的SDK。

为了不便开发者在HarmonyOS的相应设施中进行LBS服务的开发，高德开放平台率先进行了HarmonyOS适配，首批适配范畴包含地图和搜寻SDK，反对嵌入搭载HarmonyOS的手机、Pad及其他智能终端设备。

二、HarmonyOS地图SDK个性介绍

与高德开放平台Android地图SDK平滑切换

  • 已集成高德开放平台Android地图SDK的开发者可无缝切换到HarmonyOS地图SDK，无额定开发量。HarmonyOS与Android零碎间的接口变动由高德开放平台SDK适配层消化，SDK对外接口放弃不变。
  • 高德底层引擎对接HarmonyOS NDK，下层代码全面对接HarmonyOS SDK，所有零碎接口均应用HarmonyOS API。

继承高德开放平台Android/iOS地图SDK性能亮点

  • 开发者能够通过高德开放平台API和SDK，轻松实现地图的构建工作，将地图粗劣地出现在您的利用中。地图SDK不仅提供丰盛的地图覆盖物绘制能力，也反对搜寻、多种门路布局、坐标转换、间隔测量、面积计算等性能。
  • 适配HarmonyOS后的地图SDK仍旧反对与自定义地图SaaS平台等周边工具配合应用，开发者能够在平台中定制区域面、建筑物、水系、天空、路线、标注、行政边界共7大类40余种地图元素，灵便设计心仪的地图款式。更多地图SDK根底能力、自定义、可视化能力详情请参考高德开放平台官网。

HarmonyOS版地图SDK整体框架

HarmonyOS和Android零碎差别很大，简直所有的API都有调整，不少API都调整了实现计划，所以不能通过改包名来实现适配。咱们将原生SDK中所有调用Android的代码均切换为适配层，在适配层将SDK的接口一一适配到HarmonyOS接口。

HarmonyOS版地图SDK整体框架大抵如下：

三、如何集成-从零开始

第一步 搭建HarmonyOS开发环境

实现DevEco Studio装置、环境配置和工程创立，参考HarmonyOS官网阐明：https://developer.harmonyos.c...

第二步 配置利用的签名信息

利用工程创立实现后，须要配置签名信息，才能够应用真机调试和公布利用。

第三步 获取利用的appId

配置完签名信息之后，就能够获取以后利用的appId了，这个appId次要用于申请高德的apiKey，请确定最终公布利用的appId，避免最终高德SDK鉴权失败。

通过代码获取利用的appId形式如下：

getApplicationContext().getBundleManager().getBundleInfo(getBundleName(), 0).getAppId()

留神：目前通过DevEco Studio连贯云真机获取到的appId不全，只获取到了"包名_", 应用云真机调试高德地图SDK时会导致鉴权不通过。正确的appId模式为："包名_签名信息"， 例如：com.amap.demo_BGtGgVB3ASqU7XXXXV2/zhoYh6tFQHAd5DASWVTEAgvZfzrEGljjs=

第四步 在高德开放平台官网控制台申请API Key

创立新利用

从开放平台官网右上角入口-控制台，创立一个新利用。如果您之前曾经创立过利用，可间接跳过这个步骤。

增加新Key

在创立的利用上点击"增加新Key"按钮，在弹出的对话框中，顺次：输出利用名名称，抉择绑定的服务为“Harmony平台SDK”，输出AppID，如下图所示：

须要留神：1个Key只能用于一个利用（多渠道安装包属于多个利用），1个Key在多个利用上应用会呈现服务调用失败。

在浏览完高德地图API服务条款后，勾选此选项，点击“提交”，实现Key的申请，此时您能够在所创立的利用上面看到刚申请的Key了。

第五步 在代码中设置申请的Key

请应用API的形式将申请的高德API Key设置给高德地图SDK。

/** * 动静设置apiKey。 * * @param apiKey 在高德官网上申请的apiKey。 */MapsInitializer.setApiKey(String apiKey)

留神：请确保在调用任何高德地图SDK的接口之前将API Key设置给高德地图SDK，倡议放到Application的初始化之中。

实现以上5步之后，就能够欢快的应用HarmonyOS版高德地图SDK了。

四、如何应用-创立地图

应用地图SDK之前，须要在config.json文件中进行相干权限设置，确保地图功能能够失常应用。

第一步 配置config.json

首先，申明权限。

..."reqPermissions": [      {        "usedScene": {          "ability": [            "com.example.harmonysearchsdk.MainAbility"          ],          "when": "always"        },        "reason": "request internet",        "name": "ohos.permission.INTERNET"      }    ]...

第二步 向工程中增加地图开发包

将har包放入libs目录下，顺次增加依赖。

dependencies {    implementation files("libs/xxx.har")    //...}

或者间接应用引入libs下所有har包的形式：

dependencies {  implementation fileTree(dir: 'libs', include: ['*.jar', '*.har'])    //...}

第三步 初始化地图容器

设置Key

获取Key形式请参考上方“从零开始”章节第四步。

MapsInitializer.setApiKey("您的key");

创立MapView

public class BasicMapDemoSlice extends Ability {    private MapView mapView;    @Override    protected void onStart(Intent intent) {        super.onStart(intent);        initMapView();    }    private void initMapView() {        mapView = new MapView(this);        mapView.onCreate(null);        mapView.onResume();        DirectionalLayout.LayoutConfig config = new DirectionalLayout.LayoutConfig(                DirectionalLayout.LayoutConfig.MATCH_PARENT, DirectionalLayout.LayoutConfig.MATCH_PARENT);        mapView.setLayoutConfig(config);        super.setUIContent(mapView);    }    @Override    protected void onStop() {        super.onStop();        if (mapView != null) {            mapView.onDestroy();        }    }}

初始化地图并获取AMap对象

AMap aMap = mapView.getMap();aMap.setOnMapLoadedListener(new AMap.OnMapLoadedListener() {    @Override    public void onMapLoaded() {    // todo    }});

至此就能够看到地图展现，并且拿到AMap对象后，就能够往地图上增加点线面等覆盖物了。

五、获取更多详情和开发反对

拜访高德开放平台：https://lbs.amap.com/

获取HarmonyOS版高德地图SDK下载、开发文档、Demo等开发反对：https://lbs.amap.com/api/harm...