区域农情监测api文档

Appearance

洪涝监测 ​

产品简介 ​

洪涝是指由于降水过于集中或持续时间过长，导致农田积水或作物根层土壤持续处于过湿状态，作物根系被水长期浸泡缺氧，造成作物生长不良、严重减产或死亡的农业气象灾害。多发于降水集中的季节，尤其是汛期、地势低洼、排水不畅的旱地。通过监测作物淹没范围，评估损失情况。

技术原理 ​

利用灾害发生前后的时序合成孔径雷达影像（SAR），基于水体与其他地物在 SAR 影像中的反射特性差异识别水体，得到灾前灾后的水体分布图。从而得到新增水体，即灾后的淹没范围。

图层示例 ​

An image

接口 ​

获取农作物倒伏时间轴 ​

接口描述 ​

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

请求示例 url ​

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

请求方式 ​

GET

请求头 ​

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

请求参数 ​

参数说明例如是否必填
regionId区域 id3105021371必填
cropId作物 id108必填
startDate起始日期2020-05-19选填
endDate终止日期2021-05-01选填

示例 ​

json
https://gw.datall.cn/productapi/jh-api/cropBeatingDownRegionApi/queryTimeAxis?regionId=3105021371&cropId=108&startDate=2020-05-19&endDate=2021-05-01

返回 ​

json

{
  "flag": true,
  "code": null,
  "msg": null,
  "data": [
    "2020-05-19"
  ]
}

获取农作物倒伏图例 ​

请求示例 url ​

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

请求方式 ​

GET

请求头 ​

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

例子 ​

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

返回 ​

json

{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "id": "01",
    "name": "农作物倒伏模板",
    "unit": "无",
    "levelDataVos": [
      {
        "id": 98,
        "levelName": 0.1,
        "maxValue": 1,
        "minValue": 1,
        "colorCode": "#018506",
        "colorName": null
      }
    ]
  }
}

当前区域指定日期农作物倒伏数据 ​

接口描述 ​

根据作物 id、日期、区域 id 条件, 获取当前区域指定日期农作物倒伏数据。

请求示例 url ​

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

请求方式 ​

GET

请求头 ​

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

请求参数 ​

参数说明例如是否必填
regionId区域 id3105021371必填
cropId作物 id108必填
dataTime日期2020-05-19必填

示例 ​

json
 https://gw.datall.cn/productapi/jh-api/cropBeatingDownRegionApi/queryRealtimeDataToday?regionId=3105021371&cropId=108&dataTime=2020-05-19

返回 ​

json

{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "regionId": 3105021371,
    "dataTime": "2020-05-19",
    "regionChinaName": "小孟镇",
    "cropId": 108,
    "cropName": "春小麦",
    "levelDataVos": [
      {
        "levelId": 1,
        "levelName": "倒伏",
        "areaNum": 2064.75,
        "tenThousandAreaNum": 0.2
      }
    ]
  }
}

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

接口描述 ​

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

请求示例 url ​

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

请求方式 ​

GET

请求头 ​

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

请求参数 ​

参数说明例如是否必填
regionId区域 id3105021371必填
cropId作物 id108必填
startDate起始日期2020-05-19必填
endDate终止日期2021-05-10必填

示例 ​

json
https://gw.datall.cn/productapi/jh-api/cropBeatingDownRegionApi/queryRealtimeDataBetweenDate?regionId=3105021371&cropId=108&startDate=2020-05-19&endDate=2021-05-10

返回 ​

json

{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "regionId": 3105021371,
    "dataTime": "2020-05-19",
    "regionChinaName": "小孟镇",
    "cropId": 108,
    "cropName": "春小麦",
    "levelDataVos": [
      {
        "levelId": 1,
        "levelName": "倒伏",
        "areaNum": 2064.75,
        "tenThousandAreaNum": 0.2
      }
    ]
  }
}

当前区域前几期农作物倒伏数据 ​

接口描述 ​

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

请求示例 url ​

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

请求方式 ​

GET

请求头 ​

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

请求参数 ​

参数说明例如是否必填
regionId区域 id3105021371必填
cropId作物 id108必填
dataTime日期2020-05-19必填
limitNum当前日期前 N 期，默认 55选填

示例 ​

json
https://gw.datall.cn/productapi/jh-api/cropBeatingDownRegionApi/queryRealtimeDataLimitNum?regionId=3105021371&cropId=108&dataTime=2020-05-19&limitNum=5

返回 ​

json

{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "regionId": 3105021371,
    "dataTime": "2020-05-19",
    "regionChinaName": "小孟镇",
    "cropId": 108,
    "cropName": "春小麦",
    "levelDataVos": [
      {
        "levelId": 1,
        "levelName": "倒伏",
        "areaNum": 2064.75,
        "tenThousandAreaNum": 0.2
      }
    ]
  }
}

