全部产品

智慧厕所

更新时间:2020-04-14 17:03:43

1、服务介绍

对景区的厕所进行管理,展示每一个厕所基础信息具体包括:位置(经纬度)、名称、编码、排队人数、同步时间。

厕所服务

2 接入指南

2.1 创建厕所

路径:/solution/itoilet/info/add
版本:1.0.0

入参
参数 类型 是否必填 备注
toilets JSON 待创建的厕所信息列表,具体字段参考Toilet信息


Toilet参数

参数 类型 是否必填 备注
name String 厕所名称
address String 位置描述
imageUrl String 图片地址,对应OSS的filename
longitude Double 位置坐标经度-高德坐标系
latitude Double 位置坐标纬度-高德坐标系


出参

使用IoT通用返回结果类型,其中data域是JSON对象,包含以下字段:

参数 类型 备注
toiletId String 厕所Id
name String 厕所名称
address String 位置描述
imageUrl String 图片地址,对应OSS的filename
longitude Double 位置坐标经度-高德坐标系
latitude Double 位置坐标纬度-高德坐标系
toiletSpaces JSON 厕所下子空间列表,具体字段参考ToiletSpace信息


ToiletSpace参数

参数 类型 备注
spaceId String 空间Id
usesCode String 空间用途,PB18-男厕;PB19-女厕;PB20-无障碍厕所;OTHER-其他;
spaceName String 空间名称


示例


入参示例

  1. {
  2. "toilets": [{
  3. "name": "厕所001",
  4. "address": "湖畔北岸",
  5. "imageUrl": "https://xxxxx",
  6. "longitude": 112.8765431,
  7. "latitude": 98.35423763
  8. }]
  9. }


出参示例

  1. {
  2. "code": 200,
  3. "message": "success",
  4. "data": [{
  5. "toiletId": "xxxx",
  6. "name": "厕所001",
  7. "address": "湖畔北岸",
  8. "imageUrl": "https://xxxxx",
  9. "longitude": 112.8765431,
  10. "latitude": 98.35423763,
  11. "toiletSpaces": [{
  12. "spaceId": "6869c07a",
  13. "spaceName": "男厕",
  14. "usesCode": "PB18"
  15. }, {
  16. "spaceId": "85081d49",
  17. "spaceName": "女厕",
  18. "usesCode": "PB19"
  19. }, {
  20. "spaceId": "138119fedd",
  21. "spaceName": "无障碍厕所",
  22. "usesCode": "PB20"
  23. }]
  24. }]
  25. }

2.2 修改厕所信息

路径:/solution/itoilet/info/update
版本:1.0.0

入参
参数 类型 是否必填 备注
toiletId String 厕所Id
name String 厕所名称
address String 位置描述
imageUrl String 图片地址,对应OSS的filename
longitude Double 位置坐标经度-高德坐标系
latitude Double 位置坐标纬度-高德坐标系

出参

使用IoT通用返回结果类型,其中data域是JSON对象,包含以下字段:

参数 类型 备注
toiletId String 厕所Id
name String 厕所名称
address String 位置描述
imageUrl String 图片地址,对应OSS的filename
longitude Double 位置坐标经度-高德坐标系
latitude Double 位置坐标纬度-高德坐标系
toiletSpaces JSON 厕所下子空间列表,具体字段参考ToiletSpace信息


ToiletSpace参数

参数 类型 备注
spaceId String 空间Id
usesCode String 空间用途,PB18-男厕;PB19-女厕;PB20-无障碍厕所;OTHER-其他;
spaceName String 空间名称


示例


入参示例

  1. {
  2. "toiletId": "xxdd",
  3. "name": "厕所001",
  4. "address": "湖畔北岸001",
  5. "imageUrl": "/ddasdf/sdfad.png",
  6. "longitude": 112.8765431,
  7. "latitude": 98.35423763
  8. }


