共同影像瓦片图层

vector/raster支持共同登记、TileJSON、setTiles/setUrl及元数据生命周期。raster现在可以由标准addLayer显示，同一源可供多个图层使用，沿用共同图层顺序、显隐和raster-opacity。平面、倾斜和球面使用相同的解码瓦片，核心自行实现绘制。

import {map} from 'sqsmap';
map.addSource('imagery', {type:'raster',tiles:['https://your-server.example/{z}/{x}/{y}.png'],tileSize:256,attribution:'Your provider'});
map.addLayer({id:'imagery-layer',type:'raster',source:'imagery',paint:{'raster-opacity':0.8}});
await map.sqs.flush({render:true});
const source = await map.getSource('imagery');
console.log(await source.sqs.getTileMetadata());
console.log((await map.sqs.getSourceInfo('imagery')).tileState);
await source.setTiles(['https://your-server.example/new/{z}/{x}/{y}.png']);
map.removeLayer('imagery-layer');map.removeSource('imagery');
await map.sqs.flush();

配置只能选择url或tiles其一；模板要求无凭据的绝对HTTP(S)地址、z/x/y，1–8个地址、每个4096字节，源配置64KiB。scheme:tms解析为负向y；minzoom/maxzoom整数0–24，bounds支持日期变更线，tileSize为256或512。TileJSON使用现有Source资源策略，响应1MiB；相对模板按其地址解析，显式级别/bounds/scheme覆盖下载值。

视图驱动raster请求，每图最多64个可见瓦片、32个待处理请求、64MiB解码像素；每张响应4MiB，PNG/JPEG/WebP，宽高上限1024。规范坐标共享下载和像素，世界重复使用同一缓存。隐藏/移除图层、移动视图、更新源、替换样式或销毁时取消不再需要的请求，迟到响应无法覆盖新一代。已有像素在更新失败时保留；未就绪的区域暂时为空。尚未接通父子瓦片补位、共同源的渐变及其余raster属性。

SourceInfo.tileMetadata描述配置，tileState描述visibleTiles/readyTiles/pendingTiles/cachedTiles/byteLength。没有显示依赖时loaded表示元数据已就绪；有可见raster依赖时，要当前视图全部瓦片就绪才loaded。metadataLoaded仅证明曾有可用元数据，hasData不能作为画面验收依据。事件sourceDataType区分metadata与content。setUrl失败保留之前配置并公开loadError；setTiles可恢复。getStyle返回最新配置，getTileMetadata返回成功解析的元数据。

能力tiledSourceMetadata、tiledSourceRendering、rasterTileSourceRendering为true；vectorTileSourceStore也为true（circle/line/fill与查询子集）。vector已接通共同circle/line/fill和查询，详见共同MVT；现有setStyle(URL)矢量底图继续可用。DEM、MLT、promoteId、volatile、完整瓦片类型/状态和移动宿主仍待接通。GeoJSON与聚合接口不适用于瓦片源。C ABI仍使用原有JSON/资源入口。

完整HTML示例包含全部按钮、事件、来源声明与销毁逻辑；共同脚本用于原生、网页主线程和严格Worker验收。示例双色瓦片由本站生成；接入真实影像时必须替换模板并按提供方要求展示版权来源。

MVT要素状态已由07.9接通，详见要素状态。

普通raster父级裁剪补位已在07.13接通；fallbackTiles不冒充精确readyTiles/loaded。参见父级补位。DEM/promoteId/volatile及MVT要素状态已在后续阶段接通，以上早期范围以各专项指南为准。

共同瓦片URL模板补充quadkey、bbox、prefix、ratio及实际密度切换；本文原批次证明保留，完整图源参数仍另列待办。

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