配套网页 SDK
从 npm 安装正式包请先阅读网页 SDK 接入起步。本页说明官网使用的开发快照分发方式。
官网示例、网页工作台与完整 HTML 示例使用相同开发 SDK。包版本 0.3.0-dev.65d76a28 对应核心 65d76a28454ec82456e27245099bab86832a2b7d。正式 npm 与动态库发行另行验收。
完整代码选项卡包含 HTML、CSS、事件处理与脚本，保存后通过 HTTP 服务打开。JS、Worker 与 WASM 应保持同版本。构建成功不代表线上已经更新；本地验收请改用预览地址。共同circle/line/fill支持二维、倾斜和球面，其它三维类型按各自指南的能力范围使用；共同地球仪 API已接通网页、桌面和独立动态库的投影切换与即时球面相机；已支持共同图层可随投影切换，未实现组合明确拒绝。
<!doctype html>
<html><meta charset="utf-8"><style>html,body,#map{margin:0;width:100%;height:100%}</style>
<div id="map"></div><script type="module">
import { MapView } from 'https://www.sqsmap.com/sdk/sqsmap-core/dist/index.js';
const map = await MapView.create(document.querySelector('#map'), {locale:'auto', worker:false});
map.jumpTo({center:[105,25],zoom:4});
map.addSource('places',{type:'geojson',data:{type:'Feature',id:1,properties:{name:'Example'},geometry:{type:'Point',coordinates:[105,25]}}});
map.addLayer({id:'places',type:'circle',source:'places',paint:{'circle-radius':10,'circle-color':'#2563eb'}});
await map.flush({render:true});
addEventListener('pagehide',()=>map.destroy(),{once:true});
</script></html>
Runtime checksums · Snapshot · License · Third-party notices · Types
类型的相对依赖须一并保存；地图与样式来源的版权要求独立适用。worker:true 默认允许回退，需要严格 Worker 时指定 createWorker 并检查 map.offscreen。
源码快照位于 packages/map-core；构建钩子先校验全部 SHA-256，再生成独立 ESM、Worker、声明和 WASM。生成目录不提交，源码及匹配 WASM 提交，构建无需相邻核心仓库。更新工具 tools/sdk-runtime/capture.mjs 只读取已提交核心，核对干净构建目录的 Rust 输入，不匹配时拒绝生成。
脚本控制台使用独立网页脚本宿主，包含运行器、脚本 Worker、契约 WASM 和完整 HTML 示例。独立 HTML 可直接使用 SDK，也可接入该脚本宿主。完整原生发行与移动宿主验收仍按分发任务单独记录。
共同光照、太阳扩展与历史事件使用相同脚本形状；各平台的三维图层支持仍以能力查询为准。
Android原生脚本宿主提供Java/JNI源码；手机设备与正式包验收另行记录。
共同高程瓦片与山体阴影提供自研PNG解码与basic/map光照；完整HTML包含全部按钮事件。
高程分层设色：渐变/阶梯色带、CSS颜色和完整HTML事件。
共同地形表面与高程查询：真实DEM网格、标准地形配置和跨端返回差异。