区域农情监测api文档

Appearance

玉米大斑病预警 ​

产品简介 ​

玉米大斑病是由大斑病凸脐蠕孢引起的玉米病害，主要发生在春玉米拔节至出穗期。该病害在我国各玉米产区均有发生，以春玉米种植区为主。通过对病害状况进行分级，农业管理者可快速识别出病害高危区域，从而及时采取防控措施，抑制病害的进一步发展。

技术原理 ​

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

分辨率 ​

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

图层示例 ​

An image

接口 ​

获取缩略图时间轴 ​

请求示例 url ​

json
https://gw.datall.cn/productapi/jh-api/turcicumForecastRegionApi/queryTimeAxisInfoBetweenDate

请求方式 ​

GET

请求头 ​

属性说明举例是否必填
ServiceKey密钥f25a*******6326b9是
UserName用户名176****1322是

请求参数 ​

属性说明举例是否必填
regionId区域id3102000019是
startDate数据开始日期2021-11-24否
cropId作物id102是
endDate数据结束日期2021-11-24否

示例 ​

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

返回 ​

json
响应json格式数据
{
    "flag": true,
    "code": null,
    "msg": null,
    "data": [
        {
            "dataTime": "2021-05-13",
            "layerName": "JH_PRODUCT:ly_CHN-SD-BIN-ZOU_510904_20210503_20210513_SummerCorn_250M_LeafBlightForecast_rank_tif_rankid-70",
            "regionCode": "CHN-SD-BIN-ZOU",
            "thumbnailUrl": "https://gw.datall.cn/productapi/jh-api/geoserverApi/getAnimateThumbnail?layerName=JH_PRODUCT:ly_CHN-SD-BIN-ZOU_510904_20210503_20210513_SummerCorn_250M_LeafBlightForecast_rank_tif_rankid-70&regionCode=CHN-SD-BIN-ZOU&BBOX=117.307928085413,36.6898174284316,117.955854415649,37.14550206287&ServiceKey=1c226889648944208022de5e096dc1ae&UserName=18986642665",
            "bbox": "117.307928085413,36.6898174284316,117.955854415649,37.14550206287"
        }

获取大斑病预警时间轴 ​

接口描述 ​

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

请求示例 url ​

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

请求方式 ​

GET

请求头 ​

属性说明举例是否必填
ServiceKey密钥f25a*******6326b9是
UserName用户名176****1322是

请求参数 ​

属性说明举例是否必填
regionId区域id3104001644必填
cropId作物id102必填
startDate起始日期2020-01-01选填
endDate终止日期2021-05-01选填

例子 ​

json
https://gw.datall.cn/productapi/jh-api/turcicumForecastRegionApi/queryTimeAxisInfoBetweenDate?regionId=3104001644&cropId=102&startDate=2020-01-01&endDate=2021-05-01

返回 ​

json

{
  "flag": true,
  "code": null,
  "msg": null,
  "data": [
    "2020-10-10",
    "2020-10-20",
    "2020-10-30",
    "2020-11-10"
  ]
}

获取大斑病预警图例 ​

请求示例 url ​

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

请求方式 ​

GET

请求头 ​

属性说明举例是否必填
ServiceKey密钥f25a*******6326b9是
UserName用户名176****1322是

例子 ​

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

返回 ​

json
{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "id": "01",
    "name": "大斑病预警模板",
    "unit": "无",
    "levelDataVos": [
      {
        "id": 98,
        "levelName": "低风险",
        "maxValue": 1,
        "minValue": 1,
        "colorCode": "#018506",
        "colorName": null
      }
    ]
  }
}

当前区域指定日期大斑病预警数据 ​

接口描述 ​

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

请求示例 url ​

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

请求方式 ​

GET

请求头 ​

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

请求参数 ​

属性说明举例是否必填
regionId区域id3104001644必填
cropId作物id102必填
dataTime日期2021-09-15必填

例子 ​

json
https://gw.datall.cn/productapi/jh-api/turcicumForecastRegionApi/queryRealtimeDataToday?regionId=3104001644&cropId=102&dataTime=2021-09-15

返回 ​

json
{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "regionId": 3104001644,
    "dataTime": "2021-09-15",
    "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/turcicumForecastRegionApi/queryRealtimeDataBetweenDate

请求方式 ​

GET

请求方式 ​

GET

请求头 ​

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

请求参数 ​

属性说明举例是否必填
regionId区域id3104001644必填
cropId作物id102必填
startDate起始日期2021-01-01必填
endDate终止日期2021-09-15必填

例子 ​

json
https://gw.datall.cn/productapi/jh-api/turcicumForecastRegionApi/queryRealtimeDataBetweenDate?regionId=3104001644&cropId=102&startDate=2021-01-01&endDate=2021-09-15

返回 ​

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

当前区域前几期大斑病预警数据 ​

接口描述 ​

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

请求示例 url ​

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

请求方式 ​

GEt

请求头 ​

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

请求参数 ​

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

例子 ​

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

返回 ​

json
{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "regionId": 3104001644,
    "dataTime": "2021-09-15",
    "regionChinaName": "邹平市",
    "cropId": 102,
    "cropName": "夏玉米",
    "levelDataVos": [
      {
        "levelId": 1,
        "levelName": "低风险",
        "areaNum": 2064.75,
        "tenThousandAreaNum": 0.2
      }
    ]
  }
}

当前区域前N年同比大斑病预警数据 ​

接口描述 ​

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

请求示例 url ​

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

请求方式 ​

GET

请求头 ​

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

请求参数 ​

属性说明举例是否必填
regionId区域id3104001644必填
cropId作物id102必填
dataTime日期2021-09-15必填
yearOnYearNum同比年份，默认前3年3选填

例子 ​

https://gw.datall.cn/productapi/jh-api/turcicumForecastRegionApi/queryRealtimeLastYears?regionId=3104001644&cropId=102&dataTime=2021-09-15&yearOnYearNum=3

返回 ​

json
{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "2021-02-05": {
      "regionId": 3104001644,
      "dataTime": "2021-09-15",
      "regionChinaName": "邹平市",
      "cropId": 102,
      "cropName": "夏玉米",
      "levelDataVos": [
        {
          "levelId": 1,
          "levelName": "低风险",
          "areaNum": 2064.75,
          "tenThousandAreaNum": 0.2
        }
      ]
    }
  }
}

