全部产品

农场信息管理

更新时间:2020-05-20 14:42:32

农场信息管理

说明

针对项目交付的农业项目,定义统一的数据模型,项目isv交付实施时需要将相关业务数据对接到SI工作台中,由集成商进行订阅和使用。
集成方式

使用方式

  1. 申请开通物联网应用服务平台:点此申请开通
  2. 创建自定义项目
  3. 添加能力,选择“农场信息管理”
  4. 添加后通知对接小二进行审批,审批后即可进行调用


1. 基地管理

1.1 添加基地

path: /solution/farm/base/add
版本:1.0.0
入参:

参数 类型 是否必填 备注
baseType Integer 基地类型,0种植,1养殖
baseName String 基地名称
outBaseId String 外部合作伙伴基地Id
areaId String 行政区域id
areaName String 行政区域名
villagesAreaId String 乡镇id
villagesAreaName String 乡镇名称
ruralId String 村镇id
ruralName String 村镇名称
contactName String 联系人
contactPhone String 联系电话
address String 地址
email String 邮箱
longitude String 高德坐标经度
latitude String 高德坐标纬度
boundaryCoordinates String 边界坐标
realArea String 实际可用面积
viewColor String 颜色
altitude String 海拔
persistSupply String 主要作物
baseCode String 基地编号
buildDate Long 建设时间
description String 描述
propagandaVideo String 宣传视频url
picture String 基地实景图url


出参:
String类型, data字段 value表示在阿里内部保存的唯一的IoT基地ID。
出参示例:

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

1.2 更新基地

path: /solution/farm/base/update
版本:1.0.0
入参:

参数 类型 是否必填 备注
baseType Integer 基地类型,0种植,1养殖
baseName String 基地名称
outBaseId String 外部合作伙伴基地Id,和baseId二选一必填
baseId String 阿里内部保存的唯一基地ID,与outBaseId二选一必填
areaId String 行政区域id
areaName String 行政区域名
villagesAreaId String 乡镇id
villagesAreaName String 乡镇名称
ruralId String 村镇id
ruralName String 村镇名称
contactName String 联系人
contactPhone String 联系电话
address String 地址
email String 邮箱
longitude String 经度
latitude String 纬度
boundaryCoordinates String 边界坐标
realArea String 实际可用面积
viewColor String 颜色
altitude String 海拔
persistSupply String 主要作物
baseCode String 基地编号
buildDate Long 建设时间
description String 描述
propagandaVideo String 宣传视频url
picture String 基地实景图url


出参:
String类型,baseId, 表示在阿里内部保存的唯一的基地ID。
出参示例:

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

1.3 删除基地

path: /solution/farm/base/delete
版本:1.0.0
入参:

参数 类型 是否必填 备注
outBaseId String 外部合作伙伴基地Id,和base
Id二选一必填
baseId String 阿里内部保存的唯一基地ID,与outBaseId二选一必填

出参:

出参示例:

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

1.4 基地分页查询

path: /solution/farm/base/query
版本:1.0.0
入参:

参数 类型 是否必填 备注
pageSize Integer 页面大小
pageNo Integer 页号


出参data字段:

参数 类型 备注
total Integer 基地总数
pageSize Integer 页面大小
pageNo Integer 页号
data baseId String 阿里内部保存的唯一基地ID
areaId String 行政区域id
areaName String 行政区域名
villagesAreaId String 乡镇id
villagesAreaName String 乡镇名称
ruralId String 村镇id
ruralName String 村镇名称
outBaseId String 外部合作伙伴基地Id
baseName String 基地名称
contactName String 联系人
contactPhone String 联系电话
address String 地址
email String 邮箱
longitude Decimal 经度
latitude Decimal 纬度
boundaryCoordinates String 边界坐标
realArea Decimal 实际可用面积
viewColor String 颜色
altitude Decimal 海拔
persistSupply String 主要作物
baseCode String 基地编号
buildDate Long 建设时间
description String 描述
propagandaVideo String 宣传视频url
picture String 基地实景图url
baseType Integer 基地类型,0种植,1养殖


