跳到主要内容
SqsMap地图与空间数据工具

瓦片URL模板

共同瓦片源的quadkey、范围框、分片前缀与高分屏地址

共同vector、raster和raster-dem图源支持以下地址占位，TileJSON相对地址与URL样式底图使用同一展开规则：

占位含义
z、x、y当前canonical瓦片坐标；scheme为tms时仅y翻转
-y保留的显式翻转y扩展
prefixcanonical x和y低四位的两位十六进制前缀
quadkeycanonical XYZ生成的四叉树键，0级为空字符串
bbox-epsg-3857canonical瓦片的西、南、东、北墨卡托米坐标
ratio实际像素比大于1时为@2x，否则为空
const caps = await map.sqs.getCapabilities();
if (caps.commonTileUrlTemplates) {
  map.addSource('imagery', {
    type: 'raster',
    tiles: ['https://tiles.example/{quadkey}{ratio}.png'],
    maxzoom: 18
  });
}

以上表格名称在地址中须包入花括号，代码示例只是地址形式，需使用自己的可用数据服务。地址可以仅使用quadkey或bbox，不要求同时出现z/x/y；固定地址也允许。镜像按canonical x+y稳定选择。世界副本和过缩放沿用canonical坐标；TMS不改变quadkey、prefix和bbox的含义。范围框数值遵循EPSG:3857，不是经纬度。未知占位、非法协议、凭据、控制字符及展开后的超长地址会失败，保留此前有效数据与状态。

DPR1.25和2都选择高分屏地址。仅含ratio的共同图源在跨越1时取消旧请求、清除该源旧密度解码和补位，再调度新地址；源实例与元数据身份保留，迟到回复不能覆盖新画面。没有ratio时保留原缓存。独立URL底图使用既有会话generation，跨档时保守刷新会话瓦片与几何，保留样式/图片/字形；这个档位不取决于sprite密度阈值或sprite下载回退。

能力名commonTileUrlTemplates仅表示此模板族。完整URL图源元数据参数、MLT、设备/外机、移动GIS/iOS及正式发布继续待办。公共脚本与本机验证页使用仓库受控等待服务；验证记录按实际匹配结果追加。核心16498121bf45c5253114b36ff7d3e65da899a195。

当前瓦片模板开发交付：核心16498121bf45c5253114b36ff7d3e65da899a195、SDK 0.3.0-dev.16498121。同一130项/9画面在Native、主线程、Worker各DPR1/2通过，共54真实帧；三类图源实际39条资源轨迹一致，四网页各111次调用且错误0。官方30输入/90world-copy比较、共同源/独立URL底图CPU、实际软件Vulkan、工作区与七crate wasm边界、元数据四项和DEM综合回归通过。应用102项/数据49项、locked check及Native/核心与应用WASM/Android API24 ARM64/JNI匹配；233项脚本契约WASM字节保留。归档 SqsMap-SDK-0.3.0-dev.16498121-tile-url-templates.tar.gz：642清单文件加bundle.json、38267917字节，SHA256 178588aaf79866bd387cd9dbef978c0d45015b69bc6f3e38f247c763144d8332，独立只读校验器逐成员通过。原固定74/MVT/DEM包字节不变。双语生产HTTP和四仓同步单独记录；完整源参数/MLT、设备/外机、移动GIS/iOS与正式发行仍未完成。

有效瓦片元数据说明当前显式覆盖、实际尺寸/DEM编码，以及刷新等待和失败的数据保留；本文早期证明不重标版本。