1. 引入必要的库
- Three.js：一个用于创建和显示3D图形的JavaScript库。
- @vuemap/three-layer：一个Vue插件，它允许你在高德地图中添加Three.js图层。
- @vuemap/layer-3dtiles：一个用于处理3D Tiles格式数据的Vue插件，可以用来加载和渲染3D模型。
npm install three @vuemap/three-layer @vuemap/layer-3dtiles
# 或者
yarn add three @vuemap/three-layer @vuemap/layer-3dtiles
：
import { AmbientLight } from 'three';
import { ThreeLayer } from '@vuemap/three-layer';
import { Layer3DTiles } from '@vuemap/layer-3dtiles';
2. 使用 AmbientLight 添加环境光
AmbientLight 是Three.js中的一个类，用于为场景提供均匀的光照效果。它不会产生阴影，并且其颜色和强度会均匀地照亮所有对象。这对于增强3D模型的可见性和真实感非常有用。
-
参数:
color(Hexadecimal): 光的颜色，默认是白色（0xffffff）。intensity(Number): 光的强度，默认是1.0。
-
示例:
const light = new AmbientLight(0xffffff, 2); // 白色光，强度为2
layer.add(light); // 将环境光添加到ThreeLayer实例中
3. 使用 ThreeLayer 创建3D图层
ThreeLayer 是由 @vuemap/three-layer 提供的一个类，它允许你将Three.js场景作为一个图层添加到高德地图中。这个类封装了Three.js的核心功能，并与高德地图API进行了集成，使得我们可以轻松地在地图上展示3D内容。
-
构造函数参数:
map(AMap.Map): 高德地图实例。
-
方法:
on(event, callback): 监听事件，例如complete，当图层加载完成时触发。add(object): 向图层中添加Three.js的对象，如灯光、几何体等。setzIndex(index): 设置图层的z-index，以控制图层的堆叠顺序。
-
示例:
const layer = new ThreeLayer(map);
layer.on('complete', () => {// 图层加载完成后执行的操作
});
layer.setzIndex(10); // 设置较低的zIndex，确保模型不覆盖其他内容
4. 使用 Layer3DTiles 加载3D模型
Layer3DTiles 是由 @vuemap/layer-3dtiles 提供的一个类，专门用于加载和渲染符合3D Tiles规范的数据。3D Tiles是一种开放标准，旨在高效地传输和渲染大规模三维地理空间数据集。它支持多种几何类型，包括点云、BIM/CAD模型、倾斜摄影等。
-
构造函数参数:
layer(ThreeLayer): 作为父容器的ThreeLayer实例。options(Object): 包含配置选项的对象，如url、position等。
-
配置选项:
url(String): 指向3D Tiles数据源的URL。position(Array): 模型的位置，通常是[经度, 纬度, 海拔]的形式。rotation(Object): 模型的旋转属性，包含x, y, z轴的旋转角度。scale(Object): 模型的比例因子，用于缩放模型。translate(Object): 模型的平移属性，用于调整模型的位置。
-
方法:
setRotation(rotation): 设置模型的旋转属性。setScale(scale): 设置模型的比例因子。setTranslate(translate): 设置模型的平移属性。
-
示例:
const tiles = new Layer3DTiles(layer, {url: value.url,position: value.position,
});
tiles.setRotation({ ...value.modelRotation });
tiles.setScale({ ...value.modelScale });
tiles.setTranslate({ ...value.translate });
5. 整合一切
const get3dmap = async (map) => {let data = await mapApi().get3dmap({ }); //请求模型数据if (data.status * 1 == 200) {handleSelectValue.value = data.data.modelInfo.map((item) => ({ //用作下拉框切换模型label: item.modelName,value: JSON.stringify(item.draw_model_config[0].position),}));let models = data.data.modelInfo;let layers = [];for (let model of models) {let modelConfig = model.draw_model_config.filter(config => config.type === '3D');if (modelConfig.length > 0) {let value = modelConfig[0];const layer = new ThreeLayer(map);layer.on('complete', () => {const light = new AmbientLight('#fff', 2);layer.add(light);const tiles = new Layer3DTiles(layer, {url: value.url,position: value.position,});tiles.setRotation({ ...value.modelRotation });tiles.setScale({ ...value.modelScale });tiles.setTranslate({ ...value.translate });});layer.setzIndex(10);layers.push(layer);}}return layers;}
};
6. 初始化地图并添加3D图层
最后，我们需要初始化高德地图，并在地图加载完成后调用 get3dmap 函数来获取3D模型并将其添加到地图中。同时，还可以添加其他类型的图层，比如瓦片图层，来丰富地图的内容。
function onMapInit(map) {mapInstance = map;get3dmap(map).then(layers => {layers.forEach(layer => {map.add(layer);});});const key = window.KEY || ''; //天地瓦片keyconst wmts = new AMap.TileLayer({tileUrl: `http://t0.tianditu.gov.cn/DataServer?T=img_w&tk=${key}&x=[x]&y=[y]&l=[z]`,zIndex: 1,});map.add(wmts);
}