出参示例

  1. {
  2. "code": 200,
  3. "data":
  4. {
  5. "total": 1,
  6. "pageNo": 1,
  7. "pageSize": 10,
  8. "data": [
  9. {
  10. "altitude": 28.20,
  11. "latitude": 28.1000000,
  12. "outBaseId": "outbaseId2",
  13. "baseId": "uniqueId2",
  14. "baseType": 1,
  15. "baseName": "baseName2",
  16. "longitude": 42.1000000,
  17. "address": "address1"
  18. }]
  19. },
  20. "message": "success"
  21. }

1.5 基地单个查询

path: /solution/farm/base/get
版本:1.0.0
入参:

参数 类型 是否必填 备注
outBaseId String 外部合作伙伴基地Id,和baseId二选一必填
baseId String 阿里内部保存的唯一基地ID,与outBaseId二选一必填

出参data字段:

参数 类型 备注
baseId String 阿里内部保存的唯一基地ID
areaId String 行政区域id
areaName String 行政区域名
villagesAreaId String 乡镇id
villagesAreaName String 乡镇名称
ruralId String 村镇id
ruralName String 村镇名称
outBaseId String 外部合作伙伴基地Id
baseName String 基地名称
contactName String 联系人
contactPhone String 联系电话
address String 地址
email String 邮箱
longitude String 经度
latitude String 纬度
boundaryCoordinates String 边界坐标
realArea String 实际可用面积
viewColor String 颜色
altitude String 海拔
persistSupply String 主要作物
baseCode String 基地编号
buildDate Long 建设时间
description String 描述
propagandaVideo String 宣传视频url
picture String 基地实景图url
baseType Integer 基地类型,0种植,1养殖


出参示例:

  1. {
  2. "code": 200,
  3. "message": "success",
  4. "data":
  5. {
  6. "altitude": 28.20,
  7. "latitude": 28.1000000,
  8. "baseId": "baseId2",
  9. "OutBaseId": "outbaseId2",
  10. "baseType": 1,
  11. "baseName": "baseName2",
  12. "longitude": 42.1000000,
  13. "address": "address1"
  14. }
  15. }

2. 地块管理

2.1 添加地块

path:/solution/farm/tunnel/add
版本:1.0.0

入参

注意,baseId和outBaseId至少要有一个非空,如果两个非空要保证所属同一个基地。

参数 类型 是否必填 备注
tunnel outTunnelId String 外部合作伙伴地块Id
tunnelName String 地块名称
outBaseId String 外部合作伙伴基地Id
baseId String IoT基地Id
littleStar Integer 星级
description String 介绍
tunnelCode String 编号
plantEnvType Integer 地块类型,1-加热温室/2-日光温室/3-连栋温室/4-春秋棚/5-农田/6-果园/7-水面/8-养殖/9-伐林地/10-开荒地/11-草场地
longitude String 位置经度
latitude String 位置维度
boundaryCoordinates String 边界,高德地图多边形
realArea String 面积,单位亩
farmerName String 农户姓名
farmerPhone String 农户电话
instructorName String 指导员姓名
instructorPhone String 指导员电话
viewColor String 地图展示地块颜色
opacity Integer 地图展示透明度


出参
参数 类型 备注
tunnelId String IoT地块Id

示例


入参示例

  1. {
  2. "tunnel":
  3. {
  4. "tunnelName": "tunnelId-0010",
  5. "littleStar": 1,
  6. "latitude": "1.0993",
  7. "description": "description",
  8. "farmerPhone": "13423231112",
  9. "outBaseId": "outBaseId2",
  10. "baseId": "baseId2",
  11. "farmerName": "farmerName",
  12. "viewColor": "#ccc",
  13. "instructorPhone": "13423231113",
  14. "outTunnelId": "tunnelId-001",
  15. "tunnelCode": "JJ213",
  16. "longitude": "1.0233",
  17. "instructorName": "instructorName",
  18. "partitionId": "123",
  19. "boundaryCoordinates": "{\"type\":\"Feature\", \"properties\":{},\"geometry\":{\"type\":\"Polygon\",\"coordinates\":[[[120.00018962106981,30.294554257460305],[119.99970749399938,30.274193330717893],[120.02397612116614,30.273929837974492],[120.02397276840486,30.295096184972877],[120.00018962106981,30.294554257460305]]]}}",
  20. "realArea": "123.2",
  21. "opacity": 20,
  22. "plantEnvType": 1
  23. }
  24. }


