传感器-操作¶
SensorThings API服务提供的实体可以通过向服务根URI附加一个资源路径来访问。检索观察结果的URL示例如下所示。
http://toronto-bike-snapshot.sensorup.com/v1.0/Observations
答复摘要如下。注意请求实体的实例是如何在JSON数组中显示的。
{"@iot.count":1594349,
"@iot.nextLink":"http://toronto-bike-snapshot.sensorup.com/v1.0/Observations?$top=100&$skip=100","value":
[
{"@iot.id":1595550,"@iot.selfLink":"http://toronto-bike-snapshot.sensorup.com/v1.0/Observations(1595550)","phenomenonTime":"2017-02-16T21:55:12.841Z","result":"7","resultTime":null,"Datastream@iot.navigationLink":"http://toronto-bike-snapshot.sensorup.com/v1.0/Observations(1595550)/Datastream","FeatureOfInterest@iot.navigationLink":"http://toronto-bike-snapshot.sensorup.com/v1.0/Observations(1595550)/FeatureOfInterest"
},
{"@iot.id":1595551,"@iot.selfLink":"http://toronto-bike-snapshot.sensorup.com/v1.0/Observations(1595551)","phenomenonTime":"2017-02-16T21:55:12.841Z","result":"4","resultTime":null,"Datastream@iot.navigationLink":"http://toronto-bike-snapshot.sensorup.com/v1.0/Observations(1595551)/Datastream","FeatureOfInterest@iot.navigationLink":"http://toronto-bike-snapshot.sensorup.com/v1.0/Observations(1595551)/FeatureOfInterest"
},
...
]
}
其他实体也可以通过类似模式的资源路径进行检索。下表列出了每种实体类型的资源路径。
实体集 |
资源路径 |
---|---|
东西 |
/事情 |
位置 |
/位置 |
历史位置 |
/历史位置 |
数据流 |
/数据流 |
传感器 |
/传感器 |
观察到的特性 |
/观测属性 |
观察 |
/观察 |
感兴趣的特征 |
/兴趣爱好 |
除了访问实体外,还可以通过将属性的名称附加到资源路径中,以类似的方式访问实体的属性。以下是从特定观察中检索名为“result”的属性的请求示例。
http://toronto-bike-snapshot.sensorup.com/v1.0/Observations(1595550)/result
下表显示了属性的资源路径示例。
Property |
资源路径 |
---|---|
ID为1595550的观察结果 |
/观察结果(1595550)/结果 |
感兴趣的特征的名称 |
/感兴趣的特性/名称 |
指向ID为4的传感器元数据的链接 |
/传感器(4)/元数据 |
观测到的地物坐标1595550 |
/观察(1595550)/兴趣特征/特征 |
检索选项¶
$过滤器¶
$filter system选项允许客户端筛选由请求URL寻址的实体集合。
对于下面的所有请求,返回小于15.00的结果。
http://toronto-bike-snapshot.sensorup.com/v1.0/Observations?$filter=result%20lt%2015.00
$count¶
$count查询选项指定是否应随结果一起返回集合中与请求匹配的项的总数。
例如,下面的请求返回集合中观察的总数以及结果。将$count选项的值更改为false将导致响应中忽略该计数。
http://toronto-bike-snapshot.sensorup.com/v1.0/Observations?$count=true
$orderby¶
$orderby查询选项指定从服务返回项的顺序。
例如,下面请求按result属性升序排列的所有观察值
http://toronto-bike-snapshot.sensorup.com/v1.0/Observations?$orderby=result
$跳过¶
$skip query选项指定应从结果中排除的查询集合的项目数。
例如,以下请求从第二十一个观察实体开始的所有观察。
http://toronto-bike-snapshot.sensorup.com/v1.0/Observations?$skip=20
$顶部¶
$top query选项指定对从实体集合返回的项数的限制。
例如,下面的请求只返回观测集合中的前六个实体。
http://toronto-bike-snapshot.sensorup.com/v1.0/Observations?$top=6
$扩展¶
$expand query选项使客户机能够指定要包含在响应中的属性集,方法是指示相关实体将被内联表示。
例如,下面的请求返回事物的完整实体集及其关联的数据流。
http://toronto-bike-snapshot.sensorup.com/v1.0/Things?$expand=Datastreams
$选择¶
$select query选项允许客户机通过指示服务只返回显式请求的属性来指定要包含在响应中的属性集。
例如,下面的请求返回每个观测实体,只列出result和phenomenonTime属性。
http://toronto-bike-snapshot.sensorup.com/v1.0/Observations?$select=result,phenomenonTime