如何在Deck.GL中迁移Tile3DLayer的整体位置？

• 正确配置modelMatrix实现平移
  直接用Matrix4创建平移矩阵是最可靠的方式之一，注意要匹配地图的坐标单位（Web墨卡托下是米）。示例代码：

  import {Matrix4} from '@math.gl/core';
  import {Tile3DLayer} from '@deck.gl/geo-layers';
  
  // dx、dy、dz为X/Y/Z轴的平移量，单位米
  const translateMatrix = new Matrix4().translate([dx, dy, dz]);
  
  const tileLayer = new Tile3DLayer({
    // 其他必要配置（如data、loader等）
    modelMatrix: translateMatrix
  });
  

  如果瓦片基于经纬度（WGS84），可以先把经纬度偏移转换为米单位再传入，或者结合坐标系配置用经纬度直接偏移。

• 修正coordinateSystem与coordinateOrigin的配合
  当使用COORDINATE_SYSTEM.LNGLAT_OFFSETS时，必须同时设置coordinateOrigin为瓦片的原始中心经纬度，再通过偏移调整位置。此时偏移量单位是经纬度度数：

  const tileLayer = new Tile3DLayer({
    coordinateSystem: COORDINATE_SYSTEM.LNGLAT_OFFSETS,
    coordinateOrigin: [originalLng, originalLat, 0], // 瓦片原始中心的经纬度
    modelMatrix: new Matrix4().translate([deltaLng, deltaLat, 0]) // 目标经纬度偏移量
  });
  

• 确保tileset.json的transform字段格式正确
  很多人会写错字段名，正确的根节点字段是transform而非transformMatrix，矩阵采用glTF列主序格式。比如要让瓦片沿X/Y轴各平移100米，配置如下：

  {
    "asset": {"version": "1.0", "generator": "xxx"},
    "transform": [1,0,0,0, 0,1,0,0, 0,0,1,0, 100,100,0,1],
    "geometricError": 1000,
    "root": {...}
  }
  

  修改后要确保加载的是更新后的tileset.json文件（本地加载或刷新服务端缓存）。

• 检查瓦片与地图的坐标基准匹配性
  如果瓦片坐标系是WGS84（经纬度），而地图用Web墨卡托（EPSG:3857），需显式指定tileCoordinateSystem：

  const tileLayer = new Tile3DLayer({
    tileCoordinateSystem: COORDINATE_SYSTEM.LNGLAT,
    modelMatrix: new Matrix4().translate([dx, dy, dz]) // 这里dx/dy是转换后的米单位偏移
  });
  

• 调试验证矩阵是否生效
  在onTileLoad回调中打印瓦片的modelMatrix，确认配置是否被正确应用：

  const tileLayer = new Tile3DLayer({
    onTileLoad: (tile) => {
      console.log('当前瓦片modelMatrix:', tile.modelMatrix);
    }
  });
  

  如果矩阵值正确但位置未变，可能是瓦片自身已包含固定偏移，需要先重置矩阵再添加平移。

内容的提问来源于stack exchange，提问作者Demi God