出参示例

  1. {
  2. "code": 200,
  3. "message": "success",
  4. "data": {
  5. "toiletId": "xxxx",
  6. "name": "厕所001",
  7. "address": "湖畔北岸001",
  8. "imageUrl": "https://xxxxx/ddasdf/sdfad.png",
  9. "longitude": 112.8765431,
  10. "latitude": 98.35423763,
  11. "toiletSpaces": [{
  12. "spaceId": "6869c07a",
  13. "spaceName": "男厕",
  14. "usesCode": "PB18"
  15. }, {
  16. "spaceId": "85081d49",
  17. "spaceName": "女厕",
  18. "usesCode": "PB19"
  19. }, {
  20. "spaceId": "138119fedd",
  21. "spaceName": "无障碍厕所",
  22. "usesCode": "PB20"
  23. }]
  24. }
  25. }

2.3 查询厕所信息

路径:/solution/itoilet/info/query
版本:1.0.0

入参
参数 类型 是否必填 备注
pageNo Integer 页码
pageSize Integer 分页大小
toiletIds JSON 厕所Id列表

出参

使用IoT通用返回结果类型,其中data域是JSON对象,包含以下字段:

参数 类型 备注
toiletId String 厕所Id
name String 厕所名称
address String 位置描述
imageUrl String 图片地址,对应OSS的filename
longitude Double 位置坐标经度-高德坐标系
latitude Double 位置坐标纬度-高德坐标系
menTotal Integer 男坑位数量
menAvailable Integer 男可用坑位数量
menQueueStatus Integer 男厕是否有排队,1-有排队,0-无排队
menQueueTime Integer 男厕排队时长,单位秒
womenTotal Integer 女坑位数量
womenAvailable Integer 女可用坑位数量
womenQueueStatus Integer 女厕是否有排队,1-有排队,0-无排队
womenQueueTime Integer 女厕排队时长,单位秒
accessibleTotal Integer 无障碍坑位数量
accessibleAvailable Integer 无障碍可用坑位数量
urinalTotal Integer 男小便池总数量
urinalAvailable Integer 男小便池可用数量
toiletSpaces JSON 厕所下子空间列表,具体字段参考ToiletSpace信息


ToiletSpace参数

参数 类型 备注
spaceId String 空间Id
usesCode String 空间用途,PB18-男厕;PB19-女厕;PB20-无障碍厕所;OTHER-其他;
spaceName String 空间名称


示例


入参示例

  1. {
  2. "pageNo": 1,
  3. "pageSize": 10,
  4. "toiletIds":["f07f7e04d80a4d719"]
  5. }


出参示例

  1. {
  2. "code": 200,
  3. "message": "success",
  4. "data": {
  5. "total": 1,
  6. "data": [{
  7. "womenQueueStatus": 0,
  8. "toiletId": "f07f7e04d80a4d719",
  9. "address": "西湖景区温岚学院",
  10. "latitude": 30.250302,
  11. "toiletSpaces": [{
  12. "spaceName": "男厕",
  13. "spaceId": "7a10436071fc6",
  14. "usesCode": "PB18"
  15. }, {
  16. "spaceName": "女厕",
  17. "spaceId": "5f060e41429b",
  18. "usesCode": "PB19"
  19. }, {
  20. "spaceName": "无障碍厕所",
  21. "spaceId": "713cd321ed6e1c9",
  22. "usesCode": "PB20"
  23. }],
  24. "imageUrl": "http://xxxxxxx",
  25. "menQueueTime": 0,
  26. "name": "温岚学院厕所",
  27. "menQueueStatus": 0,
  28. "womenQueueTime": 0,
  29. "longitude": 120.141318
  30. }],
  31. "pageNo": 1,
  32. "pageSize": 20
  33. }
  34. }


2.4 删除厕所

路径:/solution/itoilet/info/delete
版本:1.0.0

入参
参数 类型 是否必填 备注
toiletIds JSON 厕所Id列表


出参

入参示例

  1. {
  2. "toiletIds": ["xa3dfd","d6tfs"]
  3. }


出参示例

  1. {
  2. "code": 200,
  3. "message": "success"
  4. }

2.5 绑定设备

路径:/solution/itoilet/device/bind
版本:1.0.0

入参
参数 类型 是否必填 备注
devices JSON 厕所设备绑定关系列表,具体字段参考ToiletDevice


ToiletDevice入参

