空间管理

空间 定义了物联网场景的地理位置、区域、布局信息，以树形结构展示不同智能设备之间的拓扑关系。树形结构的每个节点，都能添加实体资源（主要是智能设备），例如房间里的照明灯具、空调、监控等。

功能作用

空间模型灵活扩展、通用且不限定业务语义，能应对全行业、全场景的业务形态，让您在不同的业务场景中实现更高效的解决方案。在物联网应用开发中，空间 主要承担如下作用：

• 映射物理空间：例如定义一栋大楼。
• 管理用户权限：定义空间后，将用户与空间关联、资源与空间关联，通过空间桥接资源与用户的关系。
• 管理实体资源：空间下，可以添加多种类型资源，例如设备、Mesh 网络等。

结构特点

空间 构建的层级结构，具有以下特点：

• 呈现出树状多层级结构。
• 一个空间只有一个根节点。
• 每个节点只有一个父节点，可以有多个子节点。
• 每个层级的节点都可以添加资源。
• 每个资源允许添加在多个节点下。
• 在同一个空间树下，网关及其子设备可以进入不同层级空间节点。

应用示例

示例一：体育馆空间布局及设备联动

体育馆是一个多功能场所，包含了不同层级的空间，如体育馆厅、楼层和不同的球类室。通过在空间模型中构建这些空间，可以实现设备联动，例如控制灯光和篮球场记分板。

下图展示的是一个空间结构示例，其中体育场为根节点，一层（包含篮球场）和二层（包含乒乓球室、羽毛球场）为子节点：

通过 空间 模型构建以上结构，可以实现：

• 设置体育馆为整个空间的最顶层，包含一层和二层两个楼层。
• 标记在一层的篮球场和对应的记分板，以及视频监控设备。
• 标记在二层的乒乓球室和羽毛球场以及对应的照明设备。
• 将入门道闸作为体育馆的访问控制入口，以实现照明设备、记分板设备的场景联动。

示例二：智慧公寓的数字化空间构建

智慧公寓是一种常见的商业场景，可能涉及公寓、单元、楼栋、房号、公共区域等维度的空间。某个住户既需要其所在房号的设备权限，也需要相关公共空间区域的设备权限，以此实现房间的设备与公共区域的设备之间的联动。

下图展示的是一个空间结构示例，其中公寓为根节点，A 座、一单元、一楼（包含 101 室和 102 室）为子节点：

通过 空间 模型构建以上结构，可以实现：

• 设置 公寓 > 楼栋 > 单元 > 楼层 > 室 的五层结构，表示物理世界的布局和逻辑关系。
• 支持给用户授予特定房间的权限，例如 101 室。
• 支持给用户授予特定设备的权限，例如设备 3。
• 支持灵活创建不同空间下的设备联动规则。

在这个空间模型上，还方便后续进一步扩展和迭代功能，例如：

• 添加门禁系统：在每个楼栋的入口处添加门禁系统，使得只有授权的人员才能进入楼栋。
• 人脸识别技术：将门锁设备升级为带有人脸识别功能的设备，以增强安全性，并且使住户能够更加便捷地进入房间。
• 智能家居控制：将智能家居设备（例如照明、空调）与空间模型相连，使住户可以通过 App 或语音指令控制房间内的各种设备。
• 能源管理：添加能源管理系统，可以监测和控制房间内的能源使用情况，以实现节能和降低使用成本。
• 安全监控：在楼栋和公共区域添加监控摄像头，用于安全监控和记录，以提高整个智慧公寓的安全性。
• 社交互动：为住户提供一个社交平台，使住户能够互相交流和共享信息，增进社区的互动和友好氛围。

通过不断扩展和增强功能，智慧公寓的居住体验会更加便捷和舒适，同时提高住户的安全性和生活质量。

API 列表

API	路径
删除空间	DELETE:/v2.0/cloud/space/{space_id}
查询空间下资源列表	GET:/v2.0/cloud/space/{space_id}/resource
创建空间	POST:/v2.0/cloud/space/creation
查询空间	GET:/v2.0/cloud/space/{space_id}
查询空间节点列表	GET:/v2.0/cloud/space/child
修改空间信息	PUT:/v2.0/cloud/space/{space_id}
判断父子节点关系	GET:/v2.0/cloud/space/relation

使用限制

限制项	最高限制
单空间节点下设备数	100 个
单空间的子节点数量	100 个
空间层级	10 级

最佳实践

详情请参考 IoT Core 设备管理实践。

常见问题

空间、家庭、资产之间有什么差异？

在涂鸦的某些业务场景中，经常会出现 家庭 和 资产 的概念，两者是 空间 的上层业务包装。空间 是更抽象的一层模型，只保留了最基础的拓扑结构、资源关联等数据，并不会包含 资产 和 家庭 的上层业务数据，例如家庭下的房间。

• 如果您有获得上层业务数据的需求，请参考 资产管理 和 全屋管理。

• 为了让空间模型也能应用在上层业务中，涂鸦也提供了业务升级能力，可以帮助您将底层 空间 升级为上层的 资产 或 家庭。这样您可以无缝衔接使用上层业务能力，例如 OEM App 等。