{ "apis": [ { "name": "layers", "native": "host.layer-list", "parameters": { "items": false, "maxItems": 0, "minItems": 0, "prefixItems": [], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile" ], "return_type": "Operation", "returns": "Layer[]", "summary": "列出当前矢量显示并取得本次任务的引用" }, { "name": "metrics", "native": "host.layer-metrics", "parameters": { "items": false, "maxItems": 2, "minItems": 1, "prefixItems": [ { "format": "uuid", "type": "string" }, { "default": false, "type": "boolean" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile" ], "return_type": "Operation", "returns": "string", "summary": "复用当前图层的面积、长度及数量统计" }, { "name": "fields", "native": "host.layer-fields", "parameters": { "items": false, "maxItems": 1, "minItems": 1, "prefixItems": [ { "format": "uuid", "type": "string" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile" ], "return_type": "Operation", "returns": "Field[]", "summary": "读取真实字段及已有业务名称；未知名称不推测" }, { "name": "codes", "native": "host.layer-codes", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "uuid", "type": "string" }, { "maxLength": 128, "minLength": 1, "type": "string" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile" ], "return_type": "Operation", "returns": "CodeSamples", "summary": "读取最多20行中的代码样本及已知字典含义，不代表完整代码表" }, { "name": "exportGeoJSON", "native": "host.geojson-export", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "uuid", "type": "string" }, { "maxLength": 128, "minLength": 1, "type": "string" } ], "type": "array" }, "permission": "export.write", "platforms": [ "desktop", "mobile" ], "return_type": "Operation", "returns": "ChangePlan", "summary": "为新文件预演导出，需宿主确认" }, { "name": "map.sources.cluster", "native": "host.dynamic", "parameters": { "items": false, "maxItems": 4, "minItems": 4, "prefixItems": [ { "maxLength": 128, "minLength": 1, "type": "string" }, { "format": "uuid", "tsType": "SourceRef", "type": "string" }, { "additionalProperties": false, "properties": { "aggregates": { "additionalProperties": { "properties": { "op": { "enum": [ "sum", "min", "max" ] }, "value": { "anyOf": [ { "type": "number" }, { "type": "array" } ] } }, "required": [ "op", "value" ], "type": "object" }, "type": "object" }, "maxZoom": { "maximum": 23, "type": "integer" }, "minPoints": { "maximum": 4096, "minimum": 2, "type": "integer" }, "radiusPx": { "exclusiveMinimum": 0, "maximum": 256, "type": "number" }, "where": { "anyOf": [ { "type": "boolean" }, { "type": "array" } ] } }, "tsType": "ClusterOptions", "type": "object" }, { "additionalProperties": false, "properties": { "owner": { "format": "uuid", "type": "string" } }, "required": [ "owner" ], "tsType": "SceneOwnerOptions", "type": "object" } ], "type": "array" }, "permission": "map.write", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "SourceRef", "summary": "从点源后台建立稳定的分层聚合，统计在筛选后执行" }, { "name": "map.sources.createTransient", "native": "host.dynamic", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "additionalProperties": false, "properties": { "crs": { "enum": [ "EPSG:4326" ] }, "fields": { "additionalProperties": { "enum": [ "string", "number", "boolean" ] }, "type": "object" }, "geometryType": { "enum": [ "point" ] }, "id": { "maxLength": 128, "minLength": 1, "type": "string" } }, "required": [ "id", "geometryType", "crs", "fields" ], "tsType": "TransientSourceOptions", "type": "object" }, { "additionalProperties": false, "properties": { "owner": { "format": "uuid", "type": "string" } }, "required": [ "owner" ], "tsType": "SceneOwnerOptions", "type": "object" } ], "type": "array" }, "permission": "map.write", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "SourceRef", "summary": "创建场景持有的只读实时点源，原始文件不变" }, { "name": "map.clusters.leaves", "native": "host.dynamic", "parameters": { "items": false, "maxItems": 2, "minItems": 1, "prefixItems": [ { "format": "uuid", "tsType": "ClusterRef", "type": "string" }, { "additionalProperties": false, "default": {}, "properties": { "cursor": { "format": "uuid", "type": "string" }, "limit": { "default": 20, "maximum": 100, "minimum": 1, "type": "integer" } }, "tsType": "PageOptions", "type": "object" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation>", "returns": "Page", "summary": "分页查看当前聚合的原始成员，旧层级或版本引用失效" }, { "name": "map.clusters.expansionZoom", "native": "host.dynamic", "parameters": { "items": false, "maxItems": 1, "minItems": 1, "prefixItems": [ { "format": "uuid", "tsType": "ClusterRef", "type": "string" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "number | null", "summary": "查询聚合首次拆分的缩放层级" }, { "name": "map.clusters.expand", "native": "host.dynamic", "parameters": { "items": false, "maxItems": 2, "minItems": 1, "prefixItems": [ { "format": "uuid", "tsType": "ClusterRef", "type": "string" }, { "additionalProperties": false, "default": {}, "properties": { "durationMs": { "maximum": 60000, "minimum": 0, "type": "integer" } }, "tsType": "{durationMs?:number}", "type": "object" } ], "type": "array" }, "permission": "map.write", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "void", "summary": "平滑定位并展开当前聚合" }, { "name": "live.connect", "native": "host.dynamic", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "additionalProperties": false, "properties": { "credential": { "format": "uuid", "type": "string" }, "protocol": { "enum": [ "gis-live-v1" ] }, "source": { "format": "uuid", "type": "string" }, "transport": { "additionalProperties": false, "properties": { "intervalMs": { "maximum": 60000, "minimum": 500, "type": "integer" }, "type": { "enum": [ "http-poll", "websocket" ] }, "url": { "maxLength": 4096, "minLength": 1, "type": "string" } }, "required": [ "type", "url" ], "type": "object" } }, "required": [ "source", "protocol", "transport" ], "tsType": "LiveConnectOptions", "type": "object" }, { "additionalProperties": false, "properties": { "owner": { "format": "uuid", "type": "string" } }, "required": [ "owner" ], "tsType": "SceneOwnerOptions", "type": "object" } ], "type": "array" }, "permission": "scene.run", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "LiveFeedRef", "summary": "注册持续采集器，随场景启停，快照原子替换" }, { "name": "live.info", "native": "host.dynamic", "parameters": { "items": false, "maxItems": 1, "minItems": 1, "prefixItems": [ { "format": "uuid", "tsType": "LiveFeedRef", "type": "string" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "LiveFeedInfo", "summary": "读取采集状态、新鲜度、版本与有界队列统计" }, { "name": "live.snapshot", "native": "host.dynamic", "parameters": { "items": false, "maxItems": 1, "minItems": 1, "prefixItems": [ { "format": "uuid", "tsType": "SourceRef", "type": "string" } ], "type": "array" }, "permission": "analysis.execute", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "DatasetRef", "summary": "冻结实时源的已显示批次，得到可分析和导出的不可变成果" }, { "name": "map.images.pulse", "native": "host.scene", "parameters": { "items": false, "maxItems": 3, "minItems": 3, "prefixItems": [ { "maxLength": 128, "minLength": 1, "type": "string" }, { "additionalProperties": false, "properties": { "color": { "type": "string" }, "outerRadiusPx": { "exclusiveMinimum": 0, "maximum": 128, "type": "number" }, "periodMs": { "maximum": 60000, "minimum": 1, "type": "number" }, "radiusPx": { "maximum": 128, "minimum": 0, "type": "number" } }, "required": [ "color" ], "tsType": "PulseImageOptions", "type": "object" }, { "additionalProperties": false, "properties": { "owner": { "format": "uuid", "type": "string" } }, "required": [ "owner" ], "tsType": "SceneOwnerOptions", "type": "object" } ], "type": "array" }, "permission": "map.write", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "ImageRef", "summary": "准备原生脉冲图像，场景运行时由宿主时钟驱动" }, { "name": "map.images.sprite", "native": "host.scene", "parameters": { "items": false, "maxItems": 3, "minItems": 3, "prefixItems": [ { "maxLength": 128, "minLength": 1, "type": "string" }, { "additionalProperties": false, "properties": { "fps": { "exclusiveMinimum": 0, "maximum": 60, "type": "number" }, "frameCount": { "maximum": 256, "minimum": 1, "type": "integer" }, "frameHeight": { "maximum": 4096, "minimum": 1, "type": "integer" }, "frameWidth": { "maximum": 4096, "minimum": 1, "type": "integer" }, "path": { "type": "string" }, "pixelRatio": { "maximum": 16, "minimum": 0.125, "type": "number" } }, "required": [ "path", "frameWidth", "frameHeight", "frameCount" ], "tsType": "SpriteImageOptions", "type": "object" }, { "additionalProperties": false, "properties": { "owner": { "format": "uuid", "type": "string" } }, "required": [ "owner" ], "tsType": "SceneOwnerOptions", "type": "object" } ], "type": "array" }, "permission": "map.write", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "ImageRef", "summary": "后台读取本地静态 PNG/WebP 图集，播放时仅更新帧号" }, { "name": "map.images.get", "native": "host.scene", "parameters": { "items": false, "maxItems": 1, "minItems": 1, "prefixItems": [ { "maxLength": 128, "minLength": 1, "type": "string" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "ImageRef | null", "summary": "按标识取得已注册图像" }, { "name": "map.images.info", "native": "host.scene", "parameters": { "items": false, "maxItems": 1, "minItems": 1, "prefixItems": [ { "format": "uuid", "tsType": "ImageRef", "type": "string" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "ImageInfo", "summary": "查看图像类型、逻辑尺寸和帧数" }, { "name": "map.images.remove", "native": "host.scene", "parameters": { "items": false, "maxItems": 1, "minItems": 1, "prefixItems": [ { "format": "uuid", "tsType": "ImageRef", "type": "string" } ], "type": "array" }, "permission": "map.write", "platforms": [ "desktop", "mobile", "web" ], "return_type": "ChangePlan", "returns": "ChangePlan", "summary": "预演移除无符号依赖的图像" }, { "name": "map.animations.route", "native": "host.scene", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "additionalProperties": false, "properties": { "loop": { "type": "boolean" }, "marker": { "type": "object" }, "route": { "format": "uuid", "type": "string" }, "timing": { "type": "object" } }, "required": [ "route", "timing", "marker" ], "tsType": "RoutePlaybackOptions", "type": "object" }, { "additionalProperties": false, "properties": { "owner": { "format": "uuid", "type": "string" } }, "required": [ "owner" ], "tsType": "SceneOwnerOptions", "type": "object" } ], "type": "array" }, "permission": "map.write", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "PlaybackRef", "summary": "准备单条路线快照，按距离或逐顶点时间移动标记；源变化停止" }, { "name": "map.animations.line", "native": "host.scene", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "additionalProperties": false, "properties": { "cap": { "enum": [ "butt", "round" ] }, "effects": { "description": "最多组合六类效果；类型和可选标识不可重复。", "items": { "anyOf": [ { "additionalProperties": false, "properties": { "fade": { "enum": [ "linear", "none" ] }, "id": { "maxLength": 64, "minLength": 1, "type": "string" }, "phase": { "maximum": 1000000, "minimum": -1000000, "type": "number" }, "spacing": { "exclusiveMinimum": 0, "maximum": 1000000, "type": "number" }, "trailLength": { "exclusiveMinimum": 0, "maximum": 1000000, "type": "number" }, "type": { "enum": [ "flow" ] }, "unit": { "enum": [ "progress", "pixels" ] } }, "required": [ "type" ], "type": "object" }, { "additionalProperties": false, "properties": { "gap": { "exclusiveMinimum": 0, "maximum": 1000000, "type": "number" }, "id": { "maxLength": 64, "minLength": 1, "type": "string" }, "on": { "exclusiveMinimum": 0, "maximum": 1000000, "type": "number" }, "type": { "enum": [ "dash" ] }, "unit": { "enum": [ "progress", "pixels" ] } }, "required": [ "type", "on", "gap" ], "type": "object" }, { "additionalProperties": false, "properties": { "end": { "maximum": 1, "minimum": 0, "type": "number" }, "id": { "maxLength": 64, "minLength": 1, "type": "string" }, "start": { "maximum": 1, "minimum": 0, "type": "number" }, "type": { "enum": [ "reveal" ] } }, "required": [ "type" ], "type": "object" }, { "additionalProperties": false, "properties": { "id": { "maxLength": 64, "minLength": 1, "type": "string" }, "length": { "exclusiveMinimum": 0, "maximum": 1000000, "type": "number" }, "spacing": { "exclusiveMinimum": 0, "maximum": 1000000, "type": "number" }, "type": { "enum": [ "arrows" ] }, "unit": { "enum": [ "progress", "pixels" ] } }, "required": [ "type" ], "type": "object" }, { "additionalProperties": false, "properties": { "id": { "maxLength": 64, "minLength": 1, "type": "string" }, "intensity": { "maximum": 1, "minimum": 0, "type": "number" }, "radius": { "maximum": 64, "minimum": 0, "type": "number" }, "type": { "enum": [ "glow" ] } }, "required": [ "type" ], "type": "object" }, { "additionalProperties": false, "properties": { "id": { "maxLength": 64, "minLength": 1, "type": "string" }, "path": { "maxLength": 4096, "minLength": 1, "type": "string" }, "spacing": { "exclusiveMinimum": 0, "maximum": 1000000, "type": "number" }, "type": { "enum": [ "pattern" ] }, "unit": { "enum": [ "progress", "pixels" ] } }, "required": [ "type", "path" ], "type": "object" } ] }, "maxItems": 6, "minItems": 1, "type": "array" }, "layer": { "format": "uuid", "tsType": "MapLayerRef", "type": "string" }, "phaseField": { "maxLength": 128, "minLength": 1, "type": "string" }, "speedField": { "maxLength": 128, "minLength": 1, "type": "string" }, "stagger": { "type": "boolean" }, "timing": { "additionalProperties": false, "properties": { "delayMs": { "maximum": 86400000, "minimum": 0, "type": "number" }, "direction": { "enum": [ "forward", "reverse", "alternate" ] }, "durationMs": { "maximum": 86400000, "minimum": 1, "type": "number" }, "easing": { "enum": [ "linear", "ease-in-out" ] }, "fill": { "enum": [ "forwards", "none" ] }, "loop": { "type": "boolean" } }, "required": [ "durationMs" ], "type": "object" }, "tracks": { "additionalProperties": false, "properties": { "color": { "description": "进度从 0 到 1 严格递增并包含首尾；颜色按 RGBA 乘法调制底色，白色保持不变。", "items": { "additionalProperties": false, "properties": { "offset": { "maximum": 1, "minimum": 0, "type": "number" }, "value": { "maxLength": 9, "minLength": 7, "pattern": "^#[0-9a-fA-F]{6}([0-9a-fA-F]{2})?$", "type": "string" } }, "required": [ "offset", "value" ], "type": "object" }, "maxItems": 32, "minItems": 2, "type": "array" }, "opacity": { "description": "进度须从 0 到 1 严格递增，并包含首尾。", "items": { "additionalProperties": false, "properties": { "offset": { "maximum": 1, "minimum": 0, "type": "number" }, "value": { "maximum": 1.0, "minimum": 0, "type": "number" } }, "required": [ "offset", "value" ], "type": "object" }, "maxItems": 32, "minItems": 2, "type": "array" }, "widthScale": { "description": "进度须从 0 到 1 严格递增，并包含首尾。", "items": { "additionalProperties": false, "properties": { "offset": { "maximum": 1, "minimum": 0, "type": "number" }, "value": { "maximum": 8.0, "minimum": 0, "type": "number" } }, "required": [ "offset", "value" ], "type": "object" }, "maxItems": 32, "minItems": 2, "type": "array" } }, "type": "object" } }, "required": [ "layer", "timing", "effects" ], "tsType": "LinePlaybackOptions", "type": "object" }, { "additionalProperties": false, "properties": { "owner": { "format": "uuid", "type": "string" } }, "required": [ "owner" ], "tsType": "SceneOwnerOptions", "type": "object" } ], "type": "array" }, "permission": "map.write", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "PlaybackRef", "summary": "为同场景线图层准备流动拖尾、虚线、逐步显示、箭头、光晕和本地图案，可组合透明度和宽度变化；源变化停止" }, { "name": "map.camera.easeTo", "native": "host.scene", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "additionalProperties": false, "properties": { "center": {}, "durationMs": { "maximum": 60000, "minimum": 0, "type": "number" }, "easing": { "enum": [ "linear", "ease-in-out" ] }, "resolution": { "exclusiveMinimum": 0, "type": "number" }, "zoom": { "maximum": 24, "minimum": 0, "type": "number" } }, "required": [ "center" ], "tsType": "CameraMotionOptions", "type": "object" }, { "additionalProperties": false, "properties": { "owner": { "format": "uuid", "type": "string" } }, "required": [ "owner" ], "tsType": "SceneOwnerOptions", "type": "object" } ], "type": "array" }, "permission": "map.write", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "PlaybackRef", "summary": "准备二维相机运动，由场景开始后接管；用户定位可打断" }, { "name": "map.camera.flyTo", "native": "host.scene", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "additionalProperties": false, "properties": { "center": {}, "durationMs": { "maximum": 60000, "minimum": 0, "type": "number" }, "easing": { "enum": [ "linear", "ease-in-out" ] }, "resolution": { "exclusiveMinimum": 0, "type": "number" }, "zoom": { "maximum": 24, "minimum": 0, "type": "number" } }, "required": [ "center" ], "tsType": "CameraMotionOptions", "type": "object" }, { "additionalProperties": false, "properties": { "owner": { "format": "uuid", "type": "string" } }, "required": [ "owner" ], "tsType": "SceneOwnerOptions", "type": "object" } ], "type": "array" }, "permission": "map.write", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "PlaybackRef", "summary": "准备二维相机运动，由场景开始后接管；用户定位可打断" }, { "name": "map.playbacks.play", "native": "host.scene", "parameters": { "items": false, "maxItems": 1, "minItems": 1, "prefixItems": [ { "format": "uuid", "tsType": "PlaybackRef", "type": "string" } ], "type": "array" }, "permission": "scene.run", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "void", "summary": "控制或查看宿主播放；finished 等待当前轮完成，停止或替换会取消" }, { "name": "map.playbacks.pause", "native": "host.scene", "parameters": { "items": false, "maxItems": 1, "minItems": 1, "prefixItems": [ { "format": "uuid", "tsType": "PlaybackRef", "type": "string" } ], "type": "array" }, "permission": "map.write", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "void", "summary": "控制或查看宿主播放；finished 等待当前轮完成，停止或替换会取消" }, { "name": "map.playbacks.stop", "native": "host.scene", "parameters": { "items": false, "maxItems": 1, "minItems": 1, "prefixItems": [ { "format": "uuid", "tsType": "PlaybackRef", "type": "string" } ], "type": "array" }, "permission": "map.write", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "void", "summary": "控制或查看宿主播放；finished 等待当前轮完成，停止或替换会取消" }, { "name": "map.playbacks.seek", "native": "host.scene", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "uuid", "tsType": "PlaybackRef", "type": "string" }, { "maximum": 172800000, "minimum": 0, "type": "number" } ], "type": "array" }, "permission": "map.write", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "void", "summary": "控制或查看宿主播放；finished 等待当前轮完成，停止或替换会取消" }, { "name": "map.playbacks.info", "native": "host.scene", "parameters": { "items": false, "maxItems": 1, "minItems": 1, "prefixItems": [ { "format": "uuid", "tsType": "PlaybackRef", "type": "string" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "PlaybackInfo", "summary": "控制或查看宿主播放；finished 等待当前轮完成，停止或替换会取消" }, { "name": "map.playbacks.finished", "native": "host.scene", "parameters": { "items": false, "maxItems": 1, "minItems": 1, "prefixItems": [ { "format": "uuid", "tsType": "PlaybackRef", "type": "string" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "void", "summary": "控制或查看宿主播放；finished 等待当前轮完成，停止或替换会取消" }, { "name": "map.scenes.create", "native": "host.scene", "parameters": { "items": false, "maxItems": 1, "minItems": 1, "prefixItems": [ { "additionalProperties": false, "properties": { "id": { "maxLength": 128, "minLength": 1, "type": "string" }, "name": { "maxLength": 128, "minLength": 1, "type": "string" } }, "required": [ "id", "name" ], "tsType": "{id:string;name:string}", "type": "object" } ], "type": "array" }, "permission": "map.write", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "SceneRef", "summary": "准备可由宿主管理的场景，草稿不显示或启动播放" }, { "name": "map.scenes.get", "native": "host.scene", "parameters": { "items": false, "maxItems": 1, "minItems": 1, "prefixItems": [ { "maxLength": 128, "minLength": 1, "type": "string" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "SceneRef | null", "summary": "按标识取得场景引用" }, { "name": "map.scenes.list", "native": "host.scene", "parameters": { "items": false, "maxItems": 1, "minItems": 0, "prefixItems": [ { "additionalProperties": false, "default": {}, "properties": { "cursor": { "format": "uuid", "type": "string" }, "limit": { "default": 20, "maximum": 100, "minimum": 1, "type": "integer" } }, "tsType": "PageOptions", "type": "object" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation>", "returns": "Page", "summary": "分页查看宿主场景及状态" }, { "name": "map.scenes.remove", "native": "host.scene", "parameters": { "items": false, "maxItems": 1, "minItems": 1, "prefixItems": [ { "format": "uuid", "tsType": "SceneRef", "type": "string" } ], "type": "array" }, "permission": "map.write", "platforms": [ "desktop", "mobile", "web" ], "return_type": "ChangePlan", "returns": "ChangePlan", "summary": "预演移除场景及自有资源；外部依赖会阻止移除，源文件不会删除" }, { "name": "map.scenes.start", "native": "host.scene", "parameters": { "items": false, "maxItems": 1, "minItems": 1, "prefixItems": [ { "format": "uuid", "tsType": "SceneRef", "type": "string" } ], "type": "array" }, "permission": "scene.run", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "void", "summary": "原子激活场景，脚本退出后由宿主管理" }, { "name": "map.scenes.pause", "native": "host.scene", "parameters": { "items": false, "maxItems": 1, "minItems": 1, "prefixItems": [ { "format": "uuid", "tsType": "SceneRef", "type": "string" } ], "type": "array" }, "permission": "map.write", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "void", "summary": "冻结场景时钟，保留显示" }, { "name": "map.scenes.resume", "native": "host.scene", "parameters": { "items": false, "maxItems": 1, "minItems": 1, "prefixItems": [ { "format": "uuid", "tsType": "SceneRef", "type": "string" } ], "type": "array" }, "permission": "scene.run", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "void", "summary": "从暂停位置恢复场景时钟" }, { "name": "map.scenes.stop", "native": "host.scene", "parameters": { "items": false, "maxItems": 1, "minItems": 1, "prefixItems": [ { "format": "uuid", "tsType": "SceneRef", "type": "string" } ], "type": "array" }, "permission": "map.write", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "void", "summary": "停止场景，保留最后显示；再次开始从零计时" }, { "name": "map.scenes.info", "native": "host.scene", "parameters": { "items": false, "maxItems": 1, "minItems": 1, "prefixItems": [ { "format": "uuid", "tsType": "SceneRef", "type": "string" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "SceneInfo", "summary": "读取场景资源数、状态与单调播放时钟" }, { "name": "map.contours.enable", "native": "host.layer-list", "parameters": { "items": false, "maxItems": 1, "minItems": 1, "prefixItems": [ { "additionalProperties": false, "properties": { "token": { "format": "uuid", "type": "string" }, "url": { "maxLength": 4096, "type": "string" } }, "required": [ "url" ], "tsType": "ContourOptions", "type": "object" } ], "type": "array" }, "permission": "map.write", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "ContourStatus", "summary": "管理 Terrain-RGB 二维等高线及加载状态" }, { "name": "map.contours.disable", "native": "host.layer-list", "parameters": { "items": false, "maxItems": 0, "minItems": 0, "prefixItems": [], "type": "array" }, "permission": "map.write", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "ContourStatus", "summary": "管理 Terrain-RGB 二维等高线及加载状态" }, { "name": "map.contours.status", "native": "host.layer-list", "parameters": { "items": false, "maxItems": 0, "minItems": 0, "prefixItems": [], "type": "array" }, "permission": "map.write", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "ContourStatus", "summary": "管理 Terrain-RGB 二维等高线及加载状态" }, { "name": "map.contours.sampleElevation", "native": "host.map-read", "parameters": { "items": false, "maxItems": 1, "minItems": 1, "prefixItems": [ { "items": { "type": "number" }, "maxItems": 2, "minItems": 2, "tsType": "[number,number]", "type": "array" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "OnlineElevationSample", "summary": "从当前 Terrain-RGB 图源查询 WGS84 点高程，透明像元返回缺测" }, { "name": "map.contours.snapshot", "native": "host.map-read", "parameters": { "items": false, "maxItems": 1, "minItems": 0, "prefixItems": [ { "additionalProperties": false, "default": {}, "properties": { "bounds": { "items": { "type": "number" }, "maxItems": 4, "minItems": 4, "tsType": "[number,number,number,number]", "type": "array" }, "intervalM": { "maximum": 10000, "minimum": 1, "type": "number" }, "maxPoints": { "default": 100000, "maximum": 100000, "minimum": 2, "type": "integer" }, "targetCrs": { "default": "EPSG:3857", "enum": [ "EPSG:3857", "EPSG:4326" ] }, "zoom": { "maximum": 14, "minimum": 0, "type": "integer" } }, "tsType": "ContourSnapshotOptions", "type": "object" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "ContourSnapshot", "summary": "按指定范围读取地形等高线矢量快照，返回带米制 elevation_m 字段的冻结数据引用；不读取屏幕缓存，不改变显示" }, { "name": "map.basemap.load", "native": "host.map-write", "parameters": { "items": false, "maxItems": 1, "minItems": 1, "prefixItems": [ { "additionalProperties": false, "properties": { "camera": { "enum": [ "preserve", "style" ] }, "compatibility": { "enum": [ "strict" ] }, "initialView": { "additionalProperties": false, "properties": { "center": { "items": { "type": "number" }, "maxItems": 2, "minItems": 2, "tsType": "[number,number]", "type": "array" }, "zoom": { "maximum": 24, "minimum": 0, "type": "number" } }, "type": "object" }, "url": { "maxLength": 4096, "minLength": 1, "type": "string" } }, "required": [ "url" ], "tsType": "BasemapLoadOptions", "type": "object" } ], "type": "array" }, "permission": "map.write", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "BasemapLoadRef", "summary": "加载样式底图，返回可等待和取消的加载任务" }, { "name": "map.contours.profileLines", "native": "host.map-read", "parameters": { "items": false, "maxItems": 1, "minItems": 0, "prefixItems": [ { "additionalProperties": false, "default": {}, "properties": { "bounds": { "items": { "type": "number" }, "maxItems": 4, "minItems": 4, "tsType": "[number,number,number,number]", "type": "array" }, "maxPoints": { "default": 100000, "maximum": 100000, "minimum": 2, "type": "integer" }, "pointSpacingM": { "default": 200, "maximum": 10000, "minimum": 10, "type": "number" }, "rowSpacingM": { "default": 500, "maximum": 10000, "minimum": 50, "type": "number" }, "zoom": { "maximum": 14, "minimum": 0, "type": "integer" } }, "tsType": "TerrainProfileOptions", "type": "object" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "TerrainProfileSnapshot", "summary": "按范围从地形图源读取平行剖面线，每个顶点保留米制高程；返回冻结三维线数据引用，不改变显示" }, { "name": "map.basemap.ready", "native": "host.map-read", "parameters": { "items": false, "maxItems": 1, "minItems": 1, "prefixItems": [ { "format": "uuid", "tsType": "BasemapLoadRef", "type": "string" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "BasemapStatus", "summary": "等待底图初始视野提交并读取状态" }, { "name": "map.basemap.cancel", "native": "host.map-write", "parameters": { "items": false, "maxItems": 1, "minItems": 1, "prefixItems": [ { "format": "uuid", "tsType": "BasemapLoadRef", "type": "string" } ], "type": "array" }, "permission": "map.write", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "void", "summary": "取消尚未提交的底图加载" }, { "name": "map.basemap.status", "native": "host.map-read", "parameters": { "items": false, "maxItems": 0, "minItems": 0, "prefixItems": [], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "BasemapStatus", "summary": "读取当前底图加载状态" }, { "name": "raster.buildOverviews", "native": "host.dataset-export", "parameters": { "items": false, "maxItems": 1, "minItems": 1, "prefixItems": [ { "format": "uuid", "tsType": "RasterRef", "type": "string" } ], "type": "array" }, "permission": "export.write", "platforms": [ "desktop", "mobile" ], "return_type": "ChangePlan", "returns": "ChangePlan", "summary": "在隔离副本构建影像概览，预演后确认提交旁文件" }, { "name": "raster.elevationInfo", "native": "host.map-read", "parameters": { "items": false, "maxItems": 2, "minItems": 1, "prefixItems": [ { "format": "uuid", "tsType": "RasterRef", "type": "string" }, { "additionalProperties": false, "default": {}, "properties": { "band": { "maximum": 256, "minimum": 1, "type": "integer" }, "method": { "enum": [ "nearest", "bilinear" ] }, "unit": { "enum": [ "m", "ft" ] }, "verticalReference": { "maxLength": 160, "minLength": 1, "type": "string" } }, "tsType": "ElevationOptions", "type": "object" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile" ], "return_type": "Operation", "returns": "ElevationInfo", "summary": "读取高程波段、单位和基准说明，不加载整幅影像" }, { "name": "raster.sampleElevation", "native": "host.map-read", "parameters": { "items": false, "maxItems": 3, "minItems": 2, "prefixItems": [ { "format": "uuid", "tsType": "RasterRef", "type": "string" }, { "items": { "type": "number" }, "maxItems": 2, "minItems": 2, "tsType": "[number,number]", "type": "array" }, { "additionalProperties": false, "default": {}, "properties": { "band": { "maximum": 256, "minimum": 1, "type": "integer" }, "method": { "enum": [ "nearest", "bilinear" ] }, "unit": { "enum": [ "m", "ft" ] }, "verticalReference": { "maxLength": 160, "minLength": 1, "type": "string" } }, "tsType": "ElevationOptions", "type": "object" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile" ], "return_type": "Operation", "returns": "ElevationSampleResult", "summary": "按 WGS84 经纬度查询实际高程，区分范围外和无效像元" }, { "name": "raster.profileElevation", "native": "host.map-read", "parameters": { "items": false, "maxItems": 3, "minItems": 3, "prefixItems": [ { "format": "uuid", "tsType": "RasterRef", "type": "string" }, { "items": { "items": { "type": "number" }, "maxItems": 2, "minItems": 2, "type": "array" }, "maxItems": 128, "minItems": 2, "tsType": "[number,number][]", "type": "array" }, { "additionalProperties": false, "properties": { "band": { "maximum": 256, "minimum": 1, "type": "integer" }, "method": { "enum": [ "nearest", "bilinear" ] }, "spacingM": { "exclusiveMinimum": 0, "type": "number" }, "unit": { "enum": [ "m", "ft" ] }, "verticalReference": { "maxLength": 160, "minLength": 1, "type": "string" } }, "required": [ "spacingM" ], "tsType": "ElevationProfileOptions", "type": "object" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile" ], "return_type": "Operation", "returns": "ElevationProfileResult", "summary": "沿线按米制间距取高程剖面，空洞保留断段，最多返回 64 个明细点" }, { "name": "secrets.request", "native": "host.layer-list", "parameters": { "items": false, "maxItems": 1, "minItems": 1, "prefixItems": [ { "additionalProperties": false, "properties": { "label": { "maxLength": 80, "minLength": 1, "type": "string" }, "purpose": { "maxLength": 160, "minLength": 1, "type": "string" } }, "required": [ "purpose", "label" ], "tsType": "{purpose:string;label:string}", "type": "object" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile" ], "return_type": "Operation", "returns": "SecretRef", "summary": "由宿主安全输入凭据，仅返回不透明引用" }, { "name": "secrets.get", "native": "host.layer-list", "parameters": { "items": false, "maxItems": 1, "minItems": 1, "prefixItems": [ { "maxLength": 80, "minLength": 1, "type": "string" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile" ], "return_type": "Operation", "returns": "SecretRef | null", "summary": "读取当前任务已授权的具名凭据引用，不返回明文" }, { "name": "query.metrics", "native": "data.query", "parameters": { "items": false, "maxItems": 2, "minItems": 1, "prefixItems": [ { "format": "uuid", "tsType": "DatasetRef | FeatureSetRef | FeatureRef | MapLayerRef", "type": "string" }, { "additionalProperties": false, "default": {}, "properties": { "measurementCrs": { "maxLength": 32, "minLength": 6, "type": "string" }, "scope": { "enum": [ "all", "filtered" ], "type": "string" } }, "required": [], "tsType": "{scope?: 'all'|'filtered'; measurementCrs?: string}", "type": "object" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile" ], "return_type": "Operation", "returns": "MetricSummary", "summary": "在明确的米制投影中统计数量、面积和长度" }, { "name": "analysis.buffer", "native": "analysis.buffer", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "uuid", "tsType": "DatasetRef | FeatureSetRef | MapLayerRef", "type": "string" }, { "additionalProperties": false, "properties": { "cap": { "enum": [ "round", "flat", "square" ], "type": "string" }, "dissolve": { "type": "boolean" }, "distance": { "additionalProperties": false, "properties": { "unit": { "enum": [ "mm", "cm", "m", "km" ], "type": "string" }, "value": { "exclusiveMinimum": 0, "type": "number" } }, "required": [ "value", "unit" ], "type": "object" }, "join": { "enum": [ "round", "mitre", "bevel" ], "type": "string" }, "name": { "maxLength": 128, "minLength": 1, "type": "string" }, "scope": { "enum": [ "all", "filtered" ], "type": "string" }, "targetCrs": { "maxLength": 32, "minLength": 6, "type": "string" } }, "required": [ "distance" ], "tsType": "BufferOptions", "type": "object" } ], "type": "array" }, "permission": "analysis.execute", "platforms": [ "desktop", "mobile" ], "return_type": "Operation", "returns": "DatasetRef", "summary": "正距离米制点、线、面缓冲，生成新数据并保留输入坐标系" }, { "name": "data.fromGeoJSON", "native": "data.query", "parameters": { "items": false, "maxItems": 2, "minItems": 1, "prefixItems": [ { "tsType": "GeoJSON", "type": "object" }, { "additionalProperties": false, "default": {}, "properties": { "name": { "maxLength": 128, "minLength": 1, "type": "string" } }, "required": [], "tsType": "{name?: string}", "type": "object" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "DatasetRef", "summary": "读取内存 GeoJSON 并保留原始属性类型，不自动上图" }, { "name": "data.open", "native": "data.query", "parameters": { "items": false, "maxItems": 2, "minItems": 1, "prefixItems": [ { "maxLength": 32768, "minLength": 1, "type": "string" }, { "additionalProperties": false, "default": {}, "properties": { "layer": { "anyOf": [ { "minimum": 0, "type": "integer" }, { "maxLength": 128, "minLength": 1, "type": "string" } ] }, "maxFeatures": { "minimum": 1, "type": "integer" }, "maxPoints": { "minimum": 1, "type": "integer" }, "password": { "format": "uuid", "type": "string" }, "targetCrs": { "maxLength": 32, "minLength": 6, "type": "string" } }, "required": [], "tsType": "DataOpenOptions", "type": "object" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile" ], "return_type": "Operation", "returns": "DatasetRef | RasterRef", "summary": "读取本地矢量或栅格数据，保留坐标系和字段类型" }, { "name": "data.layers", "native": "data.query", "parameters": { "items": false, "maxItems": 2, "minItems": 1, "prefixItems": [ { "maxLength": 32768, "minLength": 1, "type": "string" }, { "additionalProperties": false, "default": {}, "properties": { "cursor": { "format": "uuid", "maxLength": 36, "type": "string" }, "limit": { "default": 20, "maximum": 100, "minimum": 1, "type": "integer" } }, "required": [], "tsType": "PageOptions", "type": "object" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile" ], "return_type": "Operation>", "returns": "Page", "summary": "分页发现子图层；游标绑定文件及旁文件指纹" }, { "name": "data.info", "native": "data.query", "parameters": { "items": false, "maxItems": 1, "minItems": 1, "prefixItems": [ { "format": "uuid", "tsType": "DatasetRef | RasterRef | MapLayerRef | TableRef", "type": "string" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "DatasetInfo | RasterInfo | TableInfo", "summary": "读取数据元信息与坐标系" }, { "name": "data.fields", "native": "data.query", "parameters": { "items": false, "maxItems": 2, "minItems": 1, "prefixItems": [ { "format": "uuid", "tsType": "DatasetRef | MapLayerRef | TableRef", "type": "string" }, { "additionalProperties": false, "default": {}, "properties": { "cursor": { "format": "uuid", "maxLength": 36, "type": "string" }, "limit": { "minimum": 1, "type": "integer" } }, "required": [], "tsType": "PageOptions", "type": "object" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile" ], "return_type": "Operation>", "returns": "Page", "summary": "分页发现字段类型；成果表保留声明类型和计量单位，原有无类型全空源字段按可空字符串描述" }, { "name": "data.codes", "native": "data.query", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "uuid", "tsType": "DatasetRef | MapLayerRef", "type": "string" }, { "additionalProperties": false, "properties": { "cursor": { "format": "uuid", "maxLength": 36, "type": "string" }, "field": { "maxLength": 128, "minLength": 1, "type": "string" }, "limit": { "minimum": 1, "type": "integer" } }, "required": [ "field" ], "tsType": "PageOptions & {field: string}", "type": "object" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile" ], "return_type": "Operation>", "returns": "Page", "summary": "仅返回已匹配代码表；无代码表时明确报告不存在" }, { "name": "query.select", "native": "data.query", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "uuid", "tsType": "DatasetRef | MapLayerRef", "type": "string" }, { "additionalProperties": false, "properties": { "scope": { "enum": [ "all", "filtered" ], "type": "string" }, "where": { "anyOf": [ { "type": "boolean" }, { "type": "array" } ] } }, "required": [], "tsType": "SelectionOptions", "type": "object" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile" ], "return_type": "Operation", "returns": "FeatureSetRef", "summary": "类型化筛选并保留原生要素集合，不改变地图选择" }, { "name": "query.rows", "native": "data.query", "parameters": { "items": false, "maxItems": 2, "minItems": 1, "prefixItems": [ { "format": "uuid", "tsType": "DatasetRef | MapLayerRef | FeatureSetRef | TableRef", "type": "string" }, { "additionalProperties": false, "default": {}, "properties": { "cursor": { "format": "uuid", "maxLength": 36, "type": "string" }, "fields": { "items": { "maxLength": 128, "minLength": 1, "type": "string" }, "maxItems": 64, "type": "array" }, "limit": { "minimum": 1, "type": "integer" }, "scope": { "enum": [ "all", "filtered" ], "type": "string" }, "search": { "maxLength": 1024, "type": "string" }, "where": { "anyOf": [ { "type": "boolean" }, { "type": "array" } ] } }, "required": [], "tsType": "RowQueryOptions | TableRowQueryOptions", "type": "object" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile" ], "return_type": "Operation | Page>", "returns": "Page | Page", "summary": "分页读取属性；游标绑定查询与版本；表格行只有 values，默认20/最多100行，表格不接受筛选与搜索" }, { "name": "query.features", "native": "data.query", "parameters": { "items": false, "maxItems": 2, "minItems": 1, "prefixItems": [ { "format": "uuid", "tsType": "DatasetRef | MapLayerRef", "type": "string" }, { "additionalProperties": false, "default": {}, "properties": { "cursor": { "format": "uuid", "maxLength": 36, "type": "string" }, "fields": { "items": { "maxLength": 128, "minLength": 1, "type": "string" }, "maxItems": 64, "type": "array" }, "geometry": { "enum": [ "none", "bounds", "geojson" ], "type": "string" }, "limit": { "minimum": 1, "type": "integer" }, "scope": { "enum": [ "all", "filtered" ], "type": "string" }, "where": { "anyOf": [ { "type": "boolean" }, { "type": "array" } ] } }, "required": [], "tsType": "FeatureQueryOptions", "type": "object" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile" ], "return_type": "Operation>", "returns": "Page", "summary": "分页读取小要素结果，几何留在宿主且按需返回" }, { "name": "query.fieldSummary", "native": "data.query", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "uuid", "tsType": "DatasetRef | MapLayerRef", "type": "string" }, { "additionalProperties": false, "properties": { "field": { "maxLength": 128, "minLength": 1, "type": "string" }, "sampleLimit": { "minimum": 1, "type": "integer" }, "scope": { "enum": [ "all", "filtered" ], "type": "string" } }, "required": [ "field" ], "tsType": "{field: string; scope?: 'all'|'filtered'; sampleLimit?: number}", "type": "object" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile" ], "return_type": "Operation", "returns": "FieldSummary", "summary": "完整统计字段缺失与唯一值；样本限制不改变统计范围" }, { "name": "query.groupMetrics", "native": "data.query", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "uuid", "tsType": "DatasetRef | MapLayerRef", "type": "string" }, { "additionalProperties": false, "properties": { "field": { "maxLength": 128, "minLength": 1, "type": "string" }, "groupLimit": { "minimum": 1, "type": "integer" }, "measurementCrs": { "maxLength": 32, "minLength": 6, "type": "string" }, "scope": { "enum": [ "all", "filtered" ], "type": "string" } }, "required": [ "field" ], "tsType": "GroupMetricOptions", "type": "object" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile" ], "return_type": "Operation", "returns": "GroupMetricSummary", "summary": "按真实字段完整分组统计数量与米制度量" }, { "name": "query.missingValues", "native": "data.query", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "uuid", "tsType": "DatasetRef | MapLayerRef", "type": "string" }, { "additionalProperties": false, "properties": { "field": { "maxLength": 128, "minLength": 1, "type": "string" }, "groupLimit": { "minimum": 1, "type": "integer" }, "sampleLimit": { "minimum": 1, "type": "integer" }, "scanLimit": { "minimum": 1, "type": "integer" }, "scope": { "enum": [ "all", "filtered" ], "type": "string" } }, "required": [ "field" ], "tsType": "FieldQualityOptions", "type": "object" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile" ], "return_type": "Operation", "returns": "MissingValueSummary", "summary": "检查空值和空白，返回准确扫描覆盖与有限样本" }, { "name": "query.duplicateValues", "native": "data.query", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "uuid", "tsType": "DatasetRef | MapLayerRef", "type": "string" }, { "additionalProperties": false, "properties": { "field": { "maxLength": 128, "minLength": 1, "type": "string" }, "groupLimit": { "minimum": 1, "type": "integer" }, "sampleLimit": { "minimum": 1, "type": "integer" }, "scanLimit": { "minimum": 1, "type": "integer" }, "scope": { "enum": [ "all", "filtered" ], "type": "string" } }, "required": [ "field" ], "tsType": "FieldQualityOptions", "type": "object" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile" ], "return_type": "Operation", "returns": "DuplicateValueSummary", "summary": "按类型检查非空重复值，返回分组计数和有限样本" }, { "name": "query.fieldQuality", "native": "data.query", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "uuid", "tsType": "DatasetRef | MapLayerRef", "type": "string" }, { "additionalProperties": false, "properties": { "field": { "maxLength": 128, "minLength": 1, "type": "string" }, "groupLimit": { "minimum": 1, "type": "integer" }, "sampleLimit": { "minimum": 1, "type": "integer" }, "scanLimit": { "minimum": 1, "type": "integer" }, "scope": { "enum": [ "all", "filtered" ], "type": "string" } }, "required": [ "field" ], "tsType": "FieldQualityOptions", "type": "object" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile" ], "return_type": "Operation", "returns": "FieldQualitySummary", "summary": "在同一版本和扫描集合上综合检查字段质量" }, { "name": "export.dataset", "native": "host.dataset-export", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "uuid", "tsType": "DatasetRef | MapLayerRef | FeatureSetRef", "type": "string" }, { "additionalProperties": false, "properties": { "format": { "enum": [ "geojson", "gpkg", "kml", "shapefile", "sjs" ], "type": "string" }, "overwrite": { "enum": [ "deny", "ask" ], "type": "string" }, "password": { "format": "uuid", "type": "string" }, "path": { "maxLength": 32768, "minLength": 1, "type": "string" }, "scope": { "enum": [ "all", "filtered" ], "type": "string" }, "targetCrs": { "maxLength": 32, "minLength": 6, "type": "string" } }, "required": [ "path" ], "tsType": "DatasetExportOptions", "type": "object" } ], "type": "array" }, "permission": "export.write", "platforms": [ "desktop", "mobile" ], "return_type": "ChangePlan", "returns": "ChangePlan", "summary": "为新 GeoJSON 或 GPKG 文件预演数据集导出；提交需宿主确认" }, { "name": "export.saveToSource", "native": "host.dataset-export", "parameters": { "items": false, "maxItems": 2, "minItems": 1, "prefixItems": [ { "format": "uuid", "tsType": "MapLayerRef", "type": "string" }, { "additionalProperties": false, "default": {}, "properties": { "password": { "format": "uuid", "type": "string" } }, "required": [], "tsType": "{password?:SecretRef}", "type": "object" } ], "type": "array" }, "permission": "export.write", "platforms": [ "desktop", "mobile" ], "return_type": "ChangePlan", "returns": "ChangePlan", "summary": "仅对完整且可验证的单文件成果预演回源保存" }, { "name": "export.feature", "native": "host.dataset-export", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "uuid", "tsType": "FeatureRef", "type": "string" }, { "additionalProperties": false, "properties": { "format": { "enum": [ "geojson", "gpkg", "kml", "shapefile", "sjs" ], "type": "string" }, "overwrite": { "enum": [ "deny", "ask" ], "type": "string" }, "password": { "format": "uuid", "type": "string" }, "path": { "maxLength": 32768, "minLength": 1, "type": "string" }, "scope": { "enum": [ "all", "filtered" ], "type": "string" }, "targetCrs": { "maxLength": 32, "minLength": 6, "type": "string" } }, "required": [ "path" ], "tsType": "DatasetExportOptions", "type": "object" } ], "type": "array" }, "permission": "export.write", "platforms": [ "desktop", "mobile" ], "return_type": "ChangePlan", "returns": "ChangePlan", "summary": "预演单要素成果导出，复用字段检查和宿主确认" }, { "name": "export.map", "native": "host.dataset-export", "parameters": { "items": false, "maxItems": 1, "minItems": 1, "prefixItems": [ { "required": [ "path" ], "tsType": "MapExportOptions", "type": "object" } ], "type": "array" }, "permission": "export.write", "platforms": [ "desktop", "mobile" ], "return_type": "ChangePlan", "returns": "ChangePlan", "summary": "冻结当前地图并预演 PNG 或固定 A4 横向 PDF；平面三维可选 1～4 倍离屏分辨率，不完整内容明确拒绝" }, { "name": "export.validate", "native": "data.query", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "uuid", "tsType": "DatasetRef | MapLayerRef | FeatureSetRef", "type": "string" }, { "additionalProperties": false, "properties": { "format": { "enum": [ "geojson", "gpkg", "kml", "shapefile", "sjs" ], "type": "string" }, "issueLimit": { "minimum": 1, "type": "integer" } }, "required": [], "tsType": "ExportValidationOptions", "type": "object" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile" ], "return_type": "Operation", "returns": "ExportValidationSummary", "summary": "预检格式的字段、几何及类型限制，不写文件" }, { "name": "map.open", "native": "host.map-write", "parameters": { "items": false, "maxItems": 2, "minItems": 1, "prefixItems": [ { "maxLength": 32768, "minLength": 1, "type": "string" }, { "additionalProperties": false, "default": {}, "properties": { "layer": { "anyOf": [ { "minimum": 0, "type": "integer" }, { "maxLength": 128, "minLength": 1, "type": "string" } ] }, "name": { "maxLength": 128, "minLength": 1, "type": "string" }, "password": { "format": "uuid", "type": "string" }, "targetCrs": { "maxLength": 32, "minLength": 6, "type": "string" } }, "required": [], "tsType": "MapOpenOptions", "type": "object" } ], "type": "array" }, "permission": "map.write", "platforms": [ "desktop", "mobile" ], "return_type": "Operation", "returns": "MapLayerRef", "summary": "读取矢量文件并作为面、线或圆点显示；同时需要 project.read 和 map.write" }, { "name": "map.getStyle", "native": "host.map-read", "parameters": { "items": false, "maxItems": 0, "minItems": 0, "prefixItems": [], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "web" ], "return_type": "Operation", "returns": "import(\"sqsmap\").StyleSpecification", "summary": "读取当前共同内联样式快照，包含图源数据与图层编辑；不改变地图" }, { "name": "map.setStyle", "native": "host.map-write", "parameters": { "items": false, "maxItems": 2, "minItems": 1, "prefixItems": [ { "anyOf": [ { "maxLength": 4096, "minLength": 1, "type": "string" }, { "type": "null" }, { "type": "object" } ], "tsType": "string | null | import(\"sqsmap\").StyleSpecification" }, { "additionalProperties": false, "default": {}, "properties": { "diff": { "type": "boolean" } }, "tsType": "import(\"sqsmap\").StyleOptions", "type": "object" } ], "type": "array" }, "permission": "map.write", "platforms": [ "desktop", "web" ], "return_type": "Operation", "returns": "void", "summary": "原子提交HTTP或自定义协议样式地址及内联样式；省略diff或true尝试保留兼容源与图层，false完整替换，null清空；flush确认写入而非资源就绪" }, { "name": "map.getAttributions", "native": "host.map-read", "parameters": { "items": false, "maxItems": 0, "minItems": 0, "prefixItems": [], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "web" ], "return_type": "Operation", "returns": "import(\"sqsmap\").AttributionSnapshot", "summary": "读取当前逻辑图源署名的完整纯文本快照，包含来源与图层身份；不改变地图" }, { "name": "map.lifecycle.read", "native": "host.map-read", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "enum": [ "state", "loaded" ], "type": "string" }, { "maxItems": 0, "tsType": "unknown[]", "type": "array" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "web" ], "return_type": "Operation", "returns": "unknown", "summary": "读取初始化、首次完整绘制、实际帧和当前工作；只读查询不采样动画或推进渲染" }, { "name": "map.getCapabilities", "native": "host.map-read", "parameters": { "items": false, "maxItems": 0, "minItems": 0, "prefixItems": [], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "web" ], "return_type": "Operation>>", "returns": "Readonly>", "summary": "读取已实现的共同地图能力；缺失或false表示不可使用" }, { "name": "map.protocol.write", "native": "host.map-write", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "enum": [ "addProtocol", "removeProtocol" ], "type": "string" }, { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "maxLength": 32, "minLength": 1, "type": "string" }, { "maximum": 9007199254740991, "minimum": 1, "type": "integer" } ], "tsType": "[string, number]", "type": "array" } ], "type": "array" }, "permission": "map.write", "platforms": [ "desktop", "web" ], "return_type": "Operation", "returns": "unknown", "summary": "登记或移除当前桌面或网页脚本拥有的协议处理器；回调和二进制走有界私有通道，停止释放自身登记" }, { "name": "map.resourcePolicy.read", "native": "host.map-read", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "enum": [ "getConfiguration", "plan" ], "type": "string" }, { "items": {}, "maxItems": 1, "minItems": 0, "tsType": "unknown[]", "type": "array" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "web" ], "return_type": "Operation", "returns": "unknown", "summary": "共享资源配置快照与只读HTTP或自定义协议请求计划；资源交付由宿主负责" }, { "name": "map.resourcePolicy.write", "native": "host.map-write", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "enum": [ "configure" ], "type": "string" }, { "items": {}, "maxItems": 1, "minItems": 0, "tsType": "unknown[]", "type": "array" } ], "type": "array" }, "permission": "map.write", "platforms": [ "desktop", "web" ], "return_type": "Operation", "returns": "unknown", "summary": "共享资源配置快照与只读HTTP或自定义协议请求计划；资源交付由宿主负责" }, { "name": "map.scene.read", "native": "host.map-read", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "enum": [ "get", "list", "getState", "getClock", "playback.get", "playback.list", "playback.getState" ], "type": "string" }, { "items": {}, "maxItems": 2, "minItems": 0, "tsType": "unknown[]", "type": "array" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "web" ], "return_type": "Operation", "returns": "unknown", "summary": "共同场景生命周期、时钟、GeoJSON归属及地图持有的轨迹播放、二维线动画与颜色透明度宽度曲线" }, { "name": "map.scene.write", "native": "host.map-write", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "enum": [ "create", "start", "pause", "resume", "stop", "remove", "attachSource", "detachSource", "animation.route", "animation.line", "playback.play", "playback.pause", "playback.stop", "playback.seek", "playback.remove" ], "type": "string" }, { "items": {}, "maxItems": 2, "minItems": 0, "tsType": "unknown[]", "type": "array" } ], "type": "array" }, "permission": "map.write", "platforms": [ "desktop", "web" ], "return_type": "Operation", "returns": "unknown", "summary": "共同场景生命周期、时钟、GeoJSON归属及地图持有的轨迹播放、二维线动画与颜色透明度宽度曲线" }, { "name": "map.source.read", "native": "host.map-read", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "enum": [ "sqs.getLabelFadeDuration", "sqs.getMaterialFadeDuration", "getGlobalState", "getTerrain", "queryTerrainElevation", "sqs.tileMetadata", "sqs.mediaState", "getSource", "isSourceLoaded", "getData", "querySourceFeatures", "getFeatureState", "getClusterOptions", "getClusterChildren", "getClusterLeaves", "getClusterExpansionZoom", "sqs.getLiveState", "sqs.freezeLiveSnapshot", "sqs.getLiveReceiver", "sqs.liveState" ], "type": "string" }, { "items": {}, "maxItems": 4, "minItems": 0, "tsType": "unknown[]", "type": "array" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "web" ], "return_type": "Operation", "returns": "unknown", "summary": "读取共同 GeoJSON、瓦片元数据或配准媒体图源身份、加载状态、媒体状态、实时协议或独立快照，查询使用 await；sqs.getMaterialFadeDuration无参数，返回整数缩放材质渐变毫秒数，默认300；sqs.getLabelFadeDuration无参数，返回独立标签放置渐变毫秒数，默认300" }, { "name": "map.source.write", "native": "host.map-write", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "enum": [ "sqs.setLabelFadeDuration", "sqs.setMaterialFadeDuration", "setGlobalStateProperty", "setTerrain", "setTiles", "setUrl", "updateImage", "setCoordinates", "play", "pause", "sqs.submitMediaFrame", "sqs.failMediaFrame", "addSource", "removeSource", "setData", "updateData", "setClusterOptions", "sqs.applyLiveUpdate", "sqs.connectLive", "sqs.pauseLive", "sqs.resumeLive", "sqs.stopLive", "setFeatureState", "removeFeatureState" ], "type": "string" }, { "items": {}, "maxItems": 2, "minItems": 1, "tsType": "unknown[]", "type": "array" } ], "type": "array" }, "permission": "map.write", "platforms": [ "desktop", "web" ], "return_type": "Operation", "returns": "unknown", "summary": "注册、移除或原子更新共同 GeoJSON 与配准媒体；GeoJSON 支持内存与 HTTP或自定义协议URL，媒体接受宿主解码帧、图像 HTTP或自定义协议URL/updateImage、MP4/H.264 视频HTTP或自定义协议urls、命名 Canvas RGBA 帧和播放控制；矢量与影像瓦片支持登记、HTTP或自定义协议TileJSON及setTiles/setUrl，影像瓦片支持共同raster图层，矢量MVT支持共同circle/line/fill、source-layer查询与独立要素状态；不自动创建显示图层；sqs.setMaterialFadeDuration接受一个有限非负且最多3600000的毫秒数，不改变手动图案或虚线时序，不重置源身份、缓存和时钟；sqs.setLabelFadeDuration接受一个有限非负且最多3600000的毫秒数，独立控制标签放置渐变，0即时，不重置源身份、缓存和时钟" }, { "name": "map.glyph.read", "native": "host.map-read", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "enum": [ "getGlyphs" ], "type": "string" }, { "items": {}, "maxItems": 2, "minItems": 0, "tsType": "unknown[]", "type": "array" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "web" ], "return_type": "Operation", "returns": "unknown", "summary": "读取已解析样式的字形服务地址；查询使用await" }, { "name": "map.glyph.write", "native": "host.map-write", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "enum": [ "setGlyphs" ], "type": "string" }, { "items": {}, "maxItems": 2, "minItems": 0, "tsType": "unknown[]", "type": "array" } ], "type": "array" }, "permission": "map.write", "platforms": [ "desktop", "web" ], "return_type": "Operation", "returns": "unknown", "summary": "切换或清除HTTP或自定义协议字形服务，保留已加载图源与图片并取消旧资源请求" }, { "name": "map.image.load", "native": "host.map-read", "parameters": { "items": false, "maxItems": 1, "minItems": 1, "prefixItems": [ { "maxLength": 4096, "minLength": 1, "type": "string" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "web" ], "return_type": "Operation", "returns": "unknown", "summary": "加载HTTP或自定义协议PNG/JPEG/WebP图片并解码为独立RGBA8像素；不自动注册" }, { "name": "map.image.read", "native": "host.map-read", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "enum": [ "getImage", "getImageInfo", "hasImage", "listImages", "sqs.dynamicImage.state" ], "type": "string" }, { "items": {}, "maxItems": 4, "minItems": 0, "tsType": "unknown[]", "type": "array" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "web" ], "return_type": "Operation", "returns": "unknown", "summary": "读取样式和运行时图片；返回独立 RGBA 像素与可选伸缩、内容区域和文字适配元数据副本" }, { "name": "map.image.write", "native": "host.map-write", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "enum": [ "addImage", "updateImage", "removeImage", "sqs.dynamicImage.add", "sqs.dynamicImage.register", "sqs.dynamicImage.requests", "sqs.dynamicImage.reply", "sqs.dynamicImage.repaint", "sqs.dynamicImage.release" ], "type": "string" }, { "items": {}, "maxItems": 4, "minItems": 0, "tsType": "unknown[]", "type": "array" } ], "type": "array" }, "permission": "map.write", "platforms": [ "desktop", "web" ], "return_type": "Operation", "returns": "unknown", "summary": "添加、更新或移除共同静态与动态图片；有界回调、重绘和同尺寸更新复用图片候选及元数据" }, { "name": "map.layer.read", "native": "host.map-read", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "enum": [ "getLayer", "getLayers", "getPaintProperty", "getLayoutProperty", "getFilter", "getLayerMetadata", "queryRenderedFeatures" ], "type": "string" }, { "items": {}, "maxItems": 4, "minItems": 0, "tsType": "unknown[]", "type": "array" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "web" ], "return_type": "Operation", "returns": "unknown", "summary": "读取共同 GeoJSON 或媒体 raster 图层、属性、筛选和 UI 描述，查询使用 await" }, { "name": "map.layer.write", "native": "host.map-write", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "enum": [ "addLayer", "removeLayer", "moveLayer", "setPaintProperty", "setLayoutProperty", "setFilter", "setLayerZoomRange", "setLayerMetadata" ], "type": "string" }, { "items": {}, "maxItems": 4, "minItems": 0, "tsType": "unknown[]", "type": "array" } ], "type": "array" }, "permission": "map.write", "platforms": [ "desktop", "web" ], "return_type": "Operation", "returns": "unknown", "summary": "共同circle/line/fill/raster、默认/多算法及map/viewport光照hillshade与color-relief高程图层、平面/透视fill-extrusion建筑、平面heatmap、支持SDF染色、缺图事件、默认碰撞与可调文字排版的点图片/内置字体文字symbol和无源background图层增删、排序、属性与缩放范围；要素图层支持筛选，媒体/背景没有要素；保留相机和真实图源身份" }, { "name": "map.camera.read", "native": "host.map-read", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "enum": [ "getCenter", "getZoom", "getMinZoom", "getMaxZoom", "getBearing", "getPitch", "getRoll", "getPadding", "getBounds", "getProjection", "project", "unproject", "cameraForBounds", "isEasing", "isMoving", "isZooming", "isRotating", "sqs.animationState", "sqs.cameraState", "sqs.scaleAt", "sqs.viewModeState" ], "type": "string" }, { "items": {}, "maxItems": 2, "minItems": 0, "tsType": "unknown[]", "type": "array" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "web" ], "return_type": "Operation", "returns": "unknown", "summary": "按共同地图写法读取权威平面或球面相机，查询使用 await" }, { "name": "map.camera.write", "native": "host.map-write", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "enum": [ "setProjection", "jumpTo", "easeTo", "flyTo", "stop", "sqs.setReducedMotion", "fitBounds", "setCenter", "setZoom", "setBearing", "setPitch", "setRoll", "zoomTo", "rotateTo", "panTo", "panBy", "resetNorthPitch", "setPadding", "resetNorth", "zoomIn", "zoomOut" ], "type": "string" }, { "items": {}, "maxItems": 2, "minItems": 0, "tsType": "unknown[]", "type": "array" } ], "type": "array" }, "permission": "map.write", "platforms": [ "desktop", "web" ], "return_type": "Operation", "returns": "unknown", "summary": "按共同地图写法提交完整校验的平面或球面相机设置，使用 flush 确认；球面支持动画、范围拟合、roll 和持久留白；留白保持地理姿态并调整投影主点" }, { "name": "map.light.read", "native": "host.map-read", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "enum": [ "getLight", "sqs.lighting.state" ], "type": "string" }, { "items": {}, "maxItems": 2, "minItems": 0, "tsType": "unknown[]", "type": "array" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "web" ], "return_type": "Operation", "returns": "unknown", "summary": "按共同地图写法读取光照常量与历史配置，查询使用 await" }, { "name": "map.light.write", "native": "host.map-write", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "enum": [ "setLight", "sqs.lighting.set" ], "type": "string" }, { "items": {}, "maxItems": 2, "minItems": 0, "tsType": "unknown[]", "type": "array" } ], "type": "array" }, "permission": "map.write", "platforms": [ "desktop", "web" ], "return_type": "Operation", "returns": "unknown", "summary": "原子设置共同光照颜色、方向和强度，使用 flush 确认" }, { "name": "map.gesture.read", "native": "host.map-read", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "enum": [ "dragPan.isEnabled", "dragPan.isActive", "scrollZoom.isEnabled", "scrollZoom.isActive", "doubleClickZoom.isEnabled", "doubleClickZoom.isActive", "keyboard.isEnabled", "keyboard.isActive", "touchZoomRotate.isEnabled", "touchZoomRotate.isActive", "touchPitch.isEnabled", "touchPitch.isActive", "sqs.gesturesState" ], "type": "string" }, { "items": {}, "maxItems": 0, "tsType": "unknown[]", "type": "array" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "web" ], "return_type": "Operation", "returns": "unknown", "summary": "读取共同导航开关与实际活动状态，查询使用 await" }, { "name": "map.gesture.write", "native": "host.map-write", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "enum": [ "dragPan.enable", "dragPan.disable", "scrollZoom.enable", "scrollZoom.disable", "doubleClickZoom.enable", "doubleClickZoom.disable", "keyboard.enable", "keyboard.disable", "keyboard.enableRotation", "keyboard.disableRotation", "touchZoomRotate.enable", "touchZoomRotate.disable", "touchZoomRotate.enableRotation", "touchZoomRotate.disableRotation", "touchPitch.enable", "touchPitch.disable" ], "type": "string" }, { "items": {}, "maxItems": 0, "tsType": "unknown[]", "type": "array" } ], "type": "array" }, "permission": "map.write", "platforms": [ "desktop", "web" ], "return_type": "Operation", "returns": "unknown", "summary": "设置共同默认导航开关，等待实际应用确认" }, { "name": "map.flush", "native": "host.map-read", "parameters": { "items": false, "maxItems": 1, "minItems": 0, "prefixItems": [ { "additionalProperties": false, "default": {}, "properties": { "render": { "type": "boolean" }, "since": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" } }, "tsType": "import(\"sqsmap\").FlushOptions", "type": "object" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "import(\"sqsmap\").MapCommitResult", "summary": "确认调用前已提交的地图操作，可选等待真实渲染；不代表图源就绪" }, { "name": "map.state", "native": "host.map-read", "parameters": { "items": false, "maxItems": 0, "minItems": 0, "prefixItems": [], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "MapStateSnapshot", "summary": "读取当前地图的加载、图层和任务摘要" }, { "name": "map.setLocale", "native": "host.map-write", "parameters": { "items": false, "maxItems": 1, "minItems": 1, "prefixItems": [ { "enum": [ "auto", "zh", "en" ], "tsType": "'auto' | 'zh' | 'en'", "type": "string" } ], "type": "array" }, "permission": "map.write", "platforms": [ "web" ], "return_type": "Operation<'zh' | 'en'>", "returns": "'zh' | 'en'", "summary": "设置地图控件与右键菜单语言；auto 跟随网页语言偏好，返回实际使用的语言" }, { "name": "map.getLocale", "native": "host.map-read", "parameters": { "items": false, "maxItems": 0, "minItems": 0, "prefixItems": [], "type": "array" }, "permission": "project.read", "platforms": [ "web" ], "return_type": "Operation<'zh' | 'en'>", "returns": "'zh' | 'en'", "summary": "读取地图控件与右键菜单实际使用的语言" }, { "name": "map.clear", "native": "host.map-write", "parameters": { "items": false, "maxItems": 0, "minItems": 0, "prefixItems": [], "type": "array" }, "permission": "map.write", "platforms": [ "desktop", "mobile", "web" ], "return_type": "ChangePlan", "returns": "ChangePlan", "summary": "预演清空当前地图中的图层与脚本数据源；提交需宿主确认" }, { "name": "map.addGeoJSON", "native": "host.map-write", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "maxLength": 128, "minLength": 1, "type": "string" }, { "tsType": "GeoJSON", "type": "object" } ], "type": "array" }, "permission": "map.write", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "MapLayerRef", "summary": "读取 GeoJSON 并作为面或线显示；同时需要 project.read 和 map.write" }, { "name": "map.sources.add", "native": "host.map-write", "parameters": { "items": false, "maxItems": 3, "minItems": 2, "prefixItems": [ { "maxLength": 128, "minLength": 1, "type": "string" }, { "tsType": "DatasetSourceSpec | GeoJSONSourceSpec | VectorFileSourceSpec | RasterFileSourceSpec | XyzSourceSpec | RasterDemSourceSpec | OnlineRasterDemSourceSpec | PointCloudSourceSpec | ModelSourceSpec | Tiles3dSourceSpec | GaussianSplatSourceSpec", "type": "object" }, { "additionalProperties": false, "default": {}, "properties": { "owner": { "format": "uuid", "type": "string" } }, "required": [ "owner" ], "tsType": "SceneOwnerOptions", "type": "object" } ], "type": "array" }, "permission": "map.write", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "SourceRef", "summary": "将数据集注册为地图数据源，不自动绘制" }, { "name": "map.sources.get", "native": "host.map-read", "parameters": { "items": false, "maxItems": 1, "minItems": 1, "prefixItems": [ { "maxLength": 128, "minLength": 1, "type": "string" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "SourceRef | null", "summary": "按精确标识查找地图数据源" }, { "name": "map.sources.remove", "native": "host.map-write", "parameters": { "items": false, "maxItems": 1, "minItems": 1, "prefixItems": [ { "format": "uuid", "tsType": "SourceRef", "type": "string" } ], "type": "array" }, "permission": "map.write", "platforms": [ "desktop", "mobile", "web" ], "return_type": "ChangePlan", "returns": "ChangePlan", "summary": "预演移除未被显示图层使用的数据源" }, { "name": "map.sources.list", "native": "host.map-read", "parameters": { "items": false, "maxItems": 1, "minItems": 0, "prefixItems": [ { "additionalProperties": false, "default": {}, "properties": { "cursor": { "format": "uuid", "type": "string" }, "limit": { "default": 20, "maximum": 100, "minimum": 1, "type": "integer" } }, "tsType": "PageOptions", "type": "object" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation>", "returns": "Page", "summary": "列出当前地图数据源" }, { "name": "map.layers.add", "native": "host.map-write", "parameters": { "items": false, "maxItems": 2, "minItems": 1, "prefixItems": [ { "tsType": "FillLineLayerSpec | RasterLayerSpec | SymbolLayerSpec | HeatmapLayerSpec | HillshadeLayerSpec | ColorReliefLayerSpec | PointCloudLayerSpec | ModelLayerSpec | Tiles3dLayerSpec | GaussianSplatLayerSpec", "type": "object" }, { "additionalProperties": false, "default": {}, "properties": { "owner": { "format": "uuid", "type": "string" } }, "required": [ "owner" ], "tsType": "SceneOwnerOptions", "type": "object" } ], "type": "array" }, "permission": "map.write", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "MapLayerRef", "summary": "用已有数据源创建面、线、圆点、影像、高程晕渲/分层设色、点云、模型、3D Tiles 或高斯泼溅显示" }, { "name": "map.layers.get", "native": "host.map-read", "parameters": { "items": false, "maxItems": 1, "minItems": 1, "prefixItems": [ { "maxLength": 128, "minLength": 1, "type": "string" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "MapLayerRef | null", "summary": "按精确标识或名称查找显示图层" }, { "name": "map.layers.removeMany", "native": "host.map-write", "parameters": { "items": false, "maxItems": 1, "minItems": 1, "prefixItems": [ { "items": { "format": "uuid", "type": "string" }, "maxItems": 64, "minItems": 1, "tsType": "MapLayerRef[]", "type": "array" } ], "type": "array" }, "permission": "map.write", "platforms": [ "desktop", "mobile", "web" ], "return_type": "ChangePlan", "returns": "ChangePlan", "summary": "统一预演并确认移除多个显示图层；源文件不变" }, { "name": "map.layers.remove", "native": "host.map-write", "parameters": { "items": false, "maxItems": 1, "minItems": 1, "prefixItems": [ { "format": "uuid", "tsType": "MapLayerRef", "type": "string" } ], "type": "array" }, "permission": "map.write", "platforms": [ "desktop", "mobile", "web" ], "return_type": "ChangePlan", "returns": "ChangePlan", "summary": "预演移除显示图层" }, { "name": "map.layers.rename", "native": "host.map-write", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "uuid", "tsType": "MapLayerRef", "type": "string" }, { "maxLength": 128, "minLength": 1, "type": "string" } ], "type": "array" }, "permission": "map.write", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "void", "summary": "更改显示图层名称" }, { "name": "map.layers.move", "native": "host.map-write", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "uuid", "tsType": "MapLayerRef", "type": "string" }, { "tsType": "MapLayerMoveOptions", "type": "object" } ], "type": "array" }, "permission": "map.write", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "void", "summary": "更改显示图层的叠加顺序" }, { "name": "map.layers.duplicate", "native": "host.map-write", "parameters": { "items": false, "maxItems": 2, "minItems": 1, "prefixItems": [ { "format": "uuid", "tsType": "MapLayerRef", "type": "string" }, { "default": {}, "tsType": "MapLayerDuplicateOptions", "type": "object" } ], "type": "array" }, "permission": "map.write", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "MapLayerRef", "summary": "复制显示配置并复用原数据源" }, { "name": "map.layers.list", "native": "host.map-read", "parameters": { "items": false, "maxItems": 1, "minItems": 0, "prefixItems": [ { "additionalProperties": false, "default": {}, "properties": { "cursor": { "format": "uuid", "type": "string" }, "limit": { "default": 20, "maximum": 100, "minimum": 1, "type": "integer" } }, "tsType": "PageOptions", "type": "object" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation>", "returns": "Page", "summary": "分页列出脚本及工作台既有矢量、影像图层摘要" }, { "name": "map.layers.setVisible", "native": "host.map-write", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "uuid", "tsType": "MapLayerRef", "type": "string" }, { "type": "boolean" } ], "type": "array" }, "permission": "map.write", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "void", "summary": "设置显示图层的可见性" }, { "name": "map.layers.setOpacity", "native": "host.map-write", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "uuid", "tsType": "MapLayerRef", "type": "string" }, { "maximum": 1, "minimum": 0, "type": "number" } ], "type": "array" }, "permission": "map.write", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "void", "summary": "设置整层透明度乘数" }, { "name": "map.layers.setPaint", "native": "host.map-write", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "uuid", "tsType": "MapLayerRef", "type": "string" }, { "tsType": "FillLinePaintPatch | SymbolPaintPatch | HeatmapPaint | ElevationPaintPatch | PointCloudPaint | Tiles3dPaint", "type": "object" } ], "type": "array" }, "permission": "map.write", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "void", "summary": "原子更新常量、属性和连续缩放样式" }, { "name": "map.layers.setHeight", "native": "host.map-write", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "uuid", "tsType": "MapLayerRef", "type": "string" }, { "anyOf": [ { "type": "null" }, { "additionalProperties": false, "properties": { "base": { "default": 0, "type": "number" }, "exaggeration": { "default": 1, "maximum": 1000, "minimum": 0, "type": "number" }, "field": { "maxLength": 128, "minLength": 1, "type": "string" }, "offset": { "default": 0, "type": "number" } }, "required": [ "field" ], "type": "object" } ], "tsType": "LayerHeightOptions | null" } ], "type": "array" }, "permission": "map.write", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "LayerHeightSummary", "summary": "按数字字段设置静态线图层的三维显示高度，不修改源数据；高度米=(字段值-base)*exaggeration+offset，平面基准且不贴地形。仅支持 EPSG:3857 地图中的静态实线图层及其普通颜色、线宽、透明度样式；全层字段须为有限数字，先完整校验再应用。null 清除并恢复默认高度" }, { "name": "map.layers.classify", "native": "host.map-write", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "uuid", "tsType": "MapLayerRef", "type": "string" }, { "tsType": "ClassificationOptions", "type": "object" } ], "type": "array" }, "permission": "map.write", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "ClassificationSummary", "summary": "按完整源数据生成确定分类颜色与图例" }, { "name": "map.layers.setVertexHeight", "native": "host.map-write", "parameters": { "items": false, "maxItems": 2, "minItems": 1, "prefixItems": [ { "format": "uuid", "tsType": "MapLayerRef", "type": "string" }, { "anyOf": [ { "type": "null" }, { "additionalProperties": false, "properties": { "base": { "default": 0, "type": "number" }, "exaggeration": { "default": 1, "maximum": 1000, "minimum": 0, "type": "number" }, "offset": { "default": 0, "type": "number" } }, "type": "object" } ], "default": {}, "tsType": "VertexHeightOptions | null" } ], "type": "array" }, "permission": "map.write", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "VertexHeightSummary", "summary": "按三维线各顶点的米制高程设置显示高度，沿线起伏且不修改源几何；支持 Web 墨卡托静态实线，先完整校验后应用，显示期间源线只读，null 清除高度" }, { "name": "map.layers.clearClassification", "native": "host.map-write", "parameters": { "items": false, "maxItems": 1, "minItems": 1, "prefixItems": [ { "format": "uuid", "tsType": "MapLayerRef", "type": "string" } ], "type": "array" }, "permission": "map.write", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "void", "summary": "清除分类并恢复之前的颜色样式" }, { "name": "map.layers.legend", "native": "host.map-read", "parameters": { "items": false, "maxItems": 2, "minItems": 1, "prefixItems": [ { "format": "uuid", "tsType": "MapLayerRef", "type": "string" }, { "additionalProperties": false, "default": {}, "properties": { "cursor": { "format": "uuid", "type": "string" }, "limit": { "default": 20, "maximum": 100, "minimum": 1, "type": "integer" } }, "tsType": "PageOptions", "type": "object" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation>", "returns": "Page", "summary": "分页读取完整源数据分类图例与业务代码说明" }, { "name": "map.layers.ready", "native": "host.map-read", "parameters": { "items": false, "maxItems": 2, "minItems": 1, "prefixItems": [ { "format": "uuid", "tsType": "MapLayerRef", "type": "string" }, { "additionalProperties": false, "default": {}, "properties": { "timeoutMs": { "maximum": 120000, "minimum": 0, "type": "integer" } }, "tsType": "LayerReadyOptions", "type": "object" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "MapLayerInfo", "summary": "等待图层在当前视野加载到位后返回图层状态；不代表整个数据集已加载，超时返回当前状态" }, { "name": "map.layers.setFilter", "native": "host.map-write", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "uuid", "tsType": "MapLayerRef", "type": "string" }, { "anyOf": [ { "type": "array" }, { "type": "boolean" }, { "type": "null" } ], "tsType": "Expression|boolean|null" } ], "type": "array" }, "permission": "map.write", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "void", "summary": "按类型化条件筛选显示，不修改源数据" }, { "name": "map.camera.fitLayer", "native": "host.map-write", "parameters": { "items": false, "maxItems": 2, "minItems": 1, "prefixItems": [ { "format": "uuid", "tsType": "MapLayerRef", "type": "string" }, { "default": {}, "tsType": "CameraFitOptions", "type": "object" } ], "type": "array" }, "permission": "map.write", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "void", "summary": "定位到显示图层范围" }, { "name": "map.camera.fitLayers", "native": "host.map-write", "parameters": { "items": false, "maxItems": 2, "minItems": 1, "prefixItems": [ { "items": { "format": "uuid", "type": "string" }, "maxItems": 64, "minItems": 1, "tsType": "MapLayerRef[]", "type": "array" }, { "default": {}, "tsType": "CameraFitOptions", "type": "object" } ], "type": "array" }, "permission": "map.write", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "void", "summary": "定位到多个指定显示图层的合并范围" }, { "name": "map.camera.fitFeature", "native": "host.map-write", "parameters": { "items": false, "maxItems": 2, "minItems": 1, "prefixItems": [ { "format": "uuid", "tsType": "FeatureRef", "type": "string" }, { "default": {}, "tsType": "CameraFitOptions", "type": "object" } ], "type": "array" }, "permission": "map.write", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "void", "summary": "定位到本次任务的单个真实要素" }, { "name": "map.camera.state", "native": "host.map-read", "parameters": { "items": false, "maxItems": 0, "minItems": 0, "prefixItems": [], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "CameraState", "summary": "读取明确的坐标系和每逻辑像素分辨率" }, { "name": "map.camera.setView", "native": "host.map-write", "parameters": { "items": false, "maxItems": 1, "minItems": 1, "prefixItems": [ { "tsType": "CameraViewOptions", "type": "object" } ], "type": "array" }, "permission": "map.write", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "void", "summary": "设置中心、分辨率或 EPSG:3857 标准 zoom，以及三维俯仰 pitch 与方位 bearing；pitch>0 自动进入三维视图" }, { "name": "map.camera.fitBounds", "native": "host.map-write", "parameters": { "items": false, "maxItems": 2, "minItems": 1, "prefixItems": [ { "anyOf": [ { "type": "object" }, { "items": { "type": "number" }, "maxItems": 4, "minItems": 4, "type": "array" } ], "tsType": "ViewBounds | [number,number,number,number]" }, { "default": {}, "tsType": "CameraFitOptions", "type": "object" } ], "type": "array" }, "permission": "map.write", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "void", "summary": "将 WGS84/Web Mercator 范围转换到当前视图后定位；可直接传 [minX,minY,maxX,maxY]（按 WGS84）" }, { "name": "map.camera.fitAll", "native": "host.map-write", "parameters": { "items": false, "maxItems": 1, "minItems": 0, "prefixItems": [ { "default": {}, "tsType": "CameraFitOptions", "type": "object" } ], "type": "array" }, "permission": "map.write", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "void", "summary": "定位到全部可见图层" }, { "name": "map.lighting.state", "native": "host.map-read", "parameters": { "items": false, "maxItems": 0, "minItems": 0, "prefixItems": [], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "web" ], "return_type": "Operation", "returns": "SceneLightingState", "summary": "读取地球仪与三维建筑视图的光照设置" }, { "name": "map.lighting.set", "native": "host.map-write", "parameters": { "items": false, "maxItems": 1, "minItems": 1, "prefixItems": [ { "additionalProperties": false, "properties": { "ambient": { "maximum": 1, "minimum": 0, "type": "number" }, "azimuth": { "maximum": 360, "minimum": 0, "type": "number" }, "elevation": { "maximum": 90, "minimum": -10, "type": "number" }, "mode": { "enum": [ "default", "fixed", "sun" ] }, "reset": { "type": "boolean" }, "strength": { "maximum": 2, "minimum": 0, "type": "number" }, "sunTime": { "anyOf": [ { "enum": [ "now" ] }, { "maximum": 253402300799999.0, "minimum": -62135596800000.0, "type": "number" } ], "tsType": "'now'|number" }, "utcOffsetMinutes": { "maximum": 840, "minimum": -720, "type": "integer" }, "view": { "enum": [ "globe", "building" ] } }, "tsType": "SceneLightingOptions", "type": "object" } ], "type": "array" }, "permission": "map.write", "platforms": [ "desktop", "web" ], "return_type": "Operation", "returns": "SceneLightingState", "summary": "调整地球仪或三维建筑视图的光照方向、强度、背光亮度与太阳时间" }, { "name": "map.camera.focusWgs84", "native": "host.map-write", "parameters": { "items": false, "maxItems": 2, "minItems": 1, "prefixItems": [ { "items": { "type": "number" }, "maxItems": 2, "minItems": 2, "tsType": "[number,number]", "type": "array" }, { "default": {}, "tsType": "{zoom?:number}", "type": "object" } ], "type": "array" }, "permission": "map.write", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "void", "summary": "定位经纬度，可在 Web Mercator 视图指定标准 zoom" }, { "name": "map.features.selection", "native": "host.map-read", "parameters": { "items": false, "maxItems": 0, "minItems": 0, "prefixItems": [], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "FeatureRef | ClusterRef | null", "summary": "读取当前主选要素的版本快照" }, { "name": "map.features.selectionSet", "native": "host.map-read", "parameters": { "items": false, "maxItems": 0, "minItems": 0, "prefixItems": [], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "FeatureSetRef | null", "summary": "读取当前单一数据集的多选快照" }, { "name": "map.features.clearSelection", "native": "host.map-write", "parameters": { "items": false, "maxItems": 0, "minItems": 0, "prefixItems": [], "type": "array" }, "permission": "map.write", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "void", "summary": "清除当前要素选择" }, { "name": "map.features.select", "native": "host.map-write", "parameters": { "items": false, "maxItems": 1, "minItems": 1, "prefixItems": [ { "format": "uuid", "tsType": "FeatureRef", "type": "string" } ], "type": "array" }, "permission": "map.write", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "void", "summary": "以指定版本要素替换当前选择" }, { "name": "map.features.selectSet", "native": "host.map-write", "parameters": { "items": false, "maxItems": 1, "minItems": 1, "prefixItems": [ { "format": "uuid", "tsType": "FeatureSetRef", "type": "string" } ], "type": "array" }, "permission": "map.write", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "void", "summary": "以指定版本集合替换当前选择" }, { "name": "map.features.get", "native": "host.map-read", "parameters": { "items": false, "maxItems": 2, "minItems": 1, "prefixItems": [ { "format": "uuid", "tsType": "FeatureRef", "type": "string" }, { "additionalProperties": false, "default": {}, "properties": { "fields": { "items": { "type": "string" }, "maxItems": 64, "type": "array" }, "geometry": { "enum": [ "none", "bounds", "geojson" ], "type": "string" } }, "tsType": "FeatureReadOptions", "type": "object" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "FeatureResult", "summary": "读取有界的类型化要素详情" }, { "name": "map.features.query", "native": "host.map-read", "parameters": { "items": false, "maxItems": 1, "minItems": 1, "prefixItems": [ { "additionalProperties": false, "properties": { "box": { "items": { "type": "number" }, "maxItems": 4, "minItems": 4, "type": "array" }, "cursor": { "format": "uuid", "type": "string" }, "layers": { "items": { "format": "uuid", "type": "string" }, "maxItems": 64, "type": "array" }, "limit": { "maximum": 100, "minimum": 1, "type": "integer" }, "point": { "items": { "type": "number" }, "maxItems": 2, "minItems": 2, "type": "array" }, "where": { "anyOf": [ { "type": "array" }, { "type": "boolean" } ] } }, "tsType": "MapFeatureQueryOptions", "type": "object" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation>", "returns": "Page", "summary": "按地图内容区逻辑像素查询可见要素" }, { "name": "history.state", "native": "host.map-read", "parameters": { "items": false, "maxItems": 0, "minItems": 0, "prefixItems": [], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "EditHistoryState", "summary": "读取工作台统一编辑历史状态" }, { "name": "history.undo", "native": "edit.prepare", "parameters": { "items": false, "maxItems": 0, "minItems": 0, "prefixItems": [], "type": "array" }, "permission": "data.edit", "platforms": [ "desktop", "mobile" ], "return_type": "ChangePlan", "returns": "ChangePlan", "summary": "预演撤销或重做，确认时核对历史版本" }, { "name": "history.redo", "native": "edit.prepare", "parameters": { "items": false, "maxItems": 0, "minItems": 0, "prefixItems": [], "type": "array" }, "permission": "data.edit", "platforms": [ "desktop", "mobile" ], "return_type": "ChangePlan", "returns": "ChangePlan", "summary": "预演撤销或重做，确认时核对历史版本" }, { "name": "query.parts", "native": "data.query", "parameters": { "items": false, "maxItems": 2, "minItems": 1, "prefixItems": [ { "format": "uuid", "tsType": "FeatureRef", "type": "string" }, { "additionalProperties": false, "default": {}, "properties": { "cursor": { "format": "uuid", "type": "string" }, "limit": { "maximum": 1000, "minimum": 1, "type": "integer" } }, "tsType": "PageOptions", "type": "object" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile" ], "return_type": "Operation>", "returns": "Page", "summary": "按版本分页读取部件与顶点，闭合末尾不重复编号" }, { "name": "query.vertices", "native": "data.query", "parameters": { "items": false, "maxItems": 2, "minItems": 1, "prefixItems": [ { "format": "uuid", "tsType": "FeatureRef", "type": "string" }, { "additionalProperties": false, "default": {}, "properties": { "cursor": { "format": "uuid", "type": "string" }, "limit": { "maximum": 1000, "minimum": 1, "type": "integer" } }, "tsType": "PageOptions", "type": "object" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile" ], "return_type": "Operation>", "returns": "Page", "summary": "按版本分页读取部件与顶点，闭合末尾不重复编号" }, { "name": "topology.checkOverlaps", "native": "data.query", "parameters": { "items": false, "maxItems": 2, "minItems": 1, "prefixItems": [ { "format": "uuid", "tsType": "DatasetRef | MapLayerRef | FeatureSetRef", "type": "string" }, { "default": {}, "tsType": "TopologyCheckOptions", "type": "object" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile" ], "return_type": "Operation", "returns": "TopologyReportRef", "summary": "检查拓扑并返回绑定数据版本的可分页报告" }, { "name": "topology.checkGaps", "native": "data.query", "parameters": { "items": false, "maxItems": 2, "minItems": 1, "prefixItems": [ { "format": "uuid", "tsType": "DatasetRef | MapLayerRef | FeatureSetRef", "type": "string" }, { "default": {}, "tsType": "TopologyCheckOptions", "type": "object" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile" ], "return_type": "Operation", "returns": "TopologyReportRef", "summary": "检查拓扑并返回绑定数据版本的可分页报告" }, { "name": "topology.checkSpikes", "native": "data.query", "parameters": { "items": false, "maxItems": 2, "minItems": 1, "prefixItems": [ { "format": "uuid", "tsType": "DatasetRef | MapLayerRef | FeatureSetRef", "type": "string" }, { "default": {}, "tsType": "TopologyCheckOptions", "type": "object" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile" ], "return_type": "Operation", "returns": "TopologyReportRef", "summary": "检查拓扑并返回绑定数据版本的可分页报告" }, { "name": "topology.checkKinks", "native": "data.query", "parameters": { "items": false, "maxItems": 2, "minItems": 1, "prefixItems": [ { "format": "uuid", "tsType": "DatasetRef | MapLayerRef | FeatureSetRef", "type": "string" }, { "default": {}, "tsType": "TopologyCheckOptions", "type": "object" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile" ], "return_type": "Operation", "returns": "TopologyReportRef", "summary": "检查拓扑并返回绑定数据版本的可分页报告" }, { "name": "topology.repair", "native": "edit.prepare", "parameters": { "items": false, "maxItems": 2, "minItems": 1, "prefixItems": [ { "format": "uuid", "tsType": "TopologyReportRef", "type": "string" }, { "default": {}, "tsType": "TopologyRepairOptions", "type": "object" } ], "type": "array" }, "permission": "data.edit", "platforms": [ "desktop", "mobile" ], "return_type": "ChangePlan", "returns": "ChangePlan", "summary": "预演指定问题修复并自动复检，默认生成独立成果" }, { "name": "geometry.snap", "native": "analysis.geometry", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "tsType": "Coordinate", "type": "object" }, { "tsType": "SnapOptions", "type": "object" } ], "type": "array" }, "permission": "analysis.execute", "platforms": [ "desktop", "mobile" ], "return_type": "Operation", "returns": "SnapResult", "summary": "在明确米制投影中计算几何辅助结果" }, { "name": "geometry.trace", "native": "analysis.geometry", "parameters": { "items": false, "maxItems": 1, "minItems": 1, "prefixItems": [ { "tsType": "TraceOptions", "type": "object" } ], "type": "array" }, "permission": "analysis.execute", "platforms": [ "desktop", "mobile" ], "return_type": "Operation", "returns": "DatasetRef", "summary": "在明确米制投影中计算几何辅助结果" }, { "name": "geometry.offset", "native": "analysis.geometry", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "tsType": "Coordinate", "type": "object" }, { "tsType": "OffsetOptions", "type": "object" } ], "type": "array" }, "permission": "analysis.execute", "platforms": [ "desktop", "mobile" ], "return_type": "Operation", "returns": "Coordinate", "summary": "在明确米制投影中计算几何辅助结果" }, { "name": "edit.addField", "native": "edit.prepare", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "uuid", "tsType": "MapLayerRef", "type": "string" }, { "additionalProperties": false, "properties": { "defaultValue": {}, "name": { "maxLength": 128, "minLength": 1, "type": "string" }, "type": { "enum": [ "string", "integer", "number", "boolean", "date" ], "type": "string" } }, "required": [ "name", "type" ], "tsType": "AddFieldOptions", "type": "object" } ], "type": "array" }, "permission": "data.edit", "platforms": [ "desktop", "mobile" ], "return_type": "ChangePlan", "returns": "ChangePlan", "summary": "预演数据修改，确认后原子提交并同步关联显示" }, { "name": "edit.renameField", "native": "edit.prepare", "parameters": { "items": false, "maxItems": 3, "minItems": 3, "prefixItems": [ { "format": "uuid", "tsType": "MapLayerRef", "type": "string" }, { "maxLength": 128, "minLength": 1, "type": "string" }, { "maxLength": 128, "minLength": 1, "type": "string" } ], "type": "array" }, "permission": "data.edit", "platforms": [ "desktop", "mobile" ], "return_type": "ChangePlan", "returns": "ChangePlan", "summary": "预演数据修改，确认后原子提交并同步关联显示" }, { "name": "edit.changeFieldType", "native": "edit.prepare", "parameters": { "items": false, "maxItems": 3, "minItems": 3, "prefixItems": [ { "format": "uuid", "tsType": "MapLayerRef", "type": "string" }, { "maxLength": 128, "minLength": 1, "type": "string" }, { "enum": [ "string", "integer", "number", "boolean", "date" ], "type": "string" } ], "type": "array" }, "permission": "data.edit", "platforms": [ "desktop", "mobile" ], "return_type": "ChangePlan", "returns": "ChangePlan", "summary": "预演数据修改，确认后原子提交并同步关联显示" }, { "name": "edit.deleteField", "native": "edit.prepare", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "uuid", "tsType": "MapLayerRef", "type": "string" }, { "maxLength": 128, "minLength": 1, "type": "string" } ], "type": "array" }, "permission": "data.edit", "platforms": [ "desktop", "mobile" ], "return_type": "ChangePlan", "returns": "ChangePlan", "summary": "预演数据修改，确认后原子提交并同步关联显示" }, { "name": "edit.setAttribute", "native": "edit.prepare", "parameters": { "items": false, "maxItems": 3, "minItems": 3, "prefixItems": [ { "format": "uuid", "tsType": "FeatureRef", "type": "string" }, { "maxLength": 128, "minLength": 1, "type": "string" }, {} ], "type": "array" }, "permission": "data.edit", "platforms": [ "desktop", "mobile" ], "return_type": "ChangePlan", "returns": "ChangePlan", "summary": "预演数据修改，确认后原子提交并同步关联显示" }, { "name": "edit.setValues", "native": "edit.prepare", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "uuid", "tsType": "MapLayerRef", "type": "string" }, { "required": [ "field", "value" ], "tsType": "SetValuesOptions", "type": "object" } ], "type": "array" }, "permission": "data.edit", "platforms": [ "desktop", "mobile" ], "return_type": "ChangePlan", "returns": "ChangePlan", "summary": "预演数据修改，确认后原子提交并同步关联显示" }, { "name": "edit.fillMissing", "native": "edit.prepare", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "uuid", "tsType": "MapLayerRef", "type": "string" }, { "required": [ "field", "value" ], "tsType": "SetValuesOptions", "type": "object" } ], "type": "array" }, "permission": "data.edit", "platforms": [ "desktop", "mobile" ], "return_type": "ChangePlan", "returns": "ChangePlan", "summary": "预演数据修改，确认后原子提交并同步关联显示" }, { "name": "edit.trimValues", "native": "edit.prepare", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "uuid", "tsType": "MapLayerRef", "type": "string" }, { "required": [ "field" ], "tsType": "FieldScopeOptions", "type": "object" } ], "type": "array" }, "permission": "data.edit", "platforms": [ "desktop", "mobile" ], "return_type": "ChangePlan", "returns": "ChangePlan", "summary": "预演数据修改，确认后原子提交并同步关联显示" }, { "name": "edit.replaceValue", "native": "edit.prepare", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "uuid", "tsType": "MapLayerRef", "type": "string" }, { "required": [ "field", "oldValue", "newValue" ], "tsType": "ReplaceValueOptions", "type": "object" } ], "type": "array" }, "permission": "data.edit", "platforms": [ "desktop", "mobile" ], "return_type": "ChangePlan", "returns": "ChangePlan", "summary": "预演数据修改，确认后原子提交并同步关联显示" }, { "name": "edit.calculateField", "native": "edit.prepare", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "uuid", "tsType": "MapLayerRef", "type": "string" }, { "required": [ "targetField", "expression" ], "tsType": "FieldCalculatorOptions", "type": "object" } ], "type": "array" }, "permission": "data.edit", "platforms": [ "desktop", "mobile" ], "return_type": "ChangePlan", "returns": "ChangePlan", "summary": "预演数据修改，确认后原子提交并同步关联显示" }, { "name": "edit.removeEmptyGeometries", "native": "edit.prepare", "parameters": { "items": false, "maxItems": 1, "minItems": 1, "prefixItems": [ { "format": "uuid", "tsType": "MapLayerRef", "type": "string" } ], "type": "array" }, "permission": "data.edit", "platforms": [ "desktop", "mobile" ], "return_type": "ChangePlan", "returns": "ChangePlan", "summary": "预演数据修改，确认后原子提交并同步关联显示" }, { "name": "edit.deleteFeatures", "native": "edit.prepare", "parameters": { "items": false, "maxItems": 1, "minItems": 1, "prefixItems": [ { "anyOf": [ { "format": "uuid", "type": "string" }, { "items": { "format": "uuid", "type": "string" }, "maxItems": 256, "minItems": 1, "type": "array" } ], "tsType": "FeatureSetRef | FeatureRef | FeatureRef[]" } ], "type": "array" }, "permission": "data.edit", "platforms": [ "desktop", "mobile" ], "return_type": "ChangePlan", "returns": "ChangePlan", "summary": "预演数据修改，确认后原子提交并同步关联显示" }, { "name": "edit.moveVertex", "native": "edit.prepare", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "uuid", "tsType": "FeatureRef", "type": "string" }, { "required": [ "partIndex", "vertexIndex", "coordinate" ], "tsType": "VertexMoveOptions", "type": "object" } ], "type": "array" }, "permission": "data.edit", "platforms": [ "desktop", "mobile" ], "return_type": "ChangePlan", "returns": "ChangePlan", "summary": "预演显式目标的几何修改，确认后同步共享数据与显示" }, { "name": "edit.insertVertex", "native": "edit.prepare", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "uuid", "tsType": "FeatureRef", "type": "string" }, { "required": [ "partIndex", "afterVertexIndex", "coordinate" ], "tsType": "VertexInsertOptions", "type": "object" } ], "type": "array" }, "permission": "data.edit", "platforms": [ "desktop", "mobile" ], "return_type": "ChangePlan", "returns": "ChangePlan", "summary": "预演显式目标的几何修改，确认后同步共享数据与显示" }, { "name": "edit.deleteVertex", "native": "edit.prepare", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "uuid", "tsType": "FeatureRef", "type": "string" }, { "required": [ "partIndex", "vertexIndex" ], "tsType": "VertexDeleteOptions", "type": "object" } ], "type": "array" }, "permission": "data.edit", "platforms": [ "desktop", "mobile" ], "return_type": "ChangePlan", "returns": "ChangePlan", "summary": "预演显式目标的几何修改，确认后同步共享数据与显示" }, { "name": "edit.replaceGeometry", "native": "edit.prepare", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "uuid", "tsType": "FeatureRef", "type": "string" }, { "tsType": "GeoJSON", "type": "object" } ], "type": "array" }, "permission": "data.edit", "platforms": [ "desktop", "mobile" ], "return_type": "ChangePlan", "returns": "ChangePlan", "summary": "预演显式目标的几何修改，确认后同步共享数据与显示" }, { "name": "edit.translate", "native": "edit.prepare", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "uuid", "tsType": "FeatureSetRef", "type": "string" }, { "required": [ "dx", "dy", "crs" ], "tsType": "TranslateOptions", "type": "object" } ], "type": "array" }, "permission": "data.edit", "platforms": [ "desktop", "mobile" ], "return_type": "ChangePlan", "returns": "ChangePlan", "summary": "预演显式目标的几何修改，确认后同步共享数据与显示" }, { "name": "edit.addFeatures", "native": "edit.prepare", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "uuid", "tsType": "MapLayerRef", "type": "string" }, { "anyOf": [ { "type": "object" }, { "format": "uuid", "type": "string" } ], "tsType": "GeoJSON | FeatureSetRef" } ], "type": "array" }, "permission": "data.edit", "platforms": [ "desktop", "mobile" ], "return_type": "ChangePlan", "returns": "ChangePlan", "summary": "预演显式目标的几何修改，确认后同步共享数据与显示" }, { "name": "edit.replaceDataset", "native": "edit.prepare", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "uuid", "tsType": "MapLayerRef", "type": "string" }, { "format": "uuid", "tsType": "DatasetRef", "type": "string" } ], "type": "array" }, "permission": "data.edit", "platforms": [ "desktop", "mobile" ], "return_type": "ChangePlan", "returns": "ChangePlan", "summary": "预演显式目标的几何修改，确认后同步共享数据与显示" }, { "name": "edit.mergeFeatures", "native": "edit.prepare", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "uuid", "tsType": "FeatureSetRef", "type": "string" }, { "tsType": "MergeFeatureOptions", "type": "object" } ], "type": "array" }, "permission": "data.edit", "platforms": [ "desktop", "mobile" ], "return_type": "ChangePlan", "returns": "ChangePlan", "summary": "预演显式目标的专项几何修改，确认后提交统一历史" }, { "name": "edit.fillHoles", "native": "edit.prepare", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "uuid", "tsType": "FeatureRef", "type": "string" }, { "tsType": "FillHoleOptions", "type": "object" } ], "type": "array" }, "permission": "data.edit", "platforms": [ "desktop", "mobile" ], "return_type": "ChangePlan", "returns": "ChangePlan", "summary": "预演显式目标的专项几何修改，确认后提交统一历史" }, { "name": "edit.removeHole", "native": "edit.prepare", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "uuid", "tsType": "FeatureRef", "type": "string" }, { "tsType": "RemoveHoleOptions", "type": "object" } ], "type": "array" }, "permission": "data.edit", "platforms": [ "desktop", "mobile" ], "return_type": "ChangePlan", "returns": "ChangePlan", "summary": "预演显式目标的专项几何修改，确认后提交统一历史" }, { "name": "edit.clip", "native": "edit.prepare", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "uuid", "tsType": "FeatureSetRef", "type": "string" }, { "format": "uuid", "tsType": "FeatureLike", "type": "string" } ], "type": "array" }, "permission": "data.edit", "platforms": [ "desktop", "mobile" ], "return_type": "ChangePlan", "returns": "ChangePlan", "summary": "预演显式目标的专项几何修改，确认后提交统一历史" }, { "name": "edit.erase", "native": "edit.prepare", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "uuid", "tsType": "FeatureSetRef", "type": "string" }, { "format": "uuid", "tsType": "FeatureLike", "type": "string" } ], "type": "array" }, "permission": "data.edit", "platforms": [ "desktop", "mobile" ], "return_type": "ChangePlan", "returns": "ChangePlan", "summary": "预演显式目标的专项几何修改，确认后提交统一历史" }, { "name": "edit.split", "native": "edit.prepare", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "uuid", "tsType": "FeatureSetRef", "type": "string" }, { "format": "uuid", "tsType": "FeatureRef", "type": "string" } ], "type": "array" }, "permission": "data.edit", "platforms": [ "desktop", "mobile" ], "return_type": "ChangePlan", "returns": "ChangePlan", "summary": "预演显式目标的专项几何修改，确认后提交统一历史" }, { "name": "edit.shrink", "native": "edit.prepare", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "uuid", "tsType": "FeatureRef", "type": "string" }, { "format": "uuid", "tsType": "FeatureRef", "type": "string" } ], "type": "array" }, "permission": "data.edit", "platforms": [ "desktop", "mobile" ], "return_type": "ChangePlan", "returns": "ChangePlan", "summary": "预演显式目标的专项几何修改，确认后提交统一历史" }, { "name": "edit.expand", "native": "edit.prepare", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "uuid", "tsType": "FeatureRef", "type": "string" }, { "format": "uuid", "tsType": "FeatureRef", "type": "string" } ], "type": "array" }, "permission": "data.edit", "platforms": [ "desktop", "mobile" ], "return_type": "ChangePlan", "returns": "ChangePlan", "summary": "预演显式目标的专项几何修改，确认后提交统一历史" }, { "name": "edit.reshape", "native": "edit.prepare", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "uuid", "tsType": "FeatureRef", "type": "string" }, { "tsType": "ReshapeOptions", "type": "object" } ], "type": "array" }, "permission": "data.edit", "platforms": [ "desktop", "mobile" ], "return_type": "ChangePlan", "returns": "ChangePlan", "summary": "预演显式目标的专项几何修改，确认后提交统一历史" }, { "name": "edit.bufferAdjust", "native": "edit.prepare", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "uuid", "tsType": "FeatureRef", "type": "string" }, { "tsType": "BufferAdjustOptions", "type": "object" } ], "type": "array" }, "permission": "data.edit", "platforms": [ "desktop", "mobile" ], "return_type": "ChangePlan", "returns": "ChangePlan", "summary": "预演显式目标的专项几何修改，确认后提交统一历史" }, { "name": "edit.explodeParts", "native": "edit.prepare", "parameters": { "items": false, "maxItems": 1, "minItems": 1, "prefixItems": [ { "format": "uuid", "tsType": "FeatureRef", "type": "string" } ], "type": "array" }, "permission": "data.edit", "platforms": [ "desktop", "mobile" ], "return_type": "ChangePlan", "returns": "ChangePlan", "summary": "把多部件面拆为独立要素，保留内洞和属性" }, { "name": "analysis.clip", "native": "analysis.geometry", "parameters": { "items": false, "maxItems": 3, "minItems": 2, "prefixItems": [ { "format": "uuid", "tsType": "DatasetRef | FeatureSetRef | MapLayerRef", "type": "string" }, { "format": "uuid", "tsType": "DatasetRef | FeatureRef | FeatureSetRef", "type": "string" }, { "additionalProperties": false, "default": {}, "properties": { "addToMap": { "type": "boolean" }, "name": { "maxLength": 128, "minLength": 1, "type": "string" }, "scope": { "enum": [ "all", "filtered" ], "type": "string" } }, "tsType": "ResultOptions", "type": "object" } ], "type": "array" }, "permission": "analysis.execute", "platforms": [ "desktop", "mobile" ], "return_type": "Operation", "returns": "DatasetRef", "summary": "按明确的面边界裁剪线或面，并生成独立成果" }, { "name": "analysis.erase", "native": "analysis.geometry", "parameters": { "items": false, "maxItems": 3, "minItems": 2, "prefixItems": [ { "format": "uuid", "tsType": "DatasetRef | FeatureSetRef | MapLayerRef", "type": "string" }, { "format": "uuid", "tsType": "DatasetRef | FeatureRef | FeatureSetRef", "type": "string" }, { "additionalProperties": false, "default": {}, "properties": { "addToMap": { "type": "boolean" }, "name": { "maxLength": 128, "minLength": 1, "type": "string" }, "scope": { "enum": [ "all", "filtered" ], "type": "string" } }, "tsType": "ResultOptions", "type": "object" } ], "type": "array" }, "permission": "analysis.execute", "platforms": [ "desktop", "mobile" ], "return_type": "Operation", "returns": "DatasetRef", "summary": "按明确的面边界擦除并生成独立成果" }, { "name": "analysis.split", "native": "analysis.geometry", "parameters": { "items": false, "maxItems": 3, "minItems": 2, "prefixItems": [ { "format": "uuid", "tsType": "DatasetRef | FeatureSetRef | MapLayerRef", "type": "string" }, { "format": "uuid", "tsType": "FeatureRef | FeatureSetRef", "type": "string" }, { "additionalProperties": false, "default": {}, "properties": { "addToMap": { "type": "boolean" }, "name": { "maxLength": 128, "minLength": 1, "type": "string" }, "scope": { "enum": [ "all", "filtered" ], "type": "string" } }, "tsType": "ResultOptions", "type": "object" } ], "type": "array" }, "permission": "analysis.execute", "platforms": [ "desktop", "mobile" ], "return_type": "Operation", "returns": "DatasetRef", "summary": "按面边界划分内外成果" }, { "name": "analysis.merge", "native": "analysis.geometry", "parameters": { "items": false, "maxItems": 2, "minItems": 1, "prefixItems": [ { "format": "uuid", "tsType": "DatasetRef | FeatureSetRef | MapLayerRef", "type": "string" }, { "additionalProperties": false, "default": {}, "properties": { "addToMap": { "type": "boolean" }, "name": { "maxLength": 128, "minLength": 1, "type": "string" }, "scope": { "enum": [ "all", "filtered" ], "type": "string" } }, "tsType": "ResultOptions", "type": "object" } ], "type": "array" }, "permission": "analysis.execute", "platforms": [ "desktop", "mobile" ], "return_type": "Operation", "returns": "DatasetRef", "summary": "融合所选面并生成无继承属性的独立成果" }, { "name": "analysis.makeValid", "native": "analysis.geometry", "parameters": { "items": false, "maxItems": 2, "minItems": 1, "prefixItems": [ { "format": "uuid", "tsType": "DatasetRef | FeatureSetRef | MapLayerRef", "type": "string" }, { "additionalProperties": false, "default": {}, "properties": { "addToMap": { "type": "boolean" }, "name": { "maxLength": 128, "minLength": 1, "type": "string" }, "scope": { "enum": [ "all", "filtered" ], "type": "string" } }, "tsType": "ResultOptions", "type": "object" } ], "type": "array" }, "permission": "analysis.execute", "platforms": [ "desktop", "mobile" ], "return_type": "Operation", "returns": "DatasetRef", "summary": "修复几何有效性并生成独立成果" }, { "name": "analysis.simplify", "native": "analysis.geometry", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "uuid", "tsType": "DatasetRef | FeatureSetRef | MapLayerRef", "type": "string" }, { "additionalProperties": false, "properties": { "addToMap": { "type": "boolean" }, "name": { "maxLength": 128, "minLength": 1, "type": "string" }, "preserveTopology": { "type": "boolean" }, "scope": { "enum": [ "all", "filtered" ], "type": "string" }, "tolerance": { "additionalProperties": false, "properties": { "unit": { "enum": [ "mm", "cm", "m", "km" ], "type": "string" }, "value": { "exclusiveMinimum": 0, "type": "number" } }, "required": [ "value", "unit" ], "type": "object" } }, "required": [ "tolerance" ], "tsType": "SimplifyOptions", "type": "object" } ], "type": "array" }, "permission": "analysis.execute", "platforms": [ "desktop", "mobile" ], "return_type": "Operation", "returns": "DatasetRef", "summary": "在适用米制投影中简化几何" }, { "name": "analysis.extractBoundary", "native": "analysis.geometry", "parameters": { "items": false, "maxItems": 2, "minItems": 1, "prefixItems": [ { "format": "uuid", "tsType": "DatasetRef | FeatureSetRef | MapLayerRef", "type": "string" }, { "additionalProperties": false, "default": {}, "properties": { "addToMap": { "type": "boolean" }, "exteriorOnly": { "type": "boolean" }, "name": { "maxLength": 128, "minLength": 1, "type": "string" }, "scope": { "enum": [ "all", "filtered" ], "type": "string" } }, "tsType": "BoundaryOptions", "type": "object" } ], "type": "array" }, "permission": "analysis.execute", "platforms": [ "desktop", "mobile" ], "return_type": "Operation", "returns": "DatasetRef", "summary": "提取面边界为线成果" }, { "name": "analysis.intersect", "native": "analysis.geometry", "parameters": { "items": false, "maxItems": 3, "minItems": 3, "prefixItems": [ { "format": "uuid", "tsType": "DatasetRef | FeatureSetRef", "type": "string" }, { "format": "uuid", "tsType": "DatasetRef | FeatureSetRef", "type": "string" }, { "additionalProperties": false, "properties": { "fields": { "additionalProperties": false, "properties": { "left": { "additionalProperties": { "maxLength": 128, "minLength": 1, "type": "string" }, "type": "object" }, "right": { "additionalProperties": { "maxLength": 128, "minLength": 1, "type": "string" }, "type": "object" } }, "required": [ "left", "right" ], "type": "object" }, "name": { "maxLength": 128, "minLength": 1, "type": "string" }, "outputCrs": { "minLength": 1, "type": "string" }, "workingCrs": { "minLength": 1, "type": "string" } }, "required": [ "fields" ], "tsType": "IntersectOptions", "type": "object" } ], "type": "array" }, "permission": "analysis.execute", "platforms": [ "desktop", "mobile" ], "return_type": "Operation", "returns": "DatasetRef", "summary": "二维面逐对属性叠加求交；fields.left/right 显式指定源字段到输出别名，附 __leftIndex/__rightIndex 来源索引；仅边界接触返回空成果" }, { "name": "analysis.dissolve", "native": "analysis.geometry", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "uuid", "tsType": "DatasetRef | FeatureSetRef", "type": "string" }, { "additionalProperties": false, "properties": { "groupBy": { "items": { "maxLength": 128, "minLength": 1, "type": "string" }, "maxItems": 32, "type": "array" }, "name": { "maxLength": 128, "minLength": 1, "type": "string" }, "outputCrs": { "maxLength": 128, "minLength": 1, "type": "string" }, "workingCrs": { "maxLength": 128, "minLength": 1, "type": "string" } }, "required": [ "groupBy" ], "tsType": "DissolveOptions", "type": "object" } ], "type": "array" }, "permission": "analysis.execute", "platforms": [ "desktop", "mobile" ], "return_type": "Operation", "returns": "DatasetRef", "summary": "按字段融合有效二维面并消除组内重叠；groupBy 必填，空数组全体融合，只保留分组属性" }, { "name": "query.aggregate", "native": "data.query", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "uuid", "tsType": "DatasetRef | FeatureSetRef", "type": "string" }, { "additionalProperties": false, "properties": { "groupBy": { "items": { "maxLength": 128, "minLength": 1, "type": "string" }, "maxItems": 32, "type": "array" }, "measurementCrs": { "maxLength": 128, "minLength": 1, "type": "string" }, "measures": { "additionalProperties": { "anyOf": [ { "additionalProperties": false, "properties": { "op": { "enum": [ "count" ] } }, "required": [ "op" ], "type": "object" }, { "additionalProperties": false, "properties": { "field": { "maxLength": 128, "minLength": 1, "type": "string" }, "op": { "enum": [ "sum", "min", "max", "mean" ] } }, "required": [ "op", "field" ], "type": "object" }, { "additionalProperties": false, "properties": { "op": { "enum": [ "sumArea" ] }, "unit": { "enum": [ "m2", "ha", "mu", "km2" ] } }, "required": [ "op", "unit" ], "type": "object" }, { "additionalProperties": false, "properties": { "op": { "enum": [ "sumLength" ] }, "unit": { "enum": [ "mm", "cm", "m", "km" ] } }, "required": [ "op", "unit" ], "type": "object" } ] }, "type": "object" }, "name": { "maxLength": 128, "minLength": 1, "type": "string" } }, "required": [ "groupBy", "measures" ], "tsType": "AggregateOptions", "type": "object" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile" ], "return_type": "Operation", "returns": "TableRef", "summary": "按字段完整统计并返回不可变表格；groupBy 空数组为全体总计，measures 为输出别名对象；几何量算须指定适用 UTM 与单位" }, { "name": "query.spatialJoin", "native": "data.query", "parameters": { "items": false, "maxItems": 3, "minItems": 3, "prefixItems": [ { "format": "uuid", "tsType": "DatasetRef | FeatureSetRef", "type": "string" }, { "format": "uuid", "tsType": "DatasetRef | FeatureSetRef", "type": "string" }, { "additionalProperties": false, "properties": { "fields": { "additionalProperties": false, "properties": { "left": { "additionalProperties": { "maxLength": 128, "minLength": 1, "type": "string" }, "type": "object" }, "right": { "additionalProperties": { "maxLength": 128, "minLength": 1, "type": "string" }, "type": "object" } }, "required": [ "left", "right" ], "type": "object" }, "join": { "enum": [ "left", "inner" ] }, "match": { "enum": [ "all", "first" ] }, "name": { "maxLength": 128, "minLength": 1, "type": "string" }, "outputCrs": { "maxLength": 128, "minLength": 1, "type": "string" }, "relation": { "enum": [ "intersects", "within", "contains" ] }, "workingCrs": { "maxLength": 128, "minLength": 1, "type": "string" } }, "required": [ "relation", "join", "match", "fields" ], "tsType": "SpatialJoinOptions", "type": "object" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile" ], "return_type": "Operation", "returns": "DatasetRef", "summary": "按左相对右的空间关系关联，保留左几何；显式选择连接、匹配和字段别名，附输入快照来源索引" }, { "name": "query.nearest", "native": "data.query", "parameters": { "items": false, "maxItems": 3, "minItems": 3, "prefixItems": [ { "format": "uuid", "tsType": "DatasetRef | FeatureSetRef", "type": "string" }, { "format": "uuid", "tsType": "DatasetRef | FeatureSetRef", "type": "string" }, { "additionalProperties": false, "properties": { "k": { "maximum": 100, "minimum": 1, "type": "integer" }, "maxDistance": { "additionalProperties": false, "properties": { "unit": { "enum": [ "mm", "cm", "m", "km" ] }, "value": { "minimum": 0, "type": "number" } }, "required": [ "value", "unit" ], "type": "object" }, "measurementCrs": { "maxLength": 128, "minLength": 1, "type": "string" }, "name": { "maxLength": 128, "minLength": 1, "type": "string" }, "ties": { "enum": [ "all", "first" ] } }, "required": [ "k", "maxDistance", "measurementCrs", "ties" ], "tsType": "NearestOptions", "type": "object" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile" ], "return_type": "Operation", "returns": "TableRef", "summary": "按投影后几何最短距离匹配；阈值含边界，all 保留第 k 名并列，first 按右原始索引择优；返回表格距离为米" }, { "name": "raster.zonalStats", "native": "data.query", "parameters": { "items": false, "maxItems": 3, "minItems": 3, "prefixItems": [ { "format": "uuid", "tsType": "RasterRef", "type": "string" }, { "format": "uuid", "tsType": "DatasetRef | FeatureSetRef", "type": "string" }, { "additionalProperties": false, "properties": { "band": { "minimum": 1, "type": "integer" }, "name": { "maxLength": 128, "minLength": 1, "type": "string" }, "nodata": { "enum": [ "exclude" ] }, "pixelInclusion": { "enum": [ "center" ] }, "statistics": { "items": { "enum": [ "min", "max", "mean", "sum", "count" ] }, "maxItems": 5, "minItems": 1, "type": "array" }, "values": { "enum": [ "raw", "physical" ] }, "zoneIdField": { "maxLength": 128, "minLength": 1, "type": "string" } }, "required": [ "zoneIdField", "band", "statistics", "values", "nodata", "pixelInclusion" ], "tsType": "ZonalStatsOptions", "type": "object" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile" ], "return_type": "Operation", "returns": "TableRef", "summary": "按原始像元中心统计二维面分区；边界计入，重叠独立，排除无效像元；分区编号须唯一非空，返回表格" }, { "name": "data.reproject", "native": "data.query", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "uuid", "tsType": "DatasetRef | FeatureSetRef", "type": "string" }, { "additionalProperties": false, "properties": { "name": { "maxLength": 128, "minLength": 1, "type": "string" }, "outputCrs": { "maxLength": 128, "minLength": 1, "type": "string" } }, "required": [ "outputCrs" ], "tsType": "ReprojectOptions", "type": "object" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile" ], "return_type": "Operation", "returns": "DatasetRef", "summary": "将二维数据真实转换到指定 EPSG 坐标系并保留字段和顺序，返回独立数据引用" }, { "name": "raster.warp", "native": "data.query", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "uuid", "tsType": "RasterRef", "type": "string" }, { "additionalProperties": false, "properties": { "cutline": { "format": "uuid", "tsType": "DatasetRef | FeatureSetRef", "type": "string" }, "dataKind": { "enum": [ "continuous", "categorical" ] }, "grid": { "additionalProperties": false, "properties": { "bounds": { "items": { "type": "number" }, "maxItems": 4, "minItems": 4, "type": "array" }, "height": { "maximum": 65536, "minimum": 1, "type": "integer" }, "width": { "maximum": 65536, "minimum": 1, "type": "integer" } }, "required": [ "bounds", "width", "height" ], "type": "object" }, "name": { "maxLength": 128, "minLength": 1, "type": "string" }, "outputCrs": { "maxLength": 128, "minLength": 1, "type": "string" }, "resampling": { "enum": [ "nearest", "bilinear" ] } }, "required": [ "outputCrs", "grid", "resampling", "dataKind" ], "tsType": "RasterWarpOptions", "type": "object" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile" ], "return_type": "Operation", "returns": "RasterRef", "summary": "按输出坐标系和显式网格转换全部波段；分类仅最近邻，原始数值及比例参数保留；结果为临时影像引用" }, { "name": "raster.readPixels", "native": "data.query", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "uuid", "tsType": "RasterRef", "type": "string" }, { "additionalProperties": false, "properties": { "band": { "minimum": 1, "type": "integer" }, "values": { "enum": [ "raw", "physical" ] }, "window": { "additionalProperties": false, "properties": { "height": { "maximum": 65536, "minimum": 1, "type": "integer" }, "width": { "maximum": 65536, "minimum": 1, "type": "integer" }, "xOffset": { "minimum": 0, "type": "integer" }, "yOffset": { "minimum": 0, "type": "integer" } }, "required": [ "xOffset", "yOffset", "width", "height" ], "type": "object" } }, "required": [ "band", "window", "values" ], "tsType": "ReadPixelsOptions", "type": "object" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile" ], "return_type": "Operation", "returns": "PixelBlock", "summary": "按源网格读取有限窗口：波段从1、偏移从0开始，不裁短越界窗口；raw原值或physical比例转换，无效值为null，最多4096像元及60KiB" }, { "name": "query.sql", "native": "data.query", "parameters": { "items": false, "maxItems": 1, "minItems": 1, "prefixItems": [ { "additionalProperties": false, "properties": { "bindings": { "items": { "anyOf": [ { "type": "null" }, { "maxLength": 1048576, "type": "string" }, { "type": "boolean" }, { "type": "number" } ] }, "maxItems": 256, "type": "array" }, "dialect": { "enum": [ "sqlite" ] }, "name": { "maxLength": 128, "minLength": 1, "type": "string" }, "result": { "anyOf": [ { "additionalProperties": false, "properties": { "type": { "enum": [ "table" ] } }, "required": [ "type" ], "type": "object" }, { "additionalProperties": false, "properties": { "crs": { "maxLength": 128, "minLength": 1, "type": "string" }, "geometryColumn": { "maxLength": 128, "minLength": 1, "type": "string" }, "type": { "enum": [ "features" ] } }, "required": [ "type", "geometryColumn", "crs" ], "type": "object" } ] }, "sources": { "additionalProperties": { "format": "uuid", "tsType": "DatasetRef | FeatureSetRef | TableRef", "type": "string" }, "type": "object" }, "text": { "maxLength": 65536, "minLength": 1, "type": "string" } }, "required": [ "text", "sources", "bindings", "dialect", "result" ], "tsType": "SqlOptions", "type": "object" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile" ], "return_type": "Operation", "returns": "TableRef | DatasetRef", "summary": "对已有数据引用执行本地只读查询；匿名位置绑定，显式选择表格或原坐标系空间成果，不支持远程方言" }, { "name": "raster.hillshade", "native": "analysis.geometry", "parameters": { "items": false, "maxItems": 2, "minItems": 1, "prefixItems": [ { "format": "uuid", "tsType": "RasterRef", "type": "string" }, { "additionalProperties": false, "default": {}, "properties": { "addToMap": { "type": "boolean" }, "altitude": { "exclusiveMinimum": 0, "maximum": 90, "type": "number" }, "azimuth": { "maximum": 360, "minimum": 0, "type": "number" }, "unit": { "enum": [ "m", "ft" ] }, "verticalReference": { "maxLength": 160, "minLength": 1, "type": "string" } }, "required": [], "tsType": "HillshadeAnalysisOptions", "type": "object" } ], "type": "array" }, "permission": "analysis.execute", "platforms": [ "desktop", "mobile" ], "return_type": "Operation", "returns": "RasterRef", "summary": "由投影米制 DEM 生成晕渲影像临时成果，不改写源文件" }, { "name": "raster.slope", "native": "analysis.geometry", "parameters": { "items": false, "maxItems": 2, "minItems": 1, "prefixItems": [ { "format": "uuid", "tsType": "RasterRef", "type": "string" }, { "additionalProperties": false, "default": {}, "properties": { "addToMap": { "type": "boolean" }, "unit": { "enum": [ "m", "ft" ] }, "verticalReference": { "maxLength": 160, "minLength": 1, "type": "string" } }, "required": [], "tsType": "DemAnalysisOptions", "type": "object" } ], "type": "array" }, "permission": "analysis.execute", "platforms": [ "desktop", "mobile" ], "return_type": "Operation", "returns": "RasterRef", "summary": "由投影米制 DEM 生成坡度影像（度）临时成果" }, { "name": "raster.aspect", "native": "analysis.geometry", "parameters": { "items": false, "maxItems": 2, "minItems": 1, "prefixItems": [ { "format": "uuid", "tsType": "RasterRef", "type": "string" }, { "additionalProperties": false, "default": {}, "properties": { "addToMap": { "type": "boolean" }, "unit": { "enum": [ "m", "ft" ] }, "verticalReference": { "maxLength": 160, "minLength": 1, "type": "string" } }, "required": [], "tsType": "DemAnalysisOptions", "type": "object" } ], "type": "array" }, "permission": "analysis.execute", "platforms": [ "desktop", "mobile" ], "return_type": "Operation", "returns": "RasterRef", "summary": "由投影米制 DEM 生成坡向影像（度，正北顺时针，平坦为无效值）临时成果" }, { "name": "raster.contours", "native": "analysis.geometry", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "uuid", "tsType": "RasterRef", "type": "string" }, { "additionalProperties": false, "properties": { "addToMap": { "type": "boolean" }, "interval": { "exclusiveMinimum": 0, "type": "number" }, "unit": { "enum": [ "m", "ft" ] }, "verticalReference": { "maxLength": 160, "minLength": 1, "type": "string" } }, "required": [ "interval" ], "tsType": "ContourAnalysisOptions", "type": "object" } ], "type": "array" }, "permission": "analysis.execute", "platforms": [ "desktop", "mobile" ], "return_type": "Operation", "returns": "DatasetRef", "summary": "按米制等高距由 DEM 生成等高线矢量临时成果，高程字段为 ELEV_M" }, { "name": "export.raster", "native": "host.dataset-export", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "uuid", "tsType": "RasterRef", "type": "string" }, { "additionalProperties": false, "properties": { "overwrite": { "enum": [ "deny", "ask" ] }, "path": { "maxLength": 32768, "minLength": 1, "type": "string" } }, "required": [ "path" ], "tsType": "RasterExportOptions", "type": "object" } ], "type": "array" }, "permission": "export.write", "platforms": [ "desktop", "mobile" ], "return_type": "ChangePlan", "returns": "ChangePlan", "summary": "预演把栅格成果写出为 GeoTIFF，需宿主确认；单个文件不超过 64 MiB" }, { "name": "map.setTerrain", "native": "host.map-write", "parameters": { "items": false, "maxItems": 1, "minItems": 1, "prefixItems": [ { "anyOf": [ { "type": "null" }, { "additionalProperties": false, "properties": { "exaggeration": { "maximum": 20, "minimum": 0, "type": "number" }, "source": { "maxLength": 128, "minLength": 1, "type": "string" } }, "required": [ "source" ], "type": "object" } ], "tsType": "TerrainSpecification | null" } ], "type": "array" }, "permission": "map.write", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "TerrainState | TerrainSpecification | null", "summary": "以共同raster-dem开启墨卡托真实地形表面，夸张0..20，null关闭；桌面本地DEM入口保留，状态返回差异见指南" }, { "name": "map.getTerrain", "native": "host.map-read", "parameters": { "items": false, "maxItems": 0, "minItems": 0, "prefixItems": [], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "TerrainState | TerrainSpecification | null", "summary": "读取共同地形的source/exaggeration配置或桌面本地DEM状态；未开启为null，共同加载状态读getSourceInfo" }, { "name": "map.queryTerrainElevation", "native": "host.map-read", "parameters": { "items": false, "maxItems": 1, "minItems": 1, "prefixItems": [ { "items": { "type": "number" }, "maxItems": 2, "minItems": 2, "tsType": "[number,number]", "type": "array" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "number | TerrainElevation | null", "summary": "共同地形按已加载DEM双线性查询米制高度并乘显示夸张，返回number或null；桌面本地DEM仍返回含原始高程/基准的TerrainElevation对象" }, { "name": "map.setProjection", "native": "host.map-write", "parameters": { "items": false, "maxItems": 1, "minItems": 1, "prefixItems": [ { "additionalProperties": false, "properties": { "type": { "enum": [ "geographic", "mercator", "globe" ] } }, "required": [ "type" ], "tsType": "ProjectionSpecification", "type": "object" } ], "type": "array" }, "permission": "map.write", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "ProjectionSpecification", "summary": "使用 type 对象切换 geographic、mercator 或 globe；桌面 GIS 显示坐标系变更使用专有接口" }, { "name": "map.getProjection", "native": "host.map-read", "parameters": { "items": false, "maxItems": 0, "minItems": 0, "prefixItems": [], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "ProjectionSpecification", "summary": "读取当前视图投影" }, { "name": "geometry.distance3d", "native": "host.map-read", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "tsType": "SceneHit | GeoPosition3d", "type": "object" }, { "tsType": "SceneHit | GeoPosition3d", "type": "object" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "Distance3d", "summary": "计算两个三维命中或带高度位置之间的水平、垂直与空间距离；高度基准不一致时拒绝" }, { "name": "pointClouds.neighbors", "native": "analysis.geometry", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "maxLength": 128, "minLength": 1, "tsType": "SourceRef | string", "type": "string" }, { "additionalProperties": false, "properties": { "center": { "items": { "type": "number" }, "maxItems": 3, "minItems": 3, "tsType": "[number,number,number]", "type": "array" }, "limit": { "maximum": 100, "minimum": 1, "type": "integer" }, "radius": { "exclusiveMinimum": 0, "type": "number" } }, "required": [ "center", "radius" ], "tsType": "PointNeighborOptions", "type": "object" } ], "type": "array" }, "permission": "analysis.execute", "platforms": [ "desktop", "mobile" ], "return_type": "Operation", "returns": "PointNeighbors", "summary": "在本地点云全源中按 WGS84 中心与米制半径查找最近点，最多返回 100 个样本" }, { "name": "pointClouds.toDem", "native": "analysis.geometry", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "maxLength": 128, "minLength": 1, "tsType": "SourceRef | string", "type": "string" }, { "additionalProperties": false, "properties": { "addToMap": { "type": "boolean" }, "cellSize": { "exclusiveMinimum": 0, "type": "number" }, "estimateGround": { "type": "boolean" }, "groundThreshold": { "exclusiveMinimum": 0, "type": "number" }, "slope": { "type": "number" } }, "required": [ "cellSize" ], "tsType": "PointDemOptions", "type": "object" } ], "type": "array" }, "permission": "analysis.execute", "platforms": [ "desktop", "mobile" ], "return_type": "Operation", "returns": "RasterRef", "summary": "由本地 UTM 点云全源生成 DEM 临时栅格成果，可只用估计地面点" }, { "name": "pointClouds.density", "native": "analysis.geometry", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "maxLength": 128, "minLength": 1, "tsType": "SourceRef | string", "type": "string" }, { "additionalProperties": false, "properties": { "addToMap": { "type": "boolean" }, "cellSize": { "exclusiveMinimum": 0, "type": "number" } }, "required": [ "cellSize" ], "tsType": "PointDensityOptions", "type": "object" } ], "type": "array" }, "permission": "analysis.execute", "platforms": [ "desktop", "mobile" ], "return_type": "Operation", "returns": "RasterRef", "summary": "由本地 UTM 点云全源生成点密度（点/格）临时栅格成果" }, { "name": "pointClouds.classifyGround", "native": "analysis.geometry", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "maxLength": 128, "minLength": 1, "tsType": "SourceRef | string", "type": "string" }, { "additionalProperties": false, "properties": { "cellSize": { "exclusiveMinimum": 0, "type": "number" }, "groundThreshold": { "exclusiveMinimum": 0, "type": "number" }, "slope": { "type": "number" } }, "required": [ "cellSize" ], "tsType": "GroundClassificationOptions", "type": "object" } ], "type": "array" }, "permission": "analysis.execute", "platforms": [ "desktop", "mobile" ], "return_type": "Operation", "returns": "ClassificationRef", "summary": "对本地 UTM 点云全源做渐进形态学地面分类，结果为临时分类表，不改写原点云" }, { "name": "export.pointCloudClassification", "native": "host.dataset-export", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "uuid", "tsType": "ClassificationRef", "type": "string" }, { "additionalProperties": false, "properties": { "overwrite": { "enum": [ "deny", "ask" ] }, "path": { "maxLength": 32768, "minLength": 1, "type": "string" } }, "required": [ "path" ], "tsType": "FileExportOptions", "type": "object" } ], "type": "array" }, "permission": "export.write", "platforms": [ "desktop", "mobile" ], "return_type": "ChangePlan", "returns": "ChangePlan", "summary": "预演把地面分类结果写出为 CSV，需宿主确认；原点云不改写" }, { "name": "export.splatPreview", "native": "host.dataset-export", "parameters": { "items": false, "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "uuid", "tsType": "MapLayerRef", "type": "string" }, { "additionalProperties": false, "properties": { "overwrite": { "enum": [ "deny", "ask" ] }, "path": { "maxLength": 32768, "minLength": 1, "type": "string" }, "resolutionScale": { "maximum": 4, "minimum": 1, "type": "integer" }, "transparent": { "type": "boolean" } }, "required": [ "path" ], "tsType": "SplatPreviewOptions", "type": "object" } ], "type": "array" }, "permission": "export.write", "platforms": [ "desktop", "mobile" ], "return_type": "ChangePlan", "returns": "ChangePlan", "summary": "预演把当前视角下的高斯资产单独渲染为 PNG（1～4 倍），需宿主确认；不含地图其他内容" }, { "name": "map.workspace.save", "native": "host.dataset-export", "parameters": { "items": false, "maxItems": 1, "minItems": 1, "prefixItems": [ { "additionalProperties": false, "properties": { "overwrite": { "enum": [ "deny", "ask" ] }, "path": { "maxLength": 32768, "minLength": 1, "type": "string" } }, "required": [ "path" ], "tsType": "FileExportOptions", "type": "object" } ], "type": "array" }, "permission": "export.write", "platforms": [ "desktop", "mobile" ], "return_type": "ChangePlan", "returns": "ChangePlan", "summary": "预演把三维工作台（地形、点云、模型/切片、高斯与视角）保存为 JSON 清单，需宿主确认" }, { "name": "map.workspace.load", "native": "host.map-write", "parameters": { "items": false, "maxItems": 2, "minItems": 1, "prefixItems": [ { "maxLength": 32768, "minLength": 1, "type": "string" }, { "additionalProperties": false, "default": {}, "properties": { "mode": { "enum": [ "append", "replace" ] } }, "tsType": "WorkspaceLoadOptions", "type": "object" } ], "type": "array" }, "permission": "map.write", "platforms": [ "desktop", "mobile" ], "return_type": "ChangePlan", "returns": "ChangePlan", "summary": "预演从 JSON 清单恢复三维工作台；append 追加、replace 先移除现有三维内容，确认后整批恢复" }, { "name": "places.search", "native": "host.places", "parameters": { "items": false, "maxItems": 2, "minItems": 1, "prefixItems": [ { "maxLength": 64, "minLength": 1, "type": "string" }, { "additionalProperties": false, "default": {}, "properties": { "level": { "enum": [ "province", "city", "county", "town", "省", "省级", "市", "市级", "地级", "县", "县级", "区县", "乡镇", "乡", "镇", "街道", "乡级" ], "tsType": "PlaceLevelInput" }, "limit": { "maximum": 50, "minimum": 1, "type": "integer" }, "within": { "anyOf": [ { "properties": { "code": { "anyOf": [ { "type": "string" }, { "type": "integer" } ] } }, "required": [ "code" ], "type": "object" }, { "maxLength": 64, "minLength": 1, "type": "string" }, { "maximum": 999999999, "minimum": 100000, "type": "integer" } ], "tsType": "PlaceInput" } }, "tsType": "PlaceSearchOptions", "type": "object" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation>", "returns": "Page", "summary": "地名查询/地理编码：按地名、简称或区划路径查省市县乡镇候选，返回匹配度、驻地坐标与范围；重名时列出多个候选" }, { "name": "places.get", "native": "host.places", "parameters": { "items": false, "maxItems": 1, "minItems": 1, "prefixItems": [ { "anyOf": [ { "properties": { "code": { "anyOf": [ { "type": "string" }, { "type": "integer" } ] } }, "required": [ "code" ], "type": "object" }, { "maxLength": 64, "minLength": 1, "type": "string" }, { "maximum": 999999999, "minimum": 100000, "type": "integer" } ], "tsType": "PlaceInput" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "Place", "summary": "按区划代码或唯一地名取得地名详情（驻地坐标、范围、上级）" }, { "name": "places.children", "native": "host.places", "parameters": { "items": false, "maxItems": 2, "minItems": 1, "prefixItems": [ { "anyOf": [ { "properties": { "code": { "anyOf": [ { "type": "string" }, { "type": "integer" } ] } }, "required": [ "code" ], "type": "object" }, { "maxLength": 64, "minLength": 1, "type": "string" }, { "maximum": 999999999, "minimum": 100000, "type": "integer" } ], "tsType": "PlaceInput" }, { "additionalProperties": false, "default": {}, "properties": { "cursor": { "maxLength": 16, "type": "string" }, "limit": { "maximum": 100, "minimum": 1, "type": "integer" } }, "tsType": "PageOptions", "type": "object" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation>", "returns": "Page", "summary": "列出行政区的直属下级（省的市、市的区县、县的乡镇）" }, { "name": "places.reverse", "native": "host.places", "parameters": { "items": false, "maxItems": 1, "minItems": 1, "prefixItems": [ { "items": { "type": "number" }, "maxItems": 2, "minItems": 2, "tsType": "[number,number]", "type": "array" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "PlaceHierarchy", "summary": "逆地理编码：坐标所在的省、市、县、乡镇（按行政区边界判断，需联网取边界）" }, { "name": "places.nearest", "native": "host.places", "parameters": { "items": false, "maxItems": 2, "minItems": 1, "prefixItems": [ { "items": { "type": "number" }, "maxItems": 2, "minItems": 2, "tsType": "[number,number]", "type": "array" }, { "additionalProperties": false, "default": {}, "properties": { "level": { "enum": [ "province", "city", "county", "town", "省", "省级", "市", "市级", "地级", "县", "县级", "区县", "乡镇", "乡", "镇", "街道", "乡级" ], "tsType": "PlaceLevelInput" }, "limit": { "maximum": 20, "minimum": 1, "type": "integer" } }, "tsType": "PlaceNearestOptions", "type": "object" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "NearbyPlace[]", "summary": "离坐标最近的地名（默认乡镇），按距离升序并给出米制距离" }, { "name": "places.boundary", "native": "host.places", "parameters": { "items": false, "maxItems": 2, "minItems": 1, "prefixItems": [ { "anyOf": [ { "properties": { "code": { "anyOf": [ { "type": "string" }, { "type": "integer" } ] } }, "required": [ "code" ], "type": "object" }, { "maxLength": 64, "minLength": 1, "type": "string" }, { "maximum": 999999999, "minimum": 100000, "type": "integer" } ], "tsType": "PlaceInput" }, { "additionalProperties": false, "default": {}, "properties": { "children": { "type": "boolean" } }, "tsType": "PlaceBoundaryOptions", "type": "object" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "DatasetRef", "summary": "取得行政区边界面数据（WGS84，需联网），可上图、裁剪、统计；children:true 取全部直属下级边界" }, { "name": "files.pick", "native": "host.files", "parameters": { "items": false, "maxItems": 1, "minItems": 0, "prefixItems": [ { "additionalProperties": false, "default": {}, "properties": { "accept": { "items": { "pattern": "^[.]?[A-Za-z0-9]{1,16}$", "type": "string" }, "maxItems": 32, "type": "array" }, "multiple": { "type": "boolean" }, "title": { "maxLength": 64, "minLength": 1, "type": "string" } }, "tsType": "FilePickOptions", "type": "object" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "FileRef[]", "summary": "让用户选择本地文件（桌面系统文件对话框、网页浏览器选择框、移动端系统选择器），返回 FileRef 列表，可直接作为模型、DEM、点云、矢量、栅格、精灵图等的 path；用户取消时返回空数组" }, { "name": "places.parseCoordinate", "native": "host.places", "parameters": { "items": false, "maxItems": 1, "minItems": 1, "prefixItems": [ { "maxLength": 200, "minLength": 1, "type": "string" } ], "type": "array" }, "permission": "project.read", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation<[number,number] | null>", "returns": "[number,number] | null", "summary": "解析用户给出的经纬度文本（十进制、度分秒、东经北纬或 E/N 标记，顺序写反自动纠正）" }, { "name": "map.camera.centerOn", "native": "host.map-write", "parameters": { "items": false, "maxItems": 2, "minItems": 1, "prefixItems": [ { "anyOf": [ { "properties": { "code": { "anyOf": [ { "type": "string" }, { "type": "integer" } ] } }, "required": [ "code" ], "type": "object" }, { "maxLength": 64, "minLength": 1, "type": "string" }, { "maximum": 999999999, "minimum": 100000, "type": "integer" }, { "items": { "type": "number" }, "maxItems": 4, "minItems": 2, "type": "array" } ], "tsType": "CenterOnTarget" }, { "additionalProperties": false, "default": {}, "properties": { "padding": { "type": "number" }, "zoom": { "type": "number" } }, "tsType": "CenterOnOptions", "type": "object" } ], "type": "array" }, "permission": "map.write", "platforms": [ "desktop", "mobile", "web" ], "return_type": "Operation", "returns": "void", "summary": "定位到地名、经纬度、范围或图层/数据：地名按行政级别自动缩放（省7/市11/县12/乡镇15）" } ], "limits": { "resultBytes": 65536, "retainedResults": 16, "retentionSeconds": 300 }, "phase": "P2-incremental", "previewAvailable": false, "version": "0.5-session" }