智能客服
你问我答，随时在线为你解决问题
- 探索了解鸿蒙应用和多设备开发，学习如何构建应用/元服务应用形态HarmonyOS 应用One as All，All as One
元服务秒开直达 服务随行 无处不在
游戏为游戏创意玩法带来无限可能
多设备应用开发穿戴
折叠屏手机鸿蒙电脑开发者学堂视频课程Codelabs - 设计了解鸿蒙应用和多设备开发，学习如何构建应用/元服务
- 开发获取官方开发工具和文档等资源，将创意转化为鸿蒙应用开发工具DevEco Studio应用开发 IDE, AI Agent 和 CLI
小艺开放平台Skill 和智能体开发平台
ArkTS
ArKUI
AppGallery ConnectDevEco Testing开发资源工具下载示例代码开发文档最佳实践 - 分发通过华为应用市场发布你的应用，多渠道触达用户应用分发应用市场纯净安全的全场景应用分发平台
游戏中心
应用审核政策服务分发小艺HarmonyOS 的超级 AI 入口
智慧助手·今天
服务分发文档内容分发主题服务
内容分发文档 - 推广与变现一站式流量增长与营销变现平台推广应用推广引擎全链路应用推广与增长服务平台
鲸鸿动能广告为企业广告主提供广告营销服务
联运服务推广文档变现鲸鸿动能流量变现使能应用展示广告，实现流量变现应用内支付变现文档 - 生态合作携手伙伴共建共享鸿蒙智能终端生态伙伴 SDK一站式获取安全可靠的鸿蒙伙伴 SDK
生态服务鸿蒙应用开发、培训和人力服务
服务商伙伴中心华为终端云服务商伙伴的统一门户
伙伴入驻指南生态市场介绍，卖家和买家服务指引
廉洁政策合作伙伴诚信廉洁政策
- 支持获取客服帮助、技术支持、活动资讯等信息智能客服24小时 AI 在线自助服务，即问即答
社区问答在官方论坛提问，与开发者互动交流
在线提单提交工单，获得技术支持
开发者活动HDD 等线下活动速览及报名入口
资讯帮助指南
全部文档
指南
API
开放能力API
应用框架
系统
媒体
图形
应用服务
AI
NDK开发
场景介绍
从6.1.0(23)开始，支持在地图左下角设置审图号。
本章节将向您介绍如何使用地图的控件。
控件是指浮在地图组件上的一系列用于操作地图的组件，例如缩放按钮
、定位按钮
、比例尺
等。
接口说明
以下是地图的控件相关接口，该功能有2种实现方式：
-
地图初始化时，可在初始化参数MapOptions中设置是否启用控件功能，详细讲解见显示地图章节。
-
通过调用MapComponentController提供的set方法实现相关控件的开启或关闭。
展开
| 接口名 | 描述 |
|---|---|
| setZoomControlsEnabled(enabled: boolean): void | 设置是否启用缩放控制器。 |
| setMyLocationEnabled(myLocationEnabled: boolean): void | 设置是否启用我的位置图层。 |
| setMyLocationControlsEnabled(enabled: boolean): void | 设置是否启用我的位置按钮。 |
| setScaleControlsEnabled(enabled: boolean): void | 设置是否启用比例尺。 |
| setScalePosition(point: mapCommon.MapPoint): void | 设置比例尺控件的位置。 |
| setAlwaysShowScaleEnabled(enabled: boolean): void | 设置是否始终显示比例尺。 |
| setCompassControlsEnabled(enabled: boolean): void | 设置是否启用指南针。 |
| setLogoAlignment(alignment: mapCommon.LogoAlignment): void | 设置地图Logo的对齐方式。 |
| setApproveNumberEnabled(enabled: boolean): void | 设置是否显示审图号，只有路由地在中国才会显示。 |
开发步骤
mapController对象在初始化地图时获取，初始化地图功能在显示地图章节中有详细讲解。
缩放控件
Map Kit提供了内置的缩放控件，默认情况下是开启的。
收起
自动换行
深色代码主题
复制
- // 开启缩放控件
- this.mapController.setZoomControlsEnabled(true);
比例尺
Map Kit提供了内置的比例尺控件，默认情况下是关闭的。
收起
自动换行
深色代码主题
复制
- // 开启比例尺控件
- this.mapController.setScaleControlsEnabled(true);
调整比例尺位置：
可通过setScalePosition方法设置比例尺控件的位置。
收起
自动换行
深色代码主题
复制
- let point: mapCommon.MapPoint = {
- // 以当前地图组件左上角为原点，向右移动1000px
- positionX: 1000,
- // 以当前地图组件左上角为原点，向下移动1000px
- positionY: 1000
- };
- this.mapController.setScalePosition(point);
获取当前层级的比例尺大小：
可通过getScaleLevel方法获取当前层级比例尺大小。
收起
自动换行
深色代码主题
复制
- let level = this.mapController.getScaleLevel();
获取比例尺控件宽高：
可通过getScaleControlsHeight和getScaleControlsWidth方法获取当前比例尺控件宽高。
收起
自动换行
深色代码主题
复制
- // 获取比例尺控件的高度
- let height = this.mapController.getScaleControlsHeight();
- // 获取比例尺控件的宽度
- let width = this.mapController.getScaleControlsWidth();
设置比例尺控件常显：
可通过setAlwaysShowScaleEnabled方法设置比例尺控件常显，通过isAlwaysShowScaleEnabled方法查询比例尺控件是否常显。
收起
自动换行
深色代码主题
复制
- // 设置比例尺控件常显
- this.mapController.setAlwaysShowScaleEnabled(true);
- // 查询比例尺控件是否常显
- let scaleEnabled: boolean = this.mapController.isAlwaysShowScaleEnabled();
指南针
Map Kit提供了内置的指南针控件，默认情况下是开启的，控件位置默认显示在地图的右上角。如果是启用状态，当地图不是指向正北方向或者发生倾斜时，地图右上角会显示一个指南针图标，点击指南针可使地图旋转为正北方向并且取消倾斜；当地图为正北方向且未发生倾斜时，指南针图标隐藏。如果是禁用状态，将不会显示指南针图标。
收起
自动换行
深色代码主题
复制
- // 开启指南针控件
- this.mapController.setCompassControlsEnabled(true);
调整指南针位置：
可通过setCompassPosition方法设置指南针控件的位置。
收起
自动换行
深色代码主题
复制
- let point: mapCommon.MapPoint = {
- // 以当前地图组件左上角为原点，向右移动1000px
- positionX: 1000,
- // 以当前地图组件左上角为原点，向下移动1000px
- positionY: 1000
- };
- this.mapController.setCompassPosition(point);
地图Logo
Map Kit提供了调整地图Logo对齐方式的方法setLogoAlignment和调整地图边界与Logo之间的间距的方法setLogoPadding。需注意，地图Logo不允许被遮挡，可通过setLogoPadding方法设置地图边界区域，来避免logo被遮挡。
收起
自动换行
深色代码主题
复制
- // 将Logo放置在右下角位置
- this.mapController.setLogoAlignment(mapCommon.LogoAlignment.BOTTOM_END);
- // 设置地图边界与Logo之间的间距，单位：px
- let padding: mapCommon.Padding = {
- right: 50,
- bottom: 50
- };
- this.mapController.setLogoPadding(padding);
审图号
审图号是指国家对地图产品进行审核并颁发的编号，用于标识地图已通过国家测绘地理信息局的审查。
Map Kit通过方法setApproveNumberEnabled展示审图号。如图左下角：
收起
自动换行
深色代码主题
复制
- // 显示审图号
- this.mapController?.setApproveNumberEnabled(true);
华为开发者联盟 版权所有 ©2026
在 开发与测试 开放能力API 中进行搜索
请输入您想要搜索的关键词