区域农情监测api文档

Appearance

干旱监测 ​

产品简介 ​

作物生育期内，由于土壤水分持续不足而造成的作物体内水分亏缺，影响作物正常生长发育的现象。农业干旱等级标准划分为轻旱、中旱、重旱和特旱四个等级。通过监测作物旱情，指导作物灌溉，并评估损失情况。

技术原理 ​

卫星遥感技术通过综合利用温度植被干旱指数（TVDI）、归一化差值水分指数（NDMI）、归一化多波段干旱指数（NMDI），获取土壤水分含量、植被冠层水分含量信息，从而得到作物受到干旱的受灾程度。

图层示例 ​

An image

接口 ​

获取农作物干旱时间轴 ​

接口描述 ​

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

请求示例 url ​

json

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

请求方式 ​

GET

请求头 ​

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

请求参数 ​

参数说明例如是否必填
regionId区域 id3104002050必填
cropId作物 id120必填
startDate起始日期2021-08-23选填
endDate终止日期2021-10-01选填

示例 ​

json
https://gw.datall.cn/productapi/jh-api/cropDroughtRegionApi/queryTimeAxis?regionId=3104002050&cropId=120&startDate=2021-08-23&endDate=2021-10-01

返回 ​

json
{
  "flag": true,
  "code": null,
  "msg": null,
  "data": ["2021-08-23"]
}

获取农作物干旱图例 ​

请求示例 url ​

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

请求方式 ​

GET

请求头 ​

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

示例 ​

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

请求方式 ​

GET

请求头 ​

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

请求参数 ​

参数说明例如是否必填
regionId区域 id3104002050必填
cropId作物 id120必填
dataTime日期2021-08-23必填

示例 ​

json
https://gw.datall.cn/productapi/jh-api/cropDroughtRegionApi/queryRealtimeDataToday?regionId=3104002050&cropId=120&dataTime=2021-08-23

返回 ​

json
{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "regionId": 3104002050,
    "dataTime": "2021-08-23",
    "regionChinaName": "阿瓦提县",
    "cropId": 120,
    "cropName": "棉花",
    "levelDataVos": [
      {
        "levelId": 1,
        "levelName": "轻度灾区",
        "areaNum": 2064.75,
        "tenThousandAreaNum": 0.2
      }
    ]
  }
}

当前区域指定时间段内农作物干旱数据 ​

接口描述 ​

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

请求示例 url ​

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

请求方式 ​

GET

请求头 ​

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

请求参数 ​

参数说明例如是否必填
regionId区域 id3104002050必填
cropId作物 id120必填
startDate起始日期2021-08-23必填
endDate终止日期2021-10-23必填

示例 ​

json
https://gw.datall.cn/productapi/jh-api/cropDroughtRegionApi/queryRealtimeDataBetweenDate?regionId=3104002050&cropId=120&startDate=2021-08-23&endDate=2021-10-23

返回 ​

json
{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "regionId": 3104002050,
    "dataTime": "2021-08-23",
    "regionChinaName": "阿瓦提县",
    "cropId": 120,
    "cropName": "棉花",
    "levelDataVos": [
      {
        "levelId": 1,
        "levelName": "轻度灾区",
        "areaNum": 2064.75,
        "tenThousandAreaNum": 0.2
      }
    ]
  }
}

当前区域前几期农作物干旱数据 ​

接口描述 ​

根据作物 id、日期、区域 id、当前前 N 期条件, 获取当前区域前几期农作物干旱数据

请求示例 url ​

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

请求方式 ​

GET

请求头 ​

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

请求参数 ​

参数说明例如是否必填
regionId区域 id3104002050必填
cropId作物 id120必填
dataTime日期2021-08-23必填
limitNum当前日期前 N 期，默认 55选填

示例 ​

json
https://gw.datall.cn/productapi/jh-api/cropDroughtRegionApi/queryRealtimeDataLimitNum?regionId=3104002050&cropId=120&dataTime=2021-08-23&limitNum=5

返回 ​

json
{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "regionId": 3104002050,
    "dataTime": "2021-08-23",
    "regionChinaName": "阿瓦提县",
    "cropId": 120,
    "cropName": "棉花",
    "levelDataVos": [
      {
        "levelId": 1,
        "levelName": "轻度灾区",
        "areaNum": 2064.75,
        "tenThousandAreaNum": 0.2
      }
    ]
  }
}

当前区域前 N 年同比农作物干旱数据 ​

接口描述 ​

根据作物 id、日期、区域 id、同比年份条件, 获取当前区域前 N 年同比农作物干旱数据

请求示例 url ​

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

请求方式 ​

GET

请求头 ​

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

请求参数 ​