下级区域指定日期大斑病预警数据 ​

接口描述 ​

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

请求示例 url ​

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

请求方式 ​

GET

请求头 ​

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

请求参数 ​

属性说明举例是否必填
regionId区域id3104001644必填
cropId作物id102必填
dataTime日期2021-09-15必填

例子 ​

https://gw.datall.cn/productapi/jh-api/turcicumForecastRegionApi/queryRealtimeDataNextRegion?regionId=3104001644&cropId=102&dataTime=2021-09-15

返回 ​

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

下级区域前N年同比大斑病预警数据 ​

接口描述 ​

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

请求示例 url ​

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

请求方式 ​

GET

请求头 ​

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

请求参数 ​

属性说明举例是否必填
regionId区域id3104001644必填
cropId作物id102必填
dataTime日期2021-05-12必填
yearOnYearNum

例子 ​

json
https://gw.datall.cn/productapi/jh-api/turcicumForecastRegionApi/queryNextRegionLastYears?regionId=3104001644&cropId=102&dataTime=2021-05-12&yearOnYearNum=3

返回 ​

json
响应json格式数据
{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "2021": [
      {
        "regionId": 3105020731,
        "dataTime": "2021-09-15",
        "regionChinaName": "好生街道",
        "cropId": 102,
        "cropName": "夏玉米",
        "levelDataVos": [
          {
            "levelId": 1,
            "levelName": "低风险",
            "areaNum": 2064.75,
            "tenThousandAreaNum": 0.2
          }
        ]
      }
    ]
  }
}

大斑病预警瓦片图层 ​

请求示例 url ​

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

请求方式 ​

GET

请求头 ​

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

请求参数 ​

属性说明举例是否必填
regionId区域id3104001644必填
cropId作物id102必填
dataTime日期2021-09-15必填
bbox瓦片范围117.8173828125,36.9580078125,117.861328125,37.001953125必填
ServiceKey密钥f35a*************e5680b8必填
UserName用户名156****1376必填

例子 ​

json
https://gw.datall.cn/productapi/jh-api/turcicumForecastRegionApi/loadTileLayer?regionId=3104001644&cropId=102&dataTime=2021-09-15&bbox=117.8173828125,36.9580078125,117.861328125,37.001953125

返回 ​

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

获取发病预警数据 ​

接口描述 ​

根据作物id、日期、区域id条件, 获取当前区域指定日期气象预警说明。

请求示例 url ​

json
https://gw.datall.cn/productapi/jh-api/turcicumForecastRegionApi/queryDesc

请求方式 ​

GET

请求头 ​

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

请求参数 ​

属性说明举例是否必填
regionId区域id3104001651必填
cropId作物id102必填
dataTime日期2022-08-25必填

例子 ​

json
https://gw.datall.cn/productapi/jh-api/turcicumForecastRegionApi/queryDesc?regionId=3104001651&cropId=102&dataTime=2022-08-25

返回 ​

json
响应json格式数据
{
  "flag": true,
  "code": null,
  "msg": null,
  "data": "暂无夏玉米大斑病风险，请及时关注作物状态！"
}