0.0.7 • Published 10 months ago

@vuemap/layer-3dtiles v0.0.7

Weekly downloads
-
License
MIT
Repository
github
Last release
10 months ago

@vuemap/layer-3dtiles

npm (tag) NPM downloads JS gzip size NPM star

简介

本项目为高德地图的3DTilesLayer图层插件,依赖@vuemap/three-layer插件,因此如果使用npm安装时需要安装@vuemap/three-layer

当前坐标只支持box、region, 不支持sphere 从0.0.7版本开始可以初始化可以不传position,不传时将默认从3dtiles数据中获取中心点和海拔

示例

codepen示例

模型导出时注意事项

  • 当使用shp文件生成3dtiles时,参考坐标系需要根据shp文件的坐标系来设定,正常shp文件使用EPSG:4326坐标系,也就是WGS84
  • 只支持box、region包围盒

开发注意事项

  • 当加载3dtiles,需要关闭浏览器的开发者工具,不然在销毁3dtiles图层时会有部分显存无法释放

加载方式

当前项目支持CDN加载和npm加载两种方式。

CDN加载

CDN加载需要先加载高德地图JS、threejs的库和@vuemap/three-layer,代码如下

<!--加载高德地图JS 2.0 -->
<script src = 'https://webapi.amap.com/maps?v=2.0&key=YOUR_KEY'></script>
<!--加载threejs -->
<script src="https://cdn.jsdelivr.net/npm/three@0.143/build/three.js"></script>
<!--加载draco -->
<script src="https://cdn.jsdelivr.net/npm/three@0.143/examples/js/loaders/DRACOLoader.js"></script>
<!--加载threejs的GLTFLoader -->
<script src="https://cdn.jsdelivr.net/npm/three@0.143/examples/js/loaders/GLTFLoader.js"></script>
<!--加载three-layer插件 -->
<script src="https://cdn.jsdelivr.net/npm/@vuemap/three-layer/dist/index.js"></script>
<!--加载layer-3dtiles插件 -->
<script src="https://cdn.jsdelivr.net/npm/@vuemap/layer-3dtiles/dist/index.js"></script>

npm加载

npm加载可以直接使用安装库

npm install @vuemap/layer-3dtiles @vuemap/three-layer

使用示例

CDN方式

<script src = 'https://webapi.amap.com/maps?v=2.0&key=YOUR_KEY'></script>
<script src="https://cdn.jsdelivr.net/npm/three@0.143/build/three.js"></script>
<script src="https://cdn.jsdelivr.net/npm/three@0.143/examples/js/loaders/DRACOLoader.js"></script>
<script src="https://cdn.jsdelivr.net/npm/three@0.143/examples/js/loaders/GLTFLoader.js"></script>
<script src="https://cdn.jsdelivr.net/npm/@vuemap/three-layer/dist/index.js"></script>
<!--加载layer-3dtiles插件 -->
<script src="https://cdn.jsdelivr.net/npm/@vuemap/layer-3dtiles/dist/index.js"></script>
<script type="text/javascript">
  const map = new AMap.Map('app', {
      center: [116.405242513021,39.909402940539],
      zoom: 14,
      viewMode: '3D',
      pitch: 35
    })
  const layer = new AMap.ThreeLayer(map)
  layer.on('complete', () => {
      const light = new THREE.AmbientLight('#ffffff', 1);
      layer.add(light);
      const tiles = new AMap.Layer3DTiles(layer, {
        url: './hutong/tileset.json',
        position: [116.405242513021,39.909402940539]
      })
      tiles.setRotation({
        x:0,
        y:0,
        z:0
      })
      tiles.setTranslate({x:15,y:15,z:0})
      tiles.on('click',(e) => {
        console.log('click: ', e)  
      })
      console.log('layer: ', layer)
      console.log('tiles: ', tiles)
  })
</script>

npm方式

import {AmbientLight} from 'three'
import {ThreeLayer} from '@vuemap/three-layer'
import {Layer3DTiles} from '@vuemap/layer-3dtiles'
const map = new AMap.Map('app', {
  center: [120,31],
  zoom: 14,
  viewMode: '3D',
  pitch: 35
})
const layer = new ThreeLayer(map)
layer.on('complete', () => {
  const light = new AmbientLight('#ffffff', 1);
  layer.add(light);
  const tiles = new Layer3DTiles(layer, {
    url: './hutong/tileset.json',
    position: [116.405242513021,39.909402940539]
  })
  tiles.setRotation({
    x:0,
    y:0,
    z:0
  })
  tiles.setTranslate({x:15,y:15,z:0})
  tiles.on('click',(e) => {
    console.log('click: ', e)
  })
  console.log('layer: ', layer)
  console.log('tiles: ', tiles)
})

API文档说明

Layer3DTiles图层说明

3dtiles图层类,提供了3dtils加载和常用事件功能 new AMap.Layer3DTiles(layer: AMap.ThreeLayer, options: Layer3DTilesOptions)

参数说明

layer: ThreeLayer实例对象 options: Layer3DTiles初始化参数,参数内容如下:

属性名属性类型属性描述
urlString模型加载地址
positionnumber,number3dtiles加载的经纬度位置,0.0.7版本开始可以不用传,默认从3dtiles数据中读取
scaleNumber,{x:Number, y: Number, z: Number}设置缩放比例
rotation{x:Number, y: Number, z: Number}旋转模型
translate{x:Number, y: Number, z: Number}模型偏移设置
dracoDecoderPathStringDRACOLoader 的decoder路径,默认使用CDN路径,默认:https://cdn.jsdelivr.net/npm/three@0.143/examples/js/libs/draco/
fetchOptionsObject使用fetch下载文件的参数
mouseEventBoolean是否开启事件,默认false
debugBoolean是否开启debug,开启后将会在页面最顶部显示当前模型处理情况, 默认 false
autoFocusBoolean加载后是否自动将地图中心点移动到模型中心,仅在不传position时生效,0.0.7支持
configLoader(loader: GLTFLoader) => void配置loader,用于添加draco等扩展 ,0.0.7支持
成员函数
函数名入参返回值描述
setScaleNumber,{x:Number, y: Number, z: Number}设置缩放比例
setPositionNumber,Number设置模型位置
setRotation{x:Number, y: Number, z: Number}旋转模型
setTranslate{x:Number, y: Number, z: Number}模型偏移设置
getGroupGroup获取3dtiles的Group对象
getTilesRendererTilesRenderer获取3dtile渲染的对象,该对象为3d-tiles-renderer的对象,文档地址
refresh刷新图层
show显示模型
hide隐藏模型
destroy销毁模型
事件列表
事件名参数描述
loadTileSetTileSettileSet加载成功后触发
loadModel{scene, tile}加载模型后触发
disposeModel{scene, tile}销毁模型后触发
clicknull, {object: Object3D,batchData: Object}点击事件,可能会出现null值,object为点击的模型,batchData为模型所在的扩展数据,通过读取父节点获取
mousemovenull, {object: Object3D,batchData: Object}鼠标移动事件,可能会出现null值,object为滑动到的模型,batchData为模型所在的扩展数据,通过读取父节点获取
rightClicknull, {object: Object3D,batchData: Object}右击事件,可能会出现null值,object为点击的模型,batchData为模型所在的扩展数据,通过读取父节点获取