鸿蒙高德地图开发步骤

Posted 2021-08-31 笔触狂放

首先搜索“高德地图开发者平台”，如果没有注册过的朋友，先进行开发者的注册，注册方式很简单，直接使用支付宝实名认证注册。成文开发者用户之后

高德开放平台地图SDK已实现功能的鸿蒙化迁移和重构，全面适配鸿蒙系统HarmonyOS 2.0。现地图搜索SDK和3D地图SDK Beta版本已面向所有鸿蒙开发者免费发布，欢迎各位参考开发文档和常见问题！

地图SDK适配鸿蒙2.0特性介绍

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

• 已集成高德开放平台android地图SDK的开发者可无缝切换到HarmonyOS地图SDK，无额外开发量。HarmonyOS与Android系统间的接口变化由高德开放平台SDK适配层消化，SDK对外接口保持不变。
• 高德底层引擎适配鸿蒙NDK，上层代码全面适配鸿蒙SDK，所有系统接口均使用鸿蒙API。

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

• 地图SDK基础能力请参考地图产品介绍 ，开发者可以通过高德开放平台API和SDK，轻松地完成地图的构建工作，将地图精致地呈现在您的应用中。地图SDK不仅提供丰富的地图覆盖物绘制能力，也支持搜索、多种路径规划、坐标转换、距离测量、面积计算等功能。
• 适配鸿蒙后的地图SDK依旧支持与自定义地图SaaS平台等周边工具配合使用，自定义地图能力请参考自定义地图产品介绍。

入门指南

第一步搭建HarmonyOS开发环境

开发鸿蒙应用需要使用HarmonyOS的IDE进行开发，具体内容请参考HarmonyOS官网开发文档

1. 开始前请参考下载与安装软件、配置开发环境，完成DevEco Studio的安装和开发环境配置。

2. 开发环境配置完成后，请参考创建和运行Hello World创建工程，设备类型以“Phone”为例：

a、使用Java语言开发，模板选择“Empty Feature Ability(Java)”

b、使用JS语言开发，模板选择“Empty Feature Ability(JS)”

1. 工程创建完成后，使用预览器或Phone模拟器运行该工程。

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

应用工程创建完成后，需要配置签名信息，才可以使用真机调试和发布应用。具体的签名配置请参考HarmonyOS官网的配置应用签名信息指南

第三步获取应用的appId

配置完签名信息之后，就可以获取当前应用的appId了，这个appId主要用于申请高德的apiKey，请确定最终发布应用的appId, 防止最终高德SDK鉴权失败。

目前只能通过代码获取应用的appId，具体代码请参考如下代码

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

最终获取的appId格式类似于：com.amap.demo_BGtGgVB3ASqU7ar1nHkwX4s0nIexDbEwqNrVoatUDs17GrClWC7V2/zhoYh6tFQHAd5DXXXXXXAgvZfzrEGljjs=

注意：目前通过DevEco Studio连接云真机获取到的appId不全，只获取到了"包名_", 使用云真机调试高德地图SDK时会导致鉴权不通过。

第四步申请高德API Key

具体获取key的步骤请参考 获取key

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

注意：请保证在调用任何高德地图SDK的接口之前将apikey设置给高德地图SDK，建议放到Application的初始化之中。

请使用api的方式将申请的高德api key设置给高德地图SDK。

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

完成以上5步之后，就可以愉快的使用HarmonyOS版高德地图SDK了。