如何使用空间触发配置服务在指定空间执行_物联网应用开发(IoT Studio)-阿里云帮助中心

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

前提条件

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

节点配置

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

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

配置项	说明
节点名称	设置节点名称。支持中文汉字、英文字母、数字和下划线（_），长度不超过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表示调用触发服务的设备名称。
将本节点选择为后续节点输入源。
例如条件判断或路径选择节点，可选择数据源为空间触发节点的某类型数据。