切换地图类型
======

#### 场景介绍

从6.0.0(20)开始，支持卫星图和混合地图功能。

Map Kit支持以下地图类型：

*   STANDARD：标准地图，展示道路、建筑物以及河流等重要的自然特征。
    
*   NONE：空地图，没有加载任何数据的地图。
    
*   TERRAIN：地形图，在保留了行政区划边界、POI、楼块等地图要素的基础上，呈现完整清晰描绘地形走势的标准地图。
    
*   SATELLITE：卫星图，显示卫星照片的地图，只支持中国。
    
*   HYBRID：混合地图，在显示卫星照片的同时也显示路网信息。
    

**图1** 标准地图

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/e8/v3/2L3GYNn_QS-POvfzT0vLeg/zh-cn_image_0000002625188677.jpg?HW-CC-KV=V1&HW-CC-Date=20260612T073625Z&HW-CC-Expire=86400&HW-CC-Sign=72B80440EE5FF5F659FCF7870FCD3BB61385DE2DF5D5D528446FC14F68859357 "点击放大")

**图2** 空地图

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/cc/v3/CAfC219OSO2LxFV_JJaeLw/zh-cn_image_0000002625108821.jpg?HW-CC-KV=V1&HW-CC-Date=20260612T073625Z&HW-CC-Expire=86400&HW-CC-Sign=04F3A5B6A154B1F8A80A6BCA5ED7C36DADB4ECE62DAF6D7FAA3CCFFEFBD6F046 "点击放大")

**图3** 地形图

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/02/v3/fOSdEv56Q-CqBsnSUiF3LA/zh-cn_image_0000002594669304.jpg?HW-CC-KV=V1&HW-CC-Date=20260612T073625Z&HW-CC-Expire=86400&HW-CC-Sign=7F812D272B850EE8A975999543BFA0E039E4D8DAE417D18DC47A2BCE5FA41710 "点击放大")

**图4** 卫星图

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/83/v3/3pyPGTMYQ2WstAQhcNNQpw/zh-cn_image_0000002594829232.jpg?HW-CC-KV=V1&HW-CC-Date=20260612T073625Z&HW-CC-Expire=86400&HW-CC-Sign=7AA319CB3B7E7CC6A6450C35FB171E842467265685F11B1572D3A5847FDCA13F "点击放大")

**图5** 混合地图

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/9a/v3/JE0ADzU-TCeDqmXLBobDdw/zh-cn_image_0000002625188679.jpg?HW-CC-KV=V1&HW-CC-Date=20260612T073625Z&HW-CC-Expire=86400&HW-CC-Sign=355D0E73005C519B14D15FAA254D57959071F1D05A6E998FEA5DE5B0E0768F35 "点击放大")

#### 接口说明

Map Kit提供2种方式设置地图类型：

方式一：在初始化的时候，通过设置[MapOptions](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-common#mapoptions)中的mapType属性来控制展示不同地图类型。

| 属性名 | 描述 |
| :-- | :-- |
| mapCommon.MapOptions.mapType | 地图初始化参数中的MapType地图类型。 |

方式二：地图创建后，可通过[setMapType](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-map-mapcomponentcontroller#setmaptype)方法动态设置地图类型。

| 方法名 | 描述 |
| :-- | :-- |
| [setMapType](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-map-mapcomponentcontroller#setmaptype)(mapType: [mapCommon.MapType](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-common#maptype)): void | 设置地图类型。 |

#### 开发步骤

1.  导入相关模块。
    
    import { mapCommon } from '@kit.MapKit';
    
2.  设置地图类型。
    
    方式一：
    
    在地图初始化的时候，在mapOptions参数中新增mapType属性：[mapCommon.MapType](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-common#maptype).STANDARD（标准地图）。
    
    this.mapOptions = {
      position: {
        target: {
          latitude: 31.984410259206815,
          longitude: 118.76625379397866
        },
        zoom: 15
      },
      mapType: mapCommon.MapType.STANDARD
    };
    
    显示效果如下：
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/aa/v3/zFq1rXjoRd66opH8SuXLMg/zh-cn_image_0000002625108823.jpg?HW-CC-KV=V1&HW-CC-Date=20260612T073625Z&HW-CC-Expire=86400&HW-CC-Sign=B5788727D60CD8EC4412B8FFBA9B9B29D8835657A4F163603B5800CCD4C6988F "点击放大")
    
    方式二：地图创建后，调用[setMapType](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-map-mapcomponentcontroller#setmaptype)方法设置地图类型为地形图。设置为地形图时，为了获得最佳显示效果，推荐将地图缩放层级保持在5至14之间。
    
    this.mapController.setMapType(mapCommon.MapType.TERRAIN);
    
    显示效果如下：
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/19/v3/kdLbUq6YRfS2UNvOyv8ZJQ/zh-cn_image_0000002594669306.jpg?HW-CC-KV=V1&HW-CC-Date=20260612T073625Z&HW-CC-Expire=86400&HW-CC-Sign=8BF03CEA11161922746DD855195AA54B6504369DD64846EF5D36ABA927B7EEB8 "点击放大")