参数 类型 是否必填 备注
toiletId String 厕所Id
deviceId JSON 对应iotId
deviceType String 设备类型,TOILET_PIT-坑位监测;TOILET_URINAL-男小便池监测;TOILET_ENV_AIO-温湿度氨气环境监测一体机;TOILET_QUEUE-厕所排队监测;LIQUID_SOAPS-厕所洗手液监测;TOILET_VISIT_COUNTER-厕所人流统计
spaceId String 空间Id
deviceCode String 设备编号,方便辨识,比如坑位、小便池的位置


出参

入参示例

  1. {
  2. "devices": [{
  3. "toiletId": "95bb2f7b51b3",
  4. "deviceId": "LrxSRnXYZy",
  5. "spaceId": "6869c07aaceb4",
  6. "deviceType": "TOILET_PIT",
  7. "deviceCode": "K001"
  8. }]
  9. }


出参示例

  1. {
  2. "code": 200,
  3. "message": "success"
  4. }

2.6 解绑设备

路径:/solution/itoilet/device/unbind
版本:1.0.0

入参
参数 类型 是否必填 备注
toiletId String 厕所Id
deviceIds JSON 设备Id的集合


出参

入参示例

  1. {
  2. "toiletId":"xxeed3sd",
  3. "deviceIds": ["jd7gh","j7gsf]
  4. }


出参示例

  1. {
  2. "code": 200,
  3. "message": "success"
  4. }

2.7 查询绑定设备以及最新状态

路径:/solution/itoilet/device/query
版本:1.0.0

入参
参数 类型 是否必填 备注
toiletId String 厕所Id
deviceType JSON 设备类型,TOILET_PIT-坑位监测;TOILET_URINAL-男小便池监测;TOILET_ENV_AIO-温湿度氨气环境监测一体机;TOILET_QUEUE-厕所排队监测;LIQUID_SOAPS-厕所洗手液监测;TOILET_VISIT_COUNTER-厕所人流统计
pageNo Sting 页码
pageSize String 分页大小


出参
使用IoT通用返回结果类型,其中data域是JSON对象,包含以下字段:

参数 类型 备注
toiletId String 厕所Id
deviceId JSON 对应iotId
deviceType String 设备类型,TOILET_PIT-坑位监测;TOILET_URINAL-男小便池监测;TOILET_ENV_AIO-温湿度氨气环境监测一体机;TOILET_QUEUE-厕所排队监测;LIQUID_SOAPS-厕所洗手液监测;TOILET_VISIT_COUNTER-厕所人流统计
deviceCode String 设备编号,方便辨识,比如坑位、小便池的位置
spaceId String 空间Id
status String 设备最新状态值
time Date 设备状态更新时间


入参示例

  1. {
  2. "toiletId":"xxeed3sd",
  3. "deviceType":"TOILET_PIT",
  4. "pageNo": 1,
  5. "pageSize":10
  6. }


出参示例

  1. {
  2. "code": 200,
  3. "message": "success",
  4. "data": {
  5. "total": 1,
  6. "data": [{
  7. "deviceType": "TOILET_PIT",
  8. "spaceId": "6fb09162f5214bbf",
  9. "toiletId": "001bbf7b48f14c061f",
  10. "deviceCode": "K008",
  11. "deviceId": "Tx2Au56ZK01",
  12. "spaceUsesCode": "PB18",
  13. "status":"1"
  14. }],
  15. "pageNo": 1,
  16. "pageSize": 10
  17. }
  18. }

2.8 查询厕所详细信息

路径:/solution/itoilet/detailinfo/query
版本:1.0.0

入参
参数 类型 是否必填 备注
pageNo Integer 页码
pageSize Integer 分页大小
toiletIds JSON 厕所Id列表

出参

使用IoT通用返回结果类型,其中data域是JSON对象,包含以下字段:

参数 类型 备注
toiletId String 厕所Id
name String 厕所名称
address String 位置描述
imageUrl String 图片地址,对应OSS的filename
longitude Double 位置坐标经度-高德坐标系
latitude Double 位置坐标纬度-高德坐标系
toiletSpaces JSON 厕所下子空间列表,具体字段参考ToiletSpace信息


ToiletSpace参数

参数 类型 备注
spaceId String 空间Id
usesCode String 空间用途,PB18-男厕;PB19-女厕;PB20-无障碍厕所;OTHER-其他;
spaceName String 空间名称
count Integer 总坑位数量
available Integer 可用坑位数量
queueStatus Integer 是否有排队,1-有排队,0-无排队
queueTime Integer 排队时长,单位秒
temperature String 温度
humidity String 湿度
ammonia String 氨气
co2 String 二氧化碳


示例


入参示例

  1. {
  2. "pageNo": 1,
  3. "pageSize": 10,
  4. "toiletIds":["f07f7e04d80a4d719"]
  5. }


出参示例

  1. {
  2. "code": 200,
  3. "data": {
  4. "total": 1,
  5. "data": [{
  6. "toiletSpaces": [{
  7. "spaceName": "男厕",
  8. "spaceId": "65fadec9f8fb4d71a40534b00db68937",
  9. "queueStatus": 0,
  10. "count": 2,
  11. "available": 1,
  12. "usesCode": "PB18",
  13. "queueTime": 0
  14. }, {
  15. "spaceName": "女厕",
  16. "spaceId": "6b42a7417cca40888017905c6cd7188c",
  17. "queueStatus": 0,
  18. "count": 1,
  19. "available": 0,
  20. "usesCode": "PB19",
  21. "queueTime": 0
  22. }, {
  23. "spaceName": "无障碍厕所",
  24. "spaceId": "ba09ade2c1df4a6abaf98bc3f1465239",
  25. "count": 1,
  26. "available": 1,
  27. "usesCode": "PB20"
  28. }],
  29. "toiletId": "f07f7e04d80a4d719",
  30. "address": "浙江省杭州市西湖区西湖景区温岚学院",
  31. "imageUrl": "http://iotx-tourism-daily.oss-cn-shanghai.aliyuncs.com/data/42bb7465c4424536989d3cb116c034f4/%E4%BA%BA%E8%84%B8A.png?Expires=1576565409&OSSAccessKeyId=LTAIOFKpgzJVcqeZ&Signature=rRDZciWYEf3LTyxmWfy5ErYmN%2FY%3D",
  32. "latitude": "26.250302",
  33. "name": "智慧厕所数字应用20200402",
  34. "longitude": "116.141318"
  35. }],
  36. "pageNo": 1,
  37. "pageSize": 10
  38. },
  39. "id": "300be607-047d-4335-be90-055e3a8a7a98"
  40. }

2.9 数字应用

厕所指标统计数据查询API,根据model查询不同的统计数据。
path:/solution/itoilet/statistics/query
版本:1.0.0

API说明

入参

参数名 数据类型 是否必填 参数描述
projectId String Y 项目Id
model String Y 模型名称,具体模型名称参考对照表
paramJson String N json格式


paramJson根据模型需要传相应的参数(具体参数见模型示例),可用参数如下:

参数名 数据类型 是否必填 参数描述
startTime String N 开始时间(>=,包含该时间)
endTime String N 结束时间(<,不包含该时间)
toiletId String N 厕所Id

出参

参数名 数据类型 参数描述
code Int 错误码,code=200表示正确,其他表示错误
message String 结果信息,正确为success,错误的时候是错误提示
data JSONObject 结果数据
-series JSONArray 结果数据系列集合,可以理解为多个数据列,每个系列代表一列数据
—name String 数据系列名称
—values JSONArray 数据系列值的集合

2.9.1 厕所使用统计

modelId: TRIP_TOILET_PIT_USAGE_QUERY
入参示例

  1. {
  2. "model":"TRIP_TOILET_PIT_USAGE_QUERY",
  3. "projectId":"a124KKWfyglJF5rD",
  4. "paramJson":"{\"startTime\":\"20191006\",\"endTime\":\"20191008\",\"toiletId\":\"xxx\"}"
  5. }


出参示例

  1. {
  2. "code":200,
  3. "data":{
  4. "series":[
  5. {
  6. "values":[
  7. "xxxx"
  8. ],
  9. "name":"toiletId" //厕所Id
  10. },
  11. {
  12. "values":[
  13. "厕所1"
  14. ],
  15. "name":"toiletName" //厕所名称
  16. },
  17. {
  18. "values":[
  19. "男厕"
  20. ],
  21. "name":"spaceUsesCode" //男厕女厕
  22. },
  23. {
  24. "values":[
  25. "454"
  26. ],
  27. "name":"flow" //使用人数
  28. },
  29. {
  30. "values":[
  31. "5445"
  32. ],
  33. "name":"avgUsageDuration" //平均使用时间,单位秒
  34. },
  35. {
  36. "values":[
  37. "5456"
  38. ],
  39. "name":"sumUsageDuration" //使用总时间,单位秒
  40. },
  41. {
  42. "values":[
  43. "45.23"
  44. ],
  45. "name":"saturability" //饱和度
  46. },
  47. {
  48. "values":[
  49. "20200325"
  50. ],
  51. "name":"date" //日期
  52. },
  53. {
  54. "values":[
  55. "123"
  56. ],
  57. "name":"workDuration" //流量
  58. }
  59. ]
  60. },
  61. "id":"ef95893535a94a41b08696beff009a2b"
  62. }


2.9.2 清洁指数统计

modelId: TRIP_TOILET_AMMONIA_EXCEED_QUERY
入参示例

  1. {
  2. "model":"TRIP_TOILET_AMMONIA_EXCEED_QUERY",
  3. "projectId":"a124KKWfyglJF5rD",
  4. "paramJson":"{\"startTime\":\"20191006\",\"endTime\":\"20191008\",\"toiletId\":\"xxx\"}"
  5. }


出参示例

  1. {
  2. "code":200,
  3. "data":{
  4. "series":[
  5. {
  6. "values":[
  7. "xxxx"
  8. ],
  9. "name":"toiletId" //厕所Id
  10. },
  11. {
  12. "values":[
  13. "厕所1"
  14. ],
  15. "name":"toiletName" //厕所名称
  16. },
  17. {
  18. "values":[
  19. "男厕"
  20. ],
  21. "name":"space" //男厕女厕
  22. },
  23. {
  24. "清洁指数":[
  25. "98"
  26. ],
  27. "name":"cleanIndex" //清洁指数
  28. },
  29. {
  30. "values":[
  31. "345"
  32. ],
  33. "name":"exceedDuraion" //超标时长,单位秒
  34. },
  35. {
  36. "values":[
  37. "34"
  38. ],
  39. "name":"maxExceedValue" //超标最大值
  40. },
  41. {
  42. "values":[
  43. "2020-03-25"
  44. ],
  45. "name":"date" //日期
  46. }
  47. ]
  48. },
  49. "id":"ef95893535a94a4eff009a2b"
  50. }

2.9.3 厕所人流统计

modelId: TRIP_TOILET_PERSON_FLOW_QUERY
入参示例

  1. {
  2. "model":"TRIP_TOILET_PERSON_FLOW_QUERY",
  3. "projectId":"a124KKWfyglJF5rD",
  4. "paramJson":"{\"startTime\":\"20191006\",\"endTime\":\"20191008\",\"toiletId\":\"xxx\"}"
  5. }


出参示例

  1. {
  2. "code":200,
  3. "data":{
  4. "series":[
  5. {
  6. "values":[
  7. "xxxx"
  8. ],
  9. "name":"toiletId" //厕所Id
  10. },
  11. {
  12. "values":[
  13. "厕所1"
  14. ],
  15. "name":"toiletName" //厕所名称
  16. },
  17. {
  18. "values":[
  19. "男厕"
  20. ],
  21. "name":"space" //男厕女厕
  22. },
  23. {
  24. "清洁指数":[
  25. "98"
  26. ],
  27. "name":"todayCount" //当天人流
  28. },
  29. {
  30. "values":[
  31. "345"
  32. ],
  33. "name":"totalCount" //累计人流
  34. },
  35. {
  36. "values":[
  37. "20200325"
  38. ],
  39. "name":"date" //日期
  40. }
  41. ]
  42. },
  43. "id":"ef95893535a996beff009a2b"
  44. }