区域农情监测api文档

Appearance

水稻稻瘟病预警 ​

产品简介 ​

水稻稻瘟病是由稻瘟病原菌引起的水稻病害，在整个生育期内均有发生的可能性。该病害在我国各水稻产区均有发生。通过对病害状况进行分级，农业管理者可快速识别出病害高危区域，从而及时采取防控措施，抑制病害的进一步发展。

技术原理 ​

基于连续监测的历史风速、温度、气压、降水等气象因子，构建发病风险模型，从而实现对水稻稻瘟病发病风险的预测。

分辨率 ​

覆盖范围更新频率数据源分辨率准确度
中国、泰国、柬埔寨1 天3 千米
全球1 天9 千米

图层示例 ​

An image

接口 ​

获取稻瘟病预警时间轴 ​

接口描述 ​

根据作物 id、区域 id、起始日期、终止日期条件, 获取稻瘟病预警时间轴

请求示例 URL ​

GET /productapi/jh-api/riceBlastRegionApi/queryTimeAxis

请求方式 ​

GET

请求头 ​

属性说明例如是否必填
ServiceKey密钥f35a**********e5680b8必填
UserName用户名156****1376必填

参数 ​

属性说明例如是否必填
regionId区域 id3104002402必填
cropId作物 id104必填
startDate起始日期2020-09-10选填
endDate终止日期2020-09-10选填

例子 ​

https://gw.datall.cn/productapi/jh-api/riceBlastRegionApi/queryTimeAxis?regionId=3104002402&cropId=104&startDate=2020-09-10&endDate=2020-09-10

返回 ​

json
{
  "flag": true,
  "code": null,
  "msg": null,
  "data": [
    "2021-07-10",
    "2021-07-20",
    "2021-07-31",
    "2021-08-10",
    "2021-08-20",
    "2021-08-31",
    "2021-09-10"
  ]
}

获取稻瘟病预警图例 ​

请求示例 url ​

json
https://gw.datall.cn/productapi/jh-api/riceBlastRegionApi/queryConfigRank

请求方式 ​

GET

请求头 ​

属性说明例如是否必填
ServiceKey密钥f35a*********e5680b8必填
UserName用户名156****1376必填

例子 ​

json
https://gw.datall.cn/productapi/jh-api/riceBlastRegionApi/queryConfigRank

返回 ​

json
{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "id": "01",
    "name": "水稻稻瘟病预警模板",
    "unit": "无",
    "levelDataVos": [
      {
        "id": 307,
        "levelName": "未受灾",
        "maxValue": 1,
        "minValue": 0,
        "colorCode": "#267A0A",
        "colorName": null
      }
    ]
  }
}

当前区域指定日期稻瘟病预警数据 ​

接口描述 ​

根据作物 id、日期、区域 id 条件, 获取当前区域指定日期稻瘟病预警数据。

请求示例 url ​

https://gw.datall.cn/productapi/jh-api/riceBlastRegionApi/queryRealtimeDataToday

请求方式 ​

GET

请求头 ​

属性说明例如是否必填
ServiceKey密钥f35a*********e5680b8必填
UserName用户名156****1376必填

参数 ​

属性说明例如是否必填
regionId区域 id3104002402必填
cropId作物 id104必填
dataTime日期2021-09-10必填

例子 ​

https://gw.datall.cn/productapi/jh-api/riceBlastRegionApi/queryRealtimeDataToday?regionId=3104002402&cropId=104&dataTime=2021-09-10

返回 ​

json
响应json格式说明：
{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "regionId": 3104002402,
    "dataTime": "2021-09-10",
    "regionChinaName": "文成县",
    "cropId": 104,
    "cropName": "中稻",
    "levelDataVos": [
      {
        "levelId": 307,
        "levelName": "轻度灾区",
        "areaNum": 2064.75,
        "tenThousandAreaNum": 6.11
      }
    ]
  }
}

当前区域指定时间段内稻瘟病预警数据 ​

接口描述 ​

根据作物 id、区域 id、起始日期、终止日期条件, 获取当前区域指定时间段内稻瘟病预警数据

请求示例 url ​

https://gw.datall.cn/productapi/jh-api/riceBlastRegionApi/queryRealtimeDataBetweenDate

请求方式 ​

GET

请求头 ​

属性说明例如是否必填
ServiceKey密钥f35a*********e5680b8必填
UserName用户名156****1376必填

请求参数 ​

属性说明例如是否必填
regionId区域 id3104002402必填
cropId作物 id104必填
startDate起始日期2021-07-10必填
endDate终止日期2021-09-10必填

例子 ​

https://gw.datall.cn/productapi/jh-api/riceBlastRegionApi/queryRealtimeDataBetweenDate?regionId=3104002402&cropId=104&startDate=2021-07-10&endDate=2021-09-10

