WMTS源转XYZ Layer语法遇问题，寻求技术协助

核心对应关系（EPSG:3857场景） #

WMTS转XYZ的关键是参数映射与坐标转换，EPSG:3857的TileMatrixSet与XYZ层级完全匹配，但需注意行号计数方向差异：

• WMTS的{TileMatrix} → XYZ的{z}（层级编号通常完全一致，如0-19）
• WMTS的{TileCol} → XYZ的{x}（列号逻辑一致）
• WMTS的{TileRow} → XYZ的y需反转：y = (2^z) - 1 - WMTS_TileRow（WMTS从顶部开始计数，XYZ从底部开始）

通用排查要点（针对可行/不可行示例差异） #

• 变量替换错误：检查是否严格将WMTS模板中的{TileMatrix}替换为{z}、{TileCol}替换为{x}，且{TileRow}是否做了反转处理（若未反转，会出现图层上下颠倒或加载失败）
• 固定参数遗漏：WMTS的layer、style、tilematrixset、format等固定参数必须保留在XYZ URL中，比如XML中<ResourceURL>的模板包含layer=RoadMap，XYZ URL不能遗漏该参数
• 层级范围不匹配：确认WMTS TileMatrixSet的最小/最大层级（XML中<TileMatrix>的Identifier范围），与Leaflet/QGIS中XYZ图层设置的minZoom/maxZoom一致，超出范围的层级会返回404
• 参数大小写敏感：部分WMTS服务器对参数名大小写严格要求，比如TileMatrix不能写成tilematrix，需完全匹配XML中的参数命名
• 格式参数错误：XML中指定的format（如image/png、image/jpeg）必须与XYZ URL中的参数一致，错误格式会导致服务器返回无效响应

Leaflet实现示例 #

// 无需反转y的场景（部分WMTS已适配XYZ行号逻辑）
const wmtsXyzLayer = L.tileLayer('http://your-wmts-server.com/wmts?layer=YourLayer&style=default&tilematrixset=EPSG:3857&TileMatrix={z}&TileCol={x}&TileRow={y}&format=image/png', {
  minZoom: 0,
  maxZoom: 18,
  tileSize: 256,
  attribution: '© 数据源所有者'
}).addTo(map);

// 需要反转y的场景
const wmtsXyzReversedLayer = L.tileLayer('', {
  minZoom: 0,
  maxZoom: 18,
  tileSize: 256,
  attribution: '© 数据源所有者',
  tileUrlFunction: (coords) => {
    const z = coords.z;
    const x = coords.x;
    const y = Math.pow(2, z) - 1 - coords.y;
    return `http://your-wmts-server.com/wmts?layer=YourLayer&style=default&tilematrixset=EPSG:3857&TileMatrix=${z}&TileCol=${x}&TileRow=${y}&format=image/png`;
  }
}).addTo(map);

QGIS加载注意事项 #

1. 添加“XYZ Tiles”数据源，粘贴转换后的URL
2. 确认图层CRS设置为EPSG:3857
3. 若加载失败，查看QGIS「日志面板」的网络请求错误码（如404、403），对应排查URL参数是否正确

内容的提问来源于stack exchange，提问作者John Salzbrunn