区域农情监测api文档

Appearance

低温冻害监测 ​

产品简介 ​

冻害是由于气温下降到 0℃ 以下，导致作物体内水分结冰，从而对作物造成的伤害。通过准确的冻害监测和及时预报，可以有效减少农作物的损失，提前采取措施，如灌溉、覆盖、喷施防冻液等，以保护作物。

技术原理 ​

结合气象因素和植被指数（NDVI），通过评估作物健康程度的恢复情况来进行判断受灾程度。但采用遥感（卫星或者无人机）手段具有滞后性，且辅助少量的现场抽样，提高估损的准确性。

图层示例 ​

An image

接口 ​

获取农作物冻害时间轴 ​

接口描述 ​

根据作物id、区域id、起始日期、终止日期条件, 获取农作物冻害时间轴

请求示例 url ​

json

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

请求方式 ​

GET

请求头 ​

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

请求参数 ​

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

示例 ​

json
https://gw.datall.cn/productapi/jh-api/cropFreezeInjuryRegionApi/queryTimeAxis?regionId=3105019882&cropId=102&startDate=2021-02-05&endDate=2021-05-01

返回 ​

json

{
  "flag": true,
  "code": null,
  "msg": null,
  "data": [
    "2021-02-05"
  ]
}

获取农作物冻害图例 ​

请求示例 url ​

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

请求方式 ​

GET

请求头 ​

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

示例 ​

json
https://gw.datall.cn/productapi/jh-api/cropFreezeInjuryRegionApi/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 ​

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

请求方式 ​

GET

请求头 ​

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

请求参数 ​

属性说明例如是否必填
regionId区域id3105019882必填
cropId作物id102必填
dataTime日期2018-10-12必填

示例 ​

json
https://gw.datall.cn/productapi/jh-api/cropFreezeInjuryRegionApi/queryRealtimeDataToday?regionId=3105019882&cropId=102&dataTime=2018-10-12

返回 ​

json

{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "regionId": 3105019882,
    "dataTime": "2018-10-12",
    "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/cropFreezeInjuryRegionApi/queryRealtimeDataBetweenDate

请求方式 ​

GET

请求头 ​

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

请求参数 ​

属性说明例如是否必填
regionId区域id3105019882必填
cropId作物id102必填
startDate起始日期2018-10-12必填
endDate终止日期2021-05-10必填

示例 ​

json
https://gw.datall.cn/productapi/jh-api/cropFreezeInjuryRegionApi/queryRealtimeDataBetweenDate?regionId=3105019882&cropId=102&startDate=2018-10-12&endDate=2021-05-10

返回 ​

json

{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "regionId": 3105019882,
    "dataTime": "2018-10-12",
    "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/cropFreezeInjuryRegionApi/queryRealtimeDataLimitNum

请求方式 ​

GET

请求头 ​

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

请求参数 ​

属性说明例如是否必填
regionId区域id3105019882必填
cropId作物id102必填
dataTime日期2018-10-12必填
limitNum当前日期前N期，默认55选填

示例 ​

json
https://gw.datall.cn/productapi/jh-api/cropFreezeInjuryRegionApi/queryRealtimeDataLimitNum?regionId=3105019882&cropId=102&dataTime=2018-10-12&limitNum=5

返回 ​

json

{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "regionId": 3105019882,
    "dataTime": "2018-10-12",
    "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/cropFreezeInjuryRegionApi/queryRealtimeLastYears

请求方式 ​

GET

请求头 ​

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

请求参数 ​

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

示例 ​

json
https://gw.datall.cn/productapi/jh-api/cropFreezeInjuryRegionApi/queryRealtimeLastYears?regionId=3105019882&cropId=102&dataTime=2021-02-05&yearOnYearNum=3

返回 ​

json

{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "2021-02-05": {
      "regionId": 3105019882,
      "dataTime": "2021-02-05",
      "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/cropFreezeInjuryRegionApi/queryRealtimeDataNextRegion

请求方式 ​

GET

请求头 ​

FC

请求参数 ​

属性说明例如是否必填
regionId区域id3104001429必填
cropId作物id102必填
dataTime日期2021-02-05必填

示例 ​

json
https://gw.datall.cn/productapi/jh-api/cropFreezeInjuryRegionApi/queryRealtimeDataNextRegion?regionId=3104001429&cropId=102&dataTime=2021-02-05

返回 ​

json


{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "regionId": 3105019882,
    "dataTime": "2021-02-05",
    "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/cropFreezeInjuryRegionApi/queryNextRegionLastYears

请求方式 ​

GET

请求头 ​

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

请求参数 ​

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

示例 ​

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

返回 ​

json

{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "2021": [
      {
        "regionId": 3105019882,
        "dataTime": "2021-02-05",
        "regionChinaName": "大杨树镇",
        "cropId": 102,
        "cropName": "夏玉米",
        "levelDataVos": [
          {
            "levelId": 1,
            "levelName": "轻度灾区",
            "areaNum": 2064.75,
            "tenThousandAreaNum": 0.2
          }
        ]
      }
    ]
  }
}

农作物冻害瓦片图层 ​

请求示例 url ​

json

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

请求方式 ​

GET

请求头 ​

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

请求参数 ​

属性说明例如是否必填
regionId区域id3103000364必填
cropId作物id103必填
dataTime日期2019-08-10必填
bbox瓦片范围118.828125,34.453125,118.916015625,34.541015625必填
ServiceKey密钥f35a*************e5680b8必填
UserName用户名156****1376必填

示例 ​

json
https://gw.datall.cn/productapi/jh-api/cropFreezeInjuryRegionApi/loadTileLayer?regionId=3103000364&cropId=103&dataTime=2019-08-10&bbox=118.828125,34.453125,118.916015625,34.541015625

返回 ​

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

获取农作物冻害地块图片 ​

接口描述 ​

根据地块编号、日期、作物id条件, 获取当前区域农作物冻害地块图片。

请求示例 url： ​

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

请求方式 ​

GET

请求头: ​

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

请求参数 ​

属性说明例如是否必填
landNo地块编号custom3103000244_202205120000000048475012必填
cropId作物id107必填
dataTime日期2021-03-01必填

示例 ​

json
https://gw.datall.cn/productapi/jh-api/cropFreezeLandApi/loadLandImage/custom3103000244_202205120000000048475012/107/2021-03-01

返回 ​

json

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

获取农作物冻害地块统计信息 ​

接口描述 ​

根据地块编号、日期、作物id条件, 获取当前区域农作物冻害统计数据。

请求示例 url ​

json

ttps://gw.datall.cn/productapi/jh-api/cropFreezeLandApi/statisticsLandData

请求方式 ​

GET

请求头: ​

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

请求参数 ​

参数说明例如是否必填
ServiceKey密钥f35a*************e5680b8必填
UserName用户名156****1376必填
landNo地块编号custom3103000244_202205120000000048475012必填
cropId作物id107必填
dataTimeStr日期2021-03-01必填

示例 ​

json
https://gw.datall.cn/productapi/jh-api/cropFreezeLandApi/statisticsLandData?landNo=custom3103000244_202205120000000048475012&cropId=107&dataTimeStr=2021-03-01

返回 ​

json


{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "RANK": 2,
    "RANK_NAME": "轻度灾区"
  }
}