参数说明例如是否必填
regionId区域 id3104002050必填
cropId作物 id120必填
dataTime日期2021-08-23必填
yearOnYearNum同比年份，默认前 3 年3选填

示例 ​

json
https://gw.datall.cn/productapi/jh-api/cropDroughtRegionApi/queryRealtimeLastYears?regionId=3104002050&cropId=120&dataTime=2021-08-23&yearOnYearNum=3

返回 ​

json
{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "2021-02-05": {
      "regionId": 3104002050,
      "dataTime": "2021-08-23",
      "regionChinaName": "阿瓦提县",
      "cropId": 120,
      "cropName": "棉花",
      "levelDataVos": [
        {
          "levelId": 1,
          "levelName": "轻度灾区",
          "areaNum": 2064.75,
          "tenThousandAreaNum": 0.2
        }
      ]
    }
  }
}

下级区域指定日期农作物干旱数据 ​

接口描述 ​

根据作物 id、日期、区域 id 条件, 获取下级区域指定日期农作物干旱数据

请求示例 url ​

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

请求方式 ​

GET

请求头 ​

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

请求参数 ​

参数说明例如是否必填
regionId区域 id3104002050必填
cropId作物 id120必填
dataTime日期2021-08-23必填

示例 ​

json
https://gw.datall.cn/productapi/jh-api/cropDroughtRegionApi/queryRealtimeDataNextRegion?regionId=3104002050&cropId=120&dataTime=2021-08-23

返回 ​

json
{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "regionId": 3104002050,
    "dataTime": "2021-08-23",
    "regionChinaName": "阿瓦提县",
    "cropId": 120,
    "cropName": "棉花",
    "levelDataVos": [
      {
        "levelId": 1,
        "levelName": "轻度灾区",
        "areaNum": 2064.75,
        "tenThousandAreaNum": 0.2
      }
    ]
  }
}

下级区域前 N 年同比农作物干旱数据 ​

接口描述 ​

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

请求示例 url ​

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

请求方式 ​

GET

请求头 ​

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

请求参数 ​

参数说明例如是否必填
regionId区域 id3104002050必填
cropId作物 id120必填
dataTime日期2021-08-23必填
yearOnYearNum同比年份，默认前 3 年3选填

示例 ​

json
https://gw.datall.cn/productapi/jh-api/cropDroughtRegionApi/queryNextRegionLastYears?regionId=3104002050&cropId=120&dataTime=2021-08-23&yearOnYearNum=3

返回 ​

json
{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "2021": [
      {
        "regionId": 3104002050,
        "dataTime": "2021-08-23",
        "regionChinaName": "阿瓦提县",
        "cropId": 120,
        "cropName": "棉花",
        "levelDataVos": [
          {
            "levelId": 1,
            "levelName": "轻度灾区",
            "areaNum": 2064.75,
            "tenThousandAreaNum": 0.2
          }
        ]
      }
    ]
  }
}

农作物干旱瓦片图层 ​

请求示例 url ​

json

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

请求方式 ​

GET

请求头 ​

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

请求参数 ​

参数说明例如是否必填
regionId区域 id3104002050必填
cropId作物 id120必填
dataTime日期2021-08-23必填
bbox瓦片范围80.33203125,40.517578125,80.419921875,40.60546875必填
ServiceKey密钥f35a*********e5680b8必填
UserName用户名156****1376必填

示例 ​

json
https://gw.datall.cn/productapi/jh-api/cropDroughtRegionApi/loadTileLayer?regionId=3104002050&cropId=120&dataTime=2021-08-23&bbox=80.33203125,40.517578125,80.419921875,40.60546875

返回 ​

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

获取农作物干旱地块图片 ​

接口描述 ​

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

请求示例 url ​

json

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

请求方式 ​

GET

请求头 ​

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

请求参数 ​

参数说明例如是否必填
landNo地块编号custom3103000244_202205120000000043791506必填
cropId作物 id102必填
dataTime日期2021-07-01必填

示例 ​

json
https://gw.datall.cn/productapi/jh-api/cropDroughtLandApi/loadLandImage/custom3103000244_202205120000000043791506/102/2021-07-01

返回 ​

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

获取农作物干旱地块统计信息 ​

接口描述 ​

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

请求示例 url ​

json

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

请求方式 ​

GET

请求头 ​

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

参数 ​

参数说明例如是否必填
landNo地块编号custom3103000244_202205120000000043791506必填
cropId作物 id102必填
dataTimeStr日期2021-07-01必填

示例 ​

json
https://gw.datall.cn/productapi/jh-api/cropDroughtLandApi/statisticsLandData?landNo=custom3103000244_202205120000000043791506&cropId=102&dataTimeStr=2021-07-01

返回 ​

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