区域农情监测api文档

Appearance

玉米螟预警 ​

产品简介 ​

玉米螟病是由鳞翅目昆虫引发的玉米病害。该病害在我国玉米主产区均有发生，从黑龙江到海南各玉米产区均有发生危害。通过对虫害状况进行分级，农业管理者可快速识别出病害高危区域，从而及时采取防控措施，抑制病害的进一步发展。

技术原理 ​

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

分辨率 ​

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

图层示例 ​

An image

接口 ​

获取玉米螟时间轴 ​

接口描述 ​

根据作物id、区域id、起始日期、终止日期条件, 获取玉米螟时间轴

请求示例 url ​

json
https://gw.datall.cn/productapi/jh-api/borerDiseaseWarningRegionApi/queryTimeAxis

请求方式 ​

GET

请求头 ​

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

请求参数 ​

属性说明例如是否必填
regionId区域id3104001644必填
cropId作物id107必填
startDate起始日期2018-02-10选填
endDate终止日期2021-05-01选填

例子 ​

json
https://gw.datall.cn/productapi/jh-api/borerDiseaseWarningRegionApi/queryTimeAxis?regionId=3104001644&cropId=107&startDate=2018-02-10&endDate=2021-05-01

返回 ​

json
响应json格式数据
{
  "flag": true,
  "code": null,
  "msg": null,
  "data": [
    "2020-04-30",
    "2021-02-20",
    "2021-03-31",
    "2021-04-10",
    "2021-04-20"
  ]
}

获取玉米螟图例 ​

请求示例 url ​

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

请求方式 ​

GET

请求头 ​

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

例子 ​

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

返回 ​

json
响应json格式数据
{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "id": "01",
    "name": "玉米螟模板",
    "unit": "无",
    "levelDataVos": [
      {
        "id": 98,
        "levelName": "一类苗",
        "maxValue": 1,
        "minValue": 1,
        "colorCode": "#005BFF",
        "colorName": null
      }
    ]
  }
}

当前区域指定日期玉米螟数据 ​

接口描述 ​

根据作物id、日期、区域id条件, 获取当前区域指定日期玉米螟数据。

请求示例 url ​

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

请求方式 ​

GET

请求头 ​

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

请求参数 ​

属性说明例如是否必填
regionId区域id3104001644必填
cropId作物id102必填
dataTime日期2021-10-20必填

例子 ​

json
https://gw.datall.cn/productapi/jh-api/borerDiseaseWarningRegionApi/queryRealtimeDataToday?regionId=3104001644&cropId=102&dataTime=2021-10-20

返回 ​

json
响应json格式数据
{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "regionId": 3104001644,
    "dataTime": "2021-10-20",
    "regionChinaName": "邹平市",
    "cropId": 102,
    "cropName": "夏玉米",
    "levelDataVos": [
      {
        "levelId": 1,
        "levelName": "一类苗",
        "areaNum": 2064.75,
        "tenThousandAreaNum": 0.2
      }
    ]
  }
}

当前区域指定时间段内玉米螟数据 ​

接口描述 ​

根据作物id、区域id、起始日期、终止日期条件, 获取当前区域指定时间段内玉米螟数据

请求示例 url ​

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

请求方式 ​

GET

请求头 ​

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

请求参数 ​

属性说明例如是否必填
regionId区域id3104001644必填
cropId作物id107必填
startDate起始日期2020-01-01必填
endDate终止日期2021-12-31必填

例子 ​

json
https://gw.datall.cn/productapi/jh-api/borerDiseaseWarningRegionApi/queryRealtimeDataBetweenDate?regionId=3104001644&cropId=107&startDate=2020-01-01&endDate=2021-12-31

返回 ​

json
{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "regionId": 3104001644,
    "dataTime": "2021-04-20",
    "regionChinaName": "邹平市",
    "cropId": 107,
    "cropName": "冬小麦",
    "levelDataVos": [
      {
        "levelId": 1,
        "levelName": "一类苗",
        "areaNum": 2064.75,
        "tenThousandAreaNum": 0.2
      }
    ]
  }
}

当前区域前几期玉米螟数据 ​

接口描述 ​

根据作物id、区域id、日期、当前前N期条件, 获取当前区域前几期玉米螟数据

请求示例 url ​

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

请求方式 ​

GET

请求头 ​

属性说明例如是否必填
ServiceKey密钥f35a*************e5680b8必填

请求参数 ​

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

例子 ​

