让你的产品，
获得空间能力。
通过 API、SDK、Viewer / Editor 组件与 Agent Tool，在你自己的产品中使用 Nebula Spatial 的空间数据、资产、查询、计算、推理与生成能力。
四步接入空间能力。
创建项目、获取凭证、安装 SDK 或直接调用 API，即可从你的产品发起空间查询并拿到结构化结果。
1
创建项目
在开发者控制台创建应用，绑定要接入的空间或组织。
2
获取凭证
生成 API Key，用于服务端调用或 SDK 初始化。
3
安装 SDK 或调用 API
使用官方 SDK，或直接向 REST 接口发送空间请求。
4
返回空间结果
拿到结构化的对象、区域、路径与判断结果，在你的产品中呈现。
// 安装：npm i @nebula-spatial/sdk import { createClient } from "@nebula-spatial/sdk"; const spatial = createClient({ apiKey: process.env.NS_KEY }); // 查询宽度大于 1.8m 的连通通道 const result = await spatial.query({ space: "facility_A", ask: "connected paths wider than 1.8m" }); console.log(result.paths); // → [ { id: "aisle-1", w: 2.1 }, { id: "aisle-3", w: 1.9 } ]
按能力组织的空间接口。
每一类空间能力都有对应的 REST 接口，可单独调用或组合使用。
用你熟悉的语言接入。
官方 SDK 封装凭证、请求与类型定义，让空间能力像调用本地函数一样简单。
JavaScript / TypeScript
Previewnpm i @nebula-spatial/sdkNode 与浏览器 →Python
Previewpip install nebula-spatial服务端与数据管线 →Web SDK
Preview<script src="/api/projects/e316ed7a-74e8-4d48-95b6-6c6aaf7ead8d/raw/%E2%80%A6/spatial.js?v=27">浏览器内嵌与可视化 →SDK 与包名目前处于技术预览，示例仅用于说明接入方式；正式发布后以开发者控制台提供的安装指引为准。
嵌入组件，或交给 Agent 调用。
用现成的 Viewer / Editor 组件在产品中呈现空间，或把空间能力作为工具暴露给 AI Agent。
Viewer / Editor 组件
将空间浏览与编辑直接嵌入你的界面，高亮空间结果，并与你的应用双向同步事件与数据。
- 嵌入 Viewer 呈现空间
- 嵌入 Editor 编辑对象与区域
- 高亮查询与计算结果
- 事件与数据同步
Agent Tool
Preview通过 MCP 等标准工具接口，让 AI Agent 直接查询空间、调用计算并操作资产。目前处于技术预览阶段。
- Agent 查询空间结构
- Agent 调用空间计算
- Agent 操作空间资产
- MCP / 标准工具接口
选一个空间，试一个请求。
选择空间与问题，查看结构化返回并在画布中预览高亮结果。这是交互演示，数据为示例。
Request
Response
{
"paths": [
{ "id": "aisle-1", "w": 2.1 },
{ "id": "aisle-3", "w": 1.9 }
]
}
文档、示例与状态。
从参考手册到更新记录，接入过程中的每一步都有对应资料。