一、Map Kit

Map Kit（地图服务）提供了强大便捷的地图能力，助力全球开发者实现个性化显示地图、位置搜索和路径规划等功能，轻松完成地图构建工作。

Map Kit提供了全球3.2亿的POI（Point of Interest，兴趣点）。在地图表达中，一个POI可代表一家商铺、一栋办公楼、一处景点等。

功能范围

功能	说明
创建地图	创建地图组件、设置地图属性、自定义地图
地图交互	控制地图的交互手势和交互按钮
在地图上绘制	添加位置标记、覆盖物以及各种形状
位置搜索	多种查询POI信息的能力，提供正地理编码、逆地理编码
路径规划	提供驾车、步行、骑行路径规划能力
静态图	获取一张地图图片
地图Picker	提供地点详情展示控件、地点选取控件、区划选择控件
通过地图应用实现导航	查看位置详情、查看路径规划、发起导航、发起内容搜索
地图计算工具	坐标系转换

坐标系说明

区域	坐标系
中国大陆	GCJ02坐标系
中国台湾和海外	WGS84坐标系

支持的设备

设备类型	支持
Phone	✅
Tablet	✅
PC/2in1	✅
Wearable	✅

模拟器支持情况

模拟器类型	限制说明
ARM模拟器	petalMaps命名空间下相关功能不支持，我的位置功能不支持
x86模拟器	petalMaps命名空间下相关功能不支持，我的位置功能不支持，手表不支持

二、开发准备

2.1 说明

从HarmonyOS 5.0.2(14)版本开始，无需配置公钥指纹和Client ID。

从DevEco Studio 6.0.0 Beta5版本开始，支持在DevEco Studio中开通地图服务。

2.2 开通地图服务的方式

方式	说明
方式一	通过DevEco Studio开通地图服务
方式二	通过AppGallery Connect网站开通地图服务

方式一：通过DevEco Studio开通地图服务

步骤1：登录DevEco Studio

登录DevEco Studio应用。

步骤2：进入项目结构

选择文件 → 点击项目结构。

步骤3：进入Signing Configs页面

点击"Enable open capabilities"。

步骤4：勾选Map Kit

勾选"Map Kit"选项，点击"OK"。

步骤5：应用配置

选择"Apply"应用地图服务配置，点击"OK"完成地图服务配置。

方式二：通过AppGallery Connect网站开通地图服务

步骤1：登录AGC网站

登录AppGallery Connect网站，选择"开发与服务"。

步骤2：选择项目和应用

在项目列表中找到您的项目，在项目下的应用列表中选择需要打开"地图服务"的应用。

步骤3：开启地图服务

选择开放能力管理，找到"地图服务"开关，打开开关。

四、签名配置

4.1 调试阶段配置

步骤	说明
1	申请调试证书
2	注册设备
3	开启"地图服务"后重新申请调试Profile文件
4	完成手动签名

4.2 发布阶段配置

步骤	说明
1	申请发布证书
2	开启"地图服务"后重新申请发布Profile文件
3	配置签名信息

说明：

• 若使用原有的Profile文件，请确保在申请Profile文件之前已开启"地图服务"

• 调试阶段必须手动签名