当前区域前 N 年同比农作物倒伏数据 ​

接口描述 ​

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

请求示例 url ​

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

请求方式 ​

GET

请求头 ​

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

请求参数 ​

参数说明例如是否必填
regionId区域 id3105021371必填
cropId作物 id108必填
dataTime日期2020-05-19必填
yearOnYearNum同比年份，默认前 3 年3选填

示例 ​

json
https://gw.datall.cn/productapi/jh-api/cropBeatingDownRegionApi/queryRealtimeLastYears?regionId=3105021371&cropId=108&dataTime=2020-05-19&yearOnYearNum=3

返回 ​

json

{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "2021-02-05": {
      "regionId": 3105021371,
      "dataTime": "2020-05-19",
      "regionChinaName": "小孟镇",
      "cropId": 108,
      "cropName": "春小麦",
      "levelDataVos": [
        {
          "levelId": 1,
          "levelName": "倒伏",
          "areaNum": 2064.75,
          "tenThousandAreaNum": 0.2
        }
      ]
    }
  }
}

下级区域指定日期农作物倒伏数据 ​

接口描述 ​

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

请求示例 url ​

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

请求方式 ​

GET

请求头 ​

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

请求参数 ​

参数说明例如是否必填
regionId区域 id3104003086必填
cropId作物 id108必填
dataTime日期2020-05-19必填

示例 ​

json
https://gw.datall.cn/productapi/jh-api/cropBeatingDownRegionApi/queryRealtimeDataNextRegion?regionId=3104003086&cropId=108&dataTime=2020-05-19

响应 json 格式数据： ​

{ "flag": true, "code": null, "msg": null, "data": { "regionId": 3105021371, "dataTime": "2020-05-19", "regionChinaName": "小孟镇", "cropId": 108, "cropName": "春小麦", "levelDataVos": [ { "levelId": 1, "levelName": "倒伏", "areaNum": 2064.75, "tenThousandAreaNum": 0.2 } ] } }

下级区域前 N 年同比农作物倒伏数据 ​

接口描述 ​

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

请求示例 url ​

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

请求方式 ​

GET

请求头 ​

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

请求参数 ​

参数说明例如是否必填
regionId区域 id3104003086必填
cropId作物 id108必填
dataTime日期2020-05-19必填
yearOnYearNum同比年份，默认前 3 年3选填

示例 ​

json

https://gw.datall.cn/productapi/jh-api/cropBeatingDownRegionApi/queryNextRegionLastYears?regionId=3104003086&cropId=108&dataTime=2020-05-19&yearOnYearNum=3

返回 ​

json

{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "2021": [
      {
        "regionId": 3105021371,
        "dataTime": "2020-05-19",
        "regionChinaName": "小孟镇",
        "cropId": 108,
        "cropName": "春小麦",
        "levelDataVos": [
          {
            "levelId": 1,
            "levelName": "倒伏",
            "areaNum": 2064.75,
            "tenThousandAreaNum": 0.2
          }
        ]
      }
    ]
  }
}

农作物倒伏瓦片图层 ​

请求示例 url ​

json

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

请求方式 ​

GET

请求头 ​

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

请求参数 ​

参数说明例如是否必填
regionId区域 id3105021371必填
cropId作物 id108必填
dataTime日期2020-05-19必填
bbox瓦片范围87.4951171,44.3408203,87.53906,44.384765必填
ServiceKey密钥f35a*********e5680b8必填
UserName用户名156****1376必填

示例 ​

json
https://gw.datall.cn/productapi/jh-api/cropBeatingDownRegionApi/loadTileLayer?regionId=3105021371&cropId=108&dataTime=2020-05-19&bbox=87.4951171,44.3408203,87.53906,44.384765

返回 ​

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

获取农作物倒伏地块图片 ​

接口描述 ​

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

请求示例 url ​

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

请求方式 ​

GET

请求头 ​

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

请求参数 ​

参数说明例如是否必填
landNo地块编号custom3103000249_202205120000000047862188必填
cropId作物 id108必填
dataTime日期2020-05-19必填

示例 ​

json
https://gw.datall.cn/productapi/jh-api/cropBeatingDownLandApi/loadLandImage/custom3103000249_202205120000000047862188/108/2020-05-19

返回 ​

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

获取农作物倒伏地块统计信息 ​

接口描述 ​

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

请求示例 url ​

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

请求方式 ​

GET

请求头 ​

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

请求参数 ​

参数说明例如是否必填
landNo地块编号custom3103000249_202205120000000047862188必填
cropId作物 id108必填
dataTimeStr日期2020-05-19必填

示例 ​

json
https://gw.datall.cn/productapi/jh-api/cropBeatingDownLandApi/statisticsLandData?landNo=custom3103000249_202205120000000047862188&cropId=108&dataTimeStr=2020-05-19

返回 ​

json

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