3D地图 最后更新时间: 2023年11月20日

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