返回 ​

json
{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "regionId": 3104002402,
    "dataTime": "2021-09-10",
    "regionChinaName": "文成县",
    "cropId": 104,
    "cropName": "中稻",
    "levelDataVos": [
      {
        "levelId": 308,
        "levelName": "轻度灾区",
        "areaNum": 61163.59,
        "tenThousandAreaNum": 6.11
      }
    ]
  }
}

当前区域前几期稻瘟病预警数据 ​

接口描述 ​

根据作物 id、日期、区域 id、当前前 N 期条件, 获取当前区域前几期稻瘟病预警数据。

请求示例 url ​

https://gw.datall.cn/productapi/jh-api/riceBlastRegionApi/queryRealtimeDataLimitNum

请求方式 ​

GET

请求头 ​

属性说明例如是否必填
ServiceKey密钥f35a*********e5680b8必填
UserName用户名156****1376必填

请求参数 ​

属性说明例如是否必填
regionId区域 id3104002402必填
cropId作物 id104必填
dataTime日期2021-09-10必填
limitNum当前日期前 N 期，默认 55选填

返回 ​

json
{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "regionId": 3104002402,
    "dataTime": "2021-09-10",
    "regionChinaName": "文成县",
    "cropId": 104,
    "cropName": "中稻",
    "levelDataVos": [
      {
        "levelId": 308,
        "levelName": "轻度灾区",
        "areaNum": 61163.59,
        "tenThousandAreaNum": 6.11
      }
    ]
  }
}

当前区域前几期稻瘟病预警数据 ​

接口描述 ​

根据作物 id、日期、区域 id、当前前 N 期条件, 获取当前区域前几期稻瘟病预警数据。

请求示例 url ​

https://gw.datall.cn/productapi/jh-api/riceBlastRegionApi/queryRealtimeDataLimitNum

请求方式 ​

GET

请求头 ​

属性说明例如是否必填
ServiceKey密钥f35a*********e5680b8必填
UserName用户名156****1376必填

请求参数 ​

属性说明例如是否必填
regionId区域 id3104002402必填
cropId作物 id104必填
dataTime日期2021-09-10必填
limitNum当前日期前 N 期，默认 55选填

例子 ​

https://gw.datall.cn/productapi/jh-api/riceBlastRegionApi/queryRealtimeDataLimitNum?regionId=3104002402&cropId=104&dataTime=2021-09-10&limitNum=5

返回 ​

  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "regionId": 3104002402,
    "dataTime": "2021-09-10",
    "regionChinaName": "文成县",
    "cropId": 104,
    "cropName": "中稻",
    "levelDataVos": [
      {
        "levelId": 308,
        "levelName": "轻度灾区",
        "areaNum": 61163.59,
        "tenThousandAreaNum": 6.11
      }
    ]
  }
}

当前区域前 N 年同比稻瘟病预警数据 ​

接口描述 ​

根据作物 id、区域 id、日期、同比年份条件, 获取当前区域前 N 年同比稻瘟病预警数据

请求示例 url ​

https://gw.datall.cn/productapi/jh-api/riceBlastRegionApi/queryRealtimeLastYears

请求方式 ​

GET

请求头 ​

属性说明例如是否必填
ServiceKey密钥f35a*********e5680b8必填
UserName用户名156****1376必填

请求参数 ​

属性说明例如是否必填
regionId区域 id3104002402必填
cropId作物 id104必填
dataTime日期2021-09-10必填
limitNum同比年份，默认前 3 年3选填

例子 ​

https://gw.datall.cn/productapi/jh-api/riceBlastRegionApi/queryRealtimeLastYears?regionId=3104002402&cropId=104&dataTime=2021-09-10&yearOnYearNum=3

返回 ​

{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "regionId": 3104002402,
    "dataTime": "2021-09-10",
    "regionChinaName": "文成县",
    "cropId": 104,
    "cropName": "中稻",
    "levelDataVos": [
      {
        "levelId": 308,
        "levelName": "轻度灾区",
        "areaNum": 61163.59,
        "tenThousandAreaNum": 6.11
      }
    ]
  }
}

下级区域指定日期稻瘟病预警数据 ​

接口描述 ​

根据作物 id、日期、区域 id 条件, 获取下级区域指定日期稻瘟病预警数据

请求示例 url ​

https://gw.datall.cn/productapi/jh-api/riceBlastRegionApi/queryRealtimeDataNextRegion

请求方式 ​

GET

请求头 ​

属性说明例如是否必填
ServiceKey密钥f35a*********e5680b8必填
UserName用户名156****1376必填

请求参数 ​

属性说明例如是否必填
regionId区域 id3104002402必填
cropId作物 id104必填
dataTime日期2021-09-10必填

例子 ​

