HarmonyOS Map Kit 地图创建开发指南

本技能提供华为地图Map Kit SDK的地图创建与覆盖物管理功能开发指南。

领域知识

地图创建Skill覆盖MapComponent组件创建、覆盖物添加删除、相机动画控制等核心能力。

关键Note：

• MapComponent是基础：必须先在UI中创建MapComponent组件，才能获取Controller进行后续操作
• Controller空检查必须：通过mapCallback获取的MapComponentController使用前必须进行空检查
• 坐标系统一：geoLocationManager返回WGS84坐标系，地图显示使用GCJ02坐标系，必须转换
• 异步处理：除TileOverlay和MvtOverlay外，所有地图API返回Promise，必须使用async/await

扩展知识 → references/（可按需查阅）

• 坐标系转换规则 → references/utility.md
• 覆盖物选项参数 → references/common.md

工具定义（Tools）