文档

空间触发

更新时间:
一键部署

使用空间触发节点,可配置业务服务在指定的地理空间执行。每个业务服务仅支持使用一个触发类型的节点。

前提条件

已完成业务服务创建。详细内容,请参见创建业务服务

节点配置

在业务逻辑编辑页面的节点 > 触发列表中,拖拽空间触发节点到中间画布并进行配置,如图所示。

空间触发您可将鼠标指针移动到各个配置项右侧的帮助按钮帮助上,查看其详细说明。

配置项

说明

节点名称

设置节点名称。支持中文汉字、英文字母、数字和下划线(_),长度不超过30个字符。

选择产品/设备

单击选择项目下的产品/设备,在弹出对话框中选择:

  • 产品下全部设备:页面显示项目下的产品列表,可多选。

  • 产品下指定设备:展开选择设备的下拉列表,选中指定设备。

    您也可以单击搜索框右侧的设置按钮,选择按DeviceName或备注名称搜索设备。

重要

产品必须包含地理位置(GeoLocation)属性,且该属性必须包含以下参数:

  • 经度(Longitude)

  • 纬度(Latitude)

  • 坐标系统(CoordinateSystem)

触发方式

设置触发服务的方式:设备在空间内设备在空间外任一空间超过数量多空间加总达到阈值

选择空间

单击选择项目下的空间,可选多个空间。

触发间隔

设置触发服务的时间:即时延时

节点输出

该节点会将触发服务的设备、地理空间和触发方式等信息作为输出数据。

{
    "entitySnapshot": [
      {
        "identifier": "GeoLocation",
        "timestamp": "1595479245182",
        "value":"{\"CoordinateSystem\":\"2\",\"Latitude\":\"10.048692\",\"Longitude\": \"100\", \"Altitude\": \"55\"}"
      },
      {
        "identifier": "SoilTemperature",
        "timestamp": "1595479245182",
        "value": "18.8"
      }
    ],
    "geoLocation": {
      "gcj02Value": {
        "coordinateSystem": "2",
        "latitude": "10.048692",
        "longitude": "100"
      },
      "wgs84Value": {
        "coordinateSystem": "2",
        "latitude": "10.04683201855812",
        "longitude": "100.00079177365026"
      }
    },
    "ruleDef": {
      "eventType": "OUT",
      "triggerType": "IMMEDIATELY"
    },
    "spaceList": [
     {
      "name": "120-30",
      "spaceId": "bbe4c***84"
      }
    ],
    "triggerEntity": {
      "deviceName": "02Y***CG0",
      "iotId": "02Y***uVlIHOCG0000101",
      "productKey": "a1r***E"
    },
    "triggerTime": "1595479245626"
  }

字段

描述

entitySnapshot

触发服务时,设备的属性快照信息。

  • identifier:属性标识。

  • timestamp:属性快照时间。

  • value:属性快照值。

geoLocation

触发服务时,设备的位置汇总。

  • gcj02Value:GPS坐标系位置。

  • wgs84Value:高德坐标系位置。

ruleDef

触发服务的规则信息。

  • eventType:规则对应的事件类型。

    • IN(设备在空间内

    • OUT(设备在空间外

    • COUNT(任一空间超过数量多空间加总达到阈值

  • triggerType:触发类型。

    • IMMEDIATELY(即时

    • DELAY(延时

spaceList

触发服务的空间列表。

  • name:空间名称。

  • spaceId:空间ID。

triggerEntity

触发服务的设备信息。

  • deviceName:设备名称。

  • iotId:设备ID。

  • productKey:所属产品。

triggerTime

服务触发时间的毫秒数。

如何使用该节点的输出数据

配置后续节点时,可通过以下方式调用输出数据中某字段的值来使用。

  • 以query方式调用具体的参数字段。

    例如脚本节点或钉钉机器人节点,编辑内容时,可使用query调用输出数据。

    • query.entitySnapshot[n].value:其中n为大于等于0的整数。表示调用entitySnapshot数组中第n+1个属性的值。

    • query.字段名称.字段名称:例如query.triggerEntity.deviceName表示调用触发服务的设备名称。

    钉钉机器人
  • 将本节点选择为后续节点输入源。

    例如条件判断或路径选择节点,可选择数据源为空间触发节点的某类型数据。

    条件判断