出参示例

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

2.2 更新地块

path:/solution/farm/tunnel/update
版本:1.0.0

入参

注意,tunnelId和outTunnelId至少要有一个非空,如果两个非空要保证所属同一个地块。

参数 类型 是否必填 备注
tunnel tunnelId String IoT地块Id
outTunnelId String 外部合作伙伴地块Id
tunnelName String 地块名称
littleStar Integer 星级
description String 介绍
tunnelCode String 编号
plantEnvType Integer 地块类型,1-加热温室/2-日光温室/3-连栋温室/4-春秋棚/5-农田/6-果园/7-水面/8-养殖/9-伐林地/10-开荒地/11-草场地
longitude String 位置经度
latitude String 位置维度
boundaryCoordinates String 边界
realArea String 面积,单位亩
farmerName String 农户姓名
farmerPhone String 农户电话
instructorName String 指导员姓名
instructorPhone String 指导员电话
viewColor String 地图展示地块颜色
opacity Integer 地图展示透明度

出参
参数 类型 备注
tunnelId String IoT地块Id

示例


入参示例

  1. {
  2. "tunnel":
  3. {
  4. "tunnelId": "ecaf24330bdf4e18ba8a969b7e82fe6d",
  5. "outTunnelId": "tunnelId-001",
  6. "tunnelName": "tunnelId-0010",
  7. "littleStar": 1,
  8. "latitude": "1.0993",
  9. "description": "description",
  10. "farmerPhone": "13423231112",
  11. "farmerName": "farmerName",
  12. "viewColor": "#ccc",
  13. "instructorPhone": "13423231113",
  14. "tunnelCode": "JJ213",
  15. "longitude": "1.0233",
  16. "instructorName": "instructorName",
  17. "partitionId": "123",
  18. "boundaryCoordinates": "{\"type\":\"Feature\", \"properties\":{},\"geometry\":{\"type\":\"Polygon\",\"coordinates\":[[[120.00018962106981,30.294554257460305],[119.99970749399938,30.274193330717893],[120.02397612116614,30.273929837974492],[120.02397276840486,30.295096184972877],[120.00018962106981,30.294554257460305]]]}}",
  19. "realArea": "123.2",
  20. "opacity": 20,
  21. "plantEnvType": 1
  22. }
  23. }


出参示例

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

2.3 删除地块

path:/solution/farm/tunnel/delete
版本:1.0.0

入参

注意,tunnelId和outTunnelId至少要有一个非空,如果两个非空要保证所属同一个地块。

参数 类型 是否必填 备注
tunnelId String IoT地块Id
outTunnelId String 外部合作伙伴地块Id


出参


示例

入参示例

  1. {
  2. "tunnelId": "ecaf24330bdf4e18ba8a969b7e82fe6d",
  3. "outTunnelId": "tunnelId-001"
  4. }


出参示例

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

2.4 分页地块查询

path:/solution/farm/tunnel/query
版本:1.0.0

入参
参数 类型 是否必填 备注
outBaseId String 外部合作伙伴基地Id
baseId String IoT基地Id
pageSize Integer 分页大小,默认1
pageNo Integer 分页页码,默认100

出参

data.data

参数 类型 说明
total Integer 基地总数
pageSize Integer 页面大小
pageNo Integer 页号
data outTunnelId String 外部合作伙伴地块Id
tunnelName String 地块名称
outBaseId String 外部合作伙伴基地Id
baseId String IoT基地Id
littleStar Integer 星级
description String 介绍
tunnelCode String 编号
plantEnvType Integer 地块类型,1-加热温室/2-日光温室/3-连栋温室/4-春秋棚/5-农田/6-果园/7-水面/8-养殖/9-伐林地/10-开荒地/11-草场地
longitude String 位置经度
latitude String 位置维度
boundaryCoordinates String 边界,高德地图多边形
realArea String 面积,单位亩
farmerName String 农户姓名
farmerPhone String 农户电话
instructorName String 指导员姓名
instructorPhone String 指导员电话
viewColor String 地图展示地块颜色
opacity Integer 地图展示透明度

示例

入参示例

  1. {
  2. "baseId": "ecaf24330bdf4e18ba8a969b7e82fe6d",
  3. "pageNo": 1,
  4. "pageSize":10
  5. }


