腾讯位置商业授权鸿蒙系统3D沉浸式地图SDK
3D沉浸式地图SDK新增了沉浸式3D样式支持,并提供部分样式配置能力。开发者可通过MapController调用setMapType()切换为IMMERSE3D地图类型,使用ImmerseConfig对象配置3D特效参数,包括立面AOI显示级别(16-22)、POI麻点效果、路名透明度(0-1)、建筑物碰撞检测及阴影效果等。示例代码演示了如何初始化3D地图并启用立面AOI显示功能。该SDK为开发者
·
3D沉浸式地图
地图SDK支持新的沉浸式3D样式, 并开放部份的样式配置能力。

3D沉浸式地图的相关方法
3D沉浸式地图需要通过MapController来调用对应方法
| 名称 | 类型 | 说明 |
|---|---|---|
| setMapType(mapType: MapType) | void | 设置地图类型 |
| setImmerseConfig(immerseConfig: ImmerseConfig) | void | 3D沉浸式样式配置, 地图类型为IMMERSE3D时生效 |
| getImmerseConfig() | ImmerseConfig | 获取3D沉浸式样式配置 |
ImmerseConfig对象
表示沉浸式3D配置项
构造函数
- 语法
new ImmerseConfig();
- 属性说明
| 名称 | 类型 | 说明 |
|---|---|---|
| is3DAOIEnable | boolean | 是否显示立面AOI, 默认关闭 |
| minLevel3DAOIDisplay | number | 立面AOI最小显示级别, 默认16 |
| maxLevel3DAOIDisplay | number | 立面AOI最大显示级别, 默认22 |
| isPOIDotStyleEnable | boolean | POI麻点效果是否可用, 默认打开 |
| isRoadNameTranslucentEnable | boolean | 建筑物遮挡路名半透明是否可用,默认关闭 |
| roadNameTranslucentAlpha | number | 路名半透透明度,范围:0-1 ,0是完全不显示,1是完全显示,默认1 |
| isCameraBuildingCollisionEnable | boolean | 是否开启建筑物避让屏幕,默认关闭 |
| isWholeBuildingCollisionEnable | boolean | 是否完整碰撞:有一部分被碰撞,就整个建筑不显示,默认关闭 |
| isBuildingExtEffectEnable | boolean | 楼块墙体法线窗格,默认关闭 |
| isShadowEnable | boolean | 全局阴影开关,默认关闭 |
| shadowStartLevel | number | 阴影显示起始级别,默认3 |
显示3D沉浸式地图
将当前地图切换为3D沉浸式地图类型,调用示例:
private mapController: MapController | undefined;
build() {
MapComponent({
onReady: (err: BusinessError, mapController: MapController) => {
this.mapController = mapController;
this.mapController.setMapType(MapType.IMMERSE3D);
}
}).width("100%").height("100%")
}
修改样式配置
将当前地图切换为3D沉浸式地图类型,调用示例:
private mapController: MapController | undefined;
private defaultImmerseConfig: ImmerseConfig = new ImmerseConfig();
build() {
MapComponent({
onReady: (err: BusinessError, mapController: MapController) => {
this.mapController = mapController;
this.mapController.setMapType(MapType.IMMERSE3D);
// 显示3D立面AOI,
this.defaultImmerseConfig.is3DAOIEnable = true;
this.mapController?.setImmerseConfig(this.defaultImmerseConfig);
}
}).width("100%").height("100%")
}
资料来源:
更多推荐



所有评论(0)