3D地图 最后更新时间: 2025年11月03日

JS API 3D 地图是基于矢量地图数据提供的新的地图视图效果,相比 2D 地图增加了对旋转、视角倾斜等地图功能的支持。3D 地图基于 WebGL 开发,在保证流畅度的同时,增加了对无级别缩放等功能的支持。

本章将向你介绍:

• 开启 3D 地图和地形图。
• 3D 地图兼容性说明。

3D 地图示例

使用说明

准备

开启 3D 地图

开启 3D 地图视图效果,需要引用 JS API v1.4.0以上版本的 JS API,同时在 Map 初始化的时候给地图添加viewMode:'3D'属性。

var map = new AMap.Map('container', {
 pitch: 50, //地图俯仰角度,有效范围 0 度- 83 度
 viewMode: '3D', //地图模式
 rotateEnable: true, //是否开启地图旋转交互 鼠标右键 + 鼠标画圈移动 或 键盘Ctrl + 鼠标左键画圈移动
 pitchEnable: true, //是否开启地图倾斜交互 鼠标右键 + 鼠标上下移动或键盘Ctrl + 鼠标左键上下移动
 zoom: 17, //初始化地图层级
 rotation: -15, //初始地图顺时针旋转的角度
 zooms: [2, 20], //地图显示的缩放级别范围
 center: [116.333926, 39.997245] //初始地图中心经纬度
});

开启 3D 地形图

开启 3D 地形图效果,需要引用 JS API v2.1Beta版本的 JS API,同时在 Map 初始化的时候给地图添加viewMode:'3D'和terrain:true属性。3D 地形图相对比 3D 地图主要侧重于展示地球的地形特征。选择使用哪种地图类型取决于你的需求和展示效果的要求。

var map = new AMap.Map('container', {
 viewMode: '3D', //地图模式
 terrain: true //开启地形图
});

https://webapi.amap.com/maps?v=2.1Beta&key=你申请的key值

开启地图缩放和旋转插件

可以通过引入插件来拓展地图的功能,本示例采用AMap.plugin()异步引入,更多引入方式详见插件的使用 。

AMap.plugin(['AMap.ControlBar', 'AMap.ToolBar'], function () { //异步加载插件
 var controlBar = new AMap.ControlBar({ //控制地图旋转插件
 position: {
 right: '10px',
 top: '10px'
 }
 });
 map.addControl(controlBar);
 var toolBar = new AMap.ToolBar({ //地图缩放插件
 position: {
 right: '40px',
 top: '110px'
 }
 });
 map.addControl(toolBar)
});

3D 地图兼容性说明

• 3D 地图效果下,如果使用自定义栅格图,需要保证栅格图片服务返回的图片资源是带有 Access-Control-Allow-Origin:* 响应 Header 的,否则将无法加载自定义栅格图。
• 3D 地图目前兼容 windows、Mac、iOS、Android 等多平台下的众多浏览器,但是由于地图绘制依赖 WebGL 等前端环境,如果终端环境无法满足 3D 绘制的要求,我们将仍然使用原有 2D 视图进行绘制。
• JS API v1.4之后的版本开始支持 3D 地图,3D 视图不支持的组件如下:

本章涉及的属性及方法说明

AMap.Map

AMap.plugin