出参示例

  1. {
  2. "code": 200,
  3. "data": {
  4. "data": [{
  5. "outBaseId": "outBaseId2",
  6. "baseId": "baseId2",
  7. "boundaryCoordinates": "{\"type\":\"Feature\", \"properties\":{},\"geometry\":{\"type\":\"Polygon\",\"coordinates\":[[[120.00018962106981,30.294554257460305],[119.99970749399938,30.274193330717893],[120.02397612116614,30.273929837974492],[120.02397276840486,30.295096184972877],[120.00018962106981,30.294554257460305]]]}}",
  8. "description": "description0",
  9. "farmerName": "farmerName0",
  10. "farmerPhone": "134232311120",
  11. "gmtCreate": 1584966655000,
  12. "gmtModified": 1585015322000,
  13. "instructorName": "instructorName0",
  14. "instructorPhone": "134232311130",
  15. "littleStar": 10,
  16. "opacity": 22,
  17. "partitionId": "1230",
  18. "plantEnvType": 10,
  19. "scopeId": "a1033sb2GFZgjQNU",
  20. "spaceId": "ecaf24330bdf4e18ba8a969b7e82fe6d",
  21. "tunnelCode": "JJ2130",
  22. "tunnelId": "tunnelId-001",
  23. "tunnelName": "tunnelId-0010",
  24. "outTunnelId": "ecaf24330bdf4e18ba8a969b7e82fe6d",
  25. "viewColor": "#ccc0"
  26. }],
  27. "pageNo": 1,
  28. "pageSize": 10,
  29. "total": 1
  30. },
  31. "message": "success"
  32. }

2.5 查询单个地块

path:/solution/farm/tunnel/getbyid
版本:1.0.0
注意,tunnelId和outTunnelId至少要有一个非空,如果两个非空要保证所属同一个地块。

参数 类型 是否必填 备注
tunnelId String IoT地块Id
outTunnelId String 外部合作伙伴地块Id

出参
参数 类型
outTunnelId String 外部合作伙伴地块Id
tunnelName String 地块名称
outBaseId String 外部合作伙伴基地Id
baseId String IoT基地Id
littleStar Integer 星级
description String 介绍
tunnelCode String 编号
plantEnvType Integer 地块类型?
longitude String 位置经度
latitude String 位置维度
boundaryCoordinates String 边界,高德地图多边形
realArea String 面积,单位亩
farmerName String 农户姓名
farmerPhone String 农户电话
instructorName String 指导员姓名
instructorPhone String 指导员电话
viewColor String 地图展示地块颜色
opacity Integer 地图展示透明度

示例


入参示例

  1. {
  2. "tunnelId": "ecaf24330bdf4e18ba8a969b7e82fe6d",
  3. "outTunnelId": "tunnelId-001"
  4. }


出参示例

  1. {
  2. "code": 200,
  3. "data": {
  4. "outBaseId": "outBaseId2",
  5. "baseId": "baseId2",
  6. "boundaryCoordinates": "{\"type\":\"Feature\", \"properties\":{},\"geometry\":{\"type\":\"Polygon\",\"coordinates\":[[[120.00018962106981,30.294554257460305],[119.99970749399938,30.274193330717893],[120.02397612116614,30.273929837974492],[120.02397276840486,30.295096184972877],[120.00018962106981,30.294554257460305]]]}}",
  7. "description": "description0",
  8. "farmerName": "farmerName0",
  9. "farmerPhone": "134232311120",
  10. "gmtCreate": 1584966655000,
  11. "gmtModified": 1585015322000,
  12. "instructorName": "instructorName0",
  13. "instructorPhone": "134232311130",
  14. "littleStar": 10,
  15. "opacity": 22,
  16. "partitionId": "1230",
  17. "plantEnvType": 10,
  18. "scopeId": "a1033sb2GFZgjQNU",
  19. "spaceId": "ecaf24330bdf4e18ba8a969b7e82fe6d",
  20. "tunnelCode": "JJ2130",
  21. "tunnelId": "tunnelId-001",
  22. "tunnelName": "tunnelId-0010",
  23. "outTunnelId": "ecaf24330bdf4e18ba8a969b7e82fe6d",
  24. "viewColor": "#ccc0"
  25. },
  26. "message": "success"
  27. }