json
https://gw.datall.cn/productapi/jh-api/borerDiseaseWarningRegionApi/queryRealtimeDataLimitNum?regionId=3104001644&cropId=107&dataTime=2021-09-14&limitNum=5

返回 ​

json
响应json格式数据
{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "regionId": 3104001644,
    "dataTime": "2021-04-20",
    "regionChinaName": "邹平市",
    "cropId": 107,
    "cropName": "冬小麦",
    "levelDataVos": [
      {
        "levelId": 1,
        "levelName": "一类苗",
        "areaNum": 2064.75,
        "tenThousandAreaNum": 0.2
      }
    ]
  }
}

当前区域前N年同比玉米螟数据 ​

接口描述 ​

根据作物id、区域id、日期、同比年份条件, 获取当前区域前N年同比玉米螟数据

请求示例 url ​

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

请求方式 ​

GET

请求头 ​

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

请求参数 ​

属性说明例如是否必填
regionId区域id3104001644必填
cropId作物id107必填
dataTime日期2021-04-20必填
yearOnYearNum同比年份, 默认前3年3选填

例子 ​

json
https://gw.datall.cn/productapi/jh-api/borerDiseaseWarningRegionApi/queryRealtimeLastYears?regionId=3104001644&cropId=107&dataTime=2021-04-20&yearOnYearNum=3

返回 ​

json
{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "2021-02-05": {
      "regionId": 3104001644,
      "dataTime": "2021-04-20",
      "regionChinaName": "邹平市",
      "cropId": 107,
      "cropName": "冬小麦",
      "levelDataVos": [
        {
          "levelId": 1,
          "levelName": "一类苗",
          "areaNum": 2064.75,
          "tenThousandAreaNum": 0.2
        }
      ]
    }
  }
}

下级区域指定日期玉米螟数据 ​

接口描述 ​

根据作物id、日期、区域id条件, 获取下级区域指定日期玉米螟数据

请求示例 url ​

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

请求方式 ​

GET

请求头 ​

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

请求参数 ​

属性说明例如是否必填
regionId区域id3104001644必填
cropId作物id107必填
dataTime日期2021-04-20必填

例子 ​

json
https://gw.datall.cn/productapi/jh-api/borerDiseaseWarningRegionApi/queryRealtimeDataNextRegion?regionId=3104001644&cropId=107&dataTime=2021-04-20

返回 ​

json
响应json格式参数
{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "regionId": 3105020737,
    "dataTime": "2021-04-20",
    "regionChinaName": "码头镇",
    "cropId": 107,
    "cropName": "冬小麦",
    "levelDataVos": [
      {
        "levelId": 1,
        "levelName": "一类苗",
        "areaNum": 2064.75,
        "tenThousandAreaNum": 0.2
      }
    ]
  }
}

下级区域前N年同比玉米螟数据 ​

接口描述 ​

根据作物id、区域id、日期、同比年份条件, 获取下级区域前N年同比玉米螟数据

请求示例 url ​

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

请求方式 ​

GET

请求头 ​

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

请求参数 ​

属性说明例如是否必填
regionId区域id3104001644必填
cropId作物id107必填
dataTime日期2021-04-20必填
yearOnYearNum同比年份, 默认前3年3选填

例子 ​

json
https://gw.datall.cn/productapi/jh-api/borerDiseaseWarningRegionApi/queryNextRegionLastYears?regionId=3104001644&cropId=107&dataTime=2021-04-20&yearOnYearNum=3

返回 ​

json
响应json格式参数
{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "2021": {
      "regionId": 3105020737,
      "dataTime": "2021-04-20",
      "regionChinaName": "码头镇",
      "cropId": 107,
      "cropName": "冬小麦",
      "levelDataVos": [
        {
          "levelId": 1,
          "levelName": "一类苗",
          "areaNum": 2064.75,
          "tenThousandAreaNum": 0.2
        }
      ]
    }
  }
}

玉米螟瓦片图层 ​

请求示例 url ​

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

请求方式 ​

GET

请求头 ​

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

请求参数 ​

属性说明例如是否必填
regionId区域id3104001644必填
cropId作物id107必填
dataTime日期2021-04-20必填
bbox瓦片范围117.861328125,36.826171875,117.94921875,36.9140625必填
ServiceKey密钥f35a*************e5680b8必填
UserName用户名156****1376必填

例子 ​

json
https://gw.datall.cn/productapi/jh-api/borerDiseaseWarningRegionApi/loadTileLayer?regionId=3104001644&cropId=107&dataTime=2021-04-20&bbox=117.861328125,36.826171875,117.94921875,36.9140625

返回 ​

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