跳到主要内容

MapLibre 风格与开发者索引

版本化规范接口、迁移约定及LLM可读输入。

编写脚本或让LLM生成代码时,优先使用下列规范名称。索引描述实际已接通的子集,不表示完整MapLibre兼容;读操作用await,未实现参数明确拒绝。移动脚本宿主尚未接通,Windows/macOS和设备验收单独记录。

对应快照: 0.3.0-dev.65d76a28, core 65d76a28454ec82456e27245099bab86832a2b7d, ABI 1, script 0.5-session. 当前快照包含 385 SDK / 41 C / 233 脚本登记条目。

开发者/LLM机器索引 · SDK/TS · C ABI · 共同脚本声明

首选写法状态范围与指南
jumpTo, easeTo, flyTo, fitBounds, project, unproject已接通子集相机操作由共享核心计算;读操作用await,动画/投影的已实现参数和边界见指南。
setProjection, getProjection, setPitch, resetNorth, resetNorthPitch已接通子集俯视/倾斜、地球投影及地形是不同状态;2D/3D工具由使用方调用公开操作。
addSource, getSource, removeSource已接通子集共同GeoJSON、image/video/canvas、raster瓦片及vector MVT circle/line/fill/点symbol/平面透视fill-extrusion和source-layer查询已接通;DEM、完整矢量类型仍待实施。
getSource(id).setData, getSource(id).updateData已接通子集setData/updateData采用MapLibre结构;稳定身份、更新与HTTP加载代次、事件和预算属于SqsMap明确契约。
addLayer, getLayer, moveLayer, removeLayer, setPaintProperty, setLayoutProperty, setFilter, setLayerZoomRange已接通子集共同业务图层清单与底图内部样式层不同;具体图层/paint/layout/表达式子集见各指南,未实现参数明确拒绝。
queryRenderedFeatures, querySourceFeatures, getFeatureState, setFeatureState, removeFeatureState已接通子集读取使用await;共同GeoJSON/MVT source-layer查询与独立要素状态已接通,实际图层/源身份及预算明确,不静默截断。
setStyle, getStyle已接通子集样式采用version8结构;differences、加载/错误与可编辑子集见指南,完整Style Spec仍在实施。
loadImage, addImage, updateImage, removeImage, getImage, hasImage已接通子集图标使用可复制RGBA与像素密度;不返回跨端DOM对象,受图标和atlas预算限制。
getSource(id).setCoordinates, getSource(id).updateImage已接通子集image URL与updateImage的新像素/可选四角原子提交;与同名图标updateImage按参数/源类型区分。
addSource(id,{type:"video",urls,coordinates}), getSource(id).play, getSource(id).pause已接通子集共享普通MP4/H.264解码器、地图时钟与循环;DOM getVideo、其它格式/音频不属于当前承诺。
on, off, once已接通子集标准相机/图源/样式/生命周期与指针事件按实际目录实现;保留异步确认与不可变历史快照,C宿主自行轮询。
dragPan, scrollZoom, doubleClickZoom, keyboard已接通子集公开手势状态/开关与输入计划由宿主接入;触屏、移动宿主及外机覆盖以验收记录为准。
sqs.scaleAt已接通子集SqsMap扩展:共享局部二维比例尺;网页SDK用scaleAt,脚本用sqs.scaleAt,球面明确不可用;已接通倾斜地面交点处的局部导数。
sqs.flush已接通子集SqsMap扩展:区分应用水位、新帧、资源就绪与idle;跨计数域不能互换since。
sqs.getLayers, sqs.getLayerMetadata, sqs.setLayerMetadata已接通子集SqsMap扩展:只提供状态/操作/事件;图层面板、工具栏及清理由使用方编写,SDK方法与脚本门面明确列出。
sqs.getAttributions已接通子集归属状态与变更事件供自定义UI使用;实际数据服务的署名由使用方展示。
CanvasSource已接通子集命名Canvas共享RGBA帧与播放状态已接通;网页SDK可自动捕获2D画布。DOM仅属于浏览器,地形贴附与自定义渲染仍待实现。
CustomLayerInterface待实现自定义后端扩展与地形媒体继续实施;第三方GL插件不自动适用于SqsMap后端。

入口与迁移

共同脚本从sqsmap导入map,使用宿主已有地图;独立SDK由MapView.create异步建图并自行制作UI。C调用者使用匹配头文件与JSON方法信封,查询能力、轮询事件/资源并释放独立输出;原生JavaScript需要可选QuickJS构建。

旧gis/Operation/ChangePlan及SDK旧别名保留兼容,新共同地图脚本以规范名称为首选。SqsMap扩展优先置于sqs并在上表说明。参数单位、预算、错误及宿主差异以链接指南为准;接口登记或规划类型不能替代设备支持证据。

完整自定义图层面板和工具 · 可运行脚本宿主 · 独立C宿主