json
https://gw.datall.cn/productapi/jh-api/riceBlastRegionApi/queryRealtimeDataNextRegion?regionId=3104002402&cropId=104&dataTime=2021-09-10

返回 ​

json
{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "regionId": 3104002402,
    "dataTime": "2021-09-10",
    "regionChinaName": "百丈漈镇",
    "cropId": 104,
    "cropName": "中稻",
    "levelDataVos": [
      {
        "levelId": 308,
        "levelName": "轻度灾区",
        "areaNum": 5341.62,
        "tenThousandAreaNum": 0.53
      }
    ]
  }
}

下级区域前 N 年同比稻瘟病预警数据 ​

接口描述 ​

根据作物 id、日期、区域 id、同比年份条件, 获取下级区域前 N 年同比稻瘟病预警数据

请求示例 url ​

json
https://gw.datall.cn/productapi/jh-api/riceBlastRegionApi/queryNextRegionLastYears

请求方式 ​

GET

请求头 ​

属性说明例如是否必填
ServiceKey密钥f35a*********e5680b8必填
UserName用户名156****1376必填

请求参数 ​

属性说明例如是否必填
regionId区域 id3104002402必填
cropId作物 id104必填
dataTime日期2021-09-10必填
yearOnYearNum同比年份，默认前 3 年3选填（Optional filling）

例子 ​

json
https://gw.datall.cn/productapi/jh-api/riceBlastRegionApi/queryNextRegionLastYears?regionId=3104002402&cropId=104&dataTime=2021-09-10&yearOnYearNum=3

返回 ​

json
{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "regionId": 3104002402,
    "dataTime": "2021-09-10",
    "regionChinaName": "百丈漈镇",
    "cropId": 104,
    "cropName": "中稻",
    "levelDataVos": [
      {
        "levelId": 308,
        "levelName": "轻度灾区",
        "areaNum": 5341.62,
        "tenThousandAreaNum": 0.53
      }
    ]
  }
}

稻瘟病预警瓦片图层 ​

请求示例 url ​

json
https://gw.datall.cn/productapi/jh-api/riceBlastRegionApi/loadTileLayer

请求方式 ​

GET

请求头 ​

属性说明例如是否必填
ServiceKey密钥f35a*********e5680b8必填
UserName用户名156****1376必填

请求参数 ​

属性说明例如是否必填
regionId区域 id3104002402必填
cropId作物 id104必填
dataTime日期2021-09-10必填
bbox瓦片范围120.1025390625,27.7294921875,120.146484375,27.7734375必填
ServiceKey密钥f35a*********e5680b8必填
UserName用户名156****1376必填

例子 ​

json
https://gw.datall.cn/productapi/jh-api/riceBlastRegionApi/loadTileLayer?regionId=3104002402&cropId=104&dataTime=2021-09-10&bbox=120.1025390625,27.7294921875,120.146484375,27.7734375

返回 ​

当前位置的一块瓦片图片： An image

获取稻瘟病预警地块图片 ​

接口描述 ​

根据地块编号、日期、作物 id 条件, 获取当前区域稻瘟病预警地块图片。

请求示例 url ​

json
https://gw.datall.cn/productapi/jh-api/riceBlastIndexLandApi/loadLandImage

请求方式 ​

GET

请求头 ​

属性说明例如是否必填
ServiceKey密钥f35a*********e5680b8必填
UserName用户名156****1376必填

请求参数 ​

属性说明例如是否必填
landNo地块编号custom3103000343_202205060000000005345733必填
cropId作物 id104必填
dataTime日期2021-08-10必填

例子 ​

json
https://gw.datall.cn/productapi/jh-api/riceBlastIndexLandApi/loadLandImage/custom3103000343_202205060000000005345733/104/2021-08-10

返回 ​

当前区域绘制地块的图片 An image

获取稻瘟病预警地块统计信息 ​

接口描述 ​

根据地块编号、日期、作物 id 条件, 获取当前区域稻瘟病预警统计数据。

请求示例 url ​

json
https://gw.datall.cn/productapi/jh-api/riceBlastIndexLandApi/statisticsLandData

请求方式 ​

GET

请求头 ​

属性说明例如是否必填
ServiceKey密钥f35a*********e5680b8必填
UserName用户名156****1376必填

请求参数 ​

属性说明例如是否必填
landNo地块编号custom3103000343_202205060000000006645216必填
cropId作物 id104必填
dataTimeStr日期2021-08-10必填

例子 ​

json
https://gw.datall.cn/productapi/jh-api/riceBlastIndexLandApi/statisticsLandData?landNo=custom3103000343_202205060000000006645216&cropId=104&dataTimeStr=2021-08-10

返回 ​

json
{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "RANK": "3",
    "RANK_NAME": "重度灾区"
  }
}