区域农情监测api文档

Appearance

苗情 ​

产品简介 ​

苗情产品用来评估和监测作物从播种到苗期的生长状况。通过将苗情划分为弱苗、壮苗和旺长苗三个等级，帮助农业管理者及时了解作物苗期生长状况，从而实现“旺苗控长”和“弱苗促长”的管理目标，优化作物生长调控，确保农业生产的稳步发展。

技术原理 ​

应用物联网设备。

接口 ​

获取作物苗情缩略图时间轴 ​

请求示例 url ​

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

请求方法 ​

GET

请求头 ​

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

请求参数 ​

属性说明例如是否必填
regionId区域 id3102000019是
startDate开始日期2020-01-01否
cropId作物 id102是
endDate结束日期2020-01-01否

例子 ​

json
https://gw.datall.cn/productapi/jh-api/seedlingRegionApi/queryTimeAxisInfoBetweenDate?regionId=3104001644&cropId=107&startDate=&endDate=

返回 ​

json
{
    "flag": true,
    "code": null,
    "msg": null,
    "data": [
        {
            "dataTime": "2021-06-01",
            "layerName": "JH_PRODUCT:ly_CHN-HB-ZHA-YU_130726_Millet_20210601_SMAP_250m_seedling_tif_rankid-48",
            "regionCode": "CHN-HB-ZHA-YU",
            "thumbnailUrl": "https://gw.datall.cn/productapi/jh-api/geoserverApi/getAnimateThumbnail?layerName=JH_PRODUCT:ly_CHN-HB-ZHA-YU_130726_Millet_20210601_SMAP_250m_seedling_tif_rankid-48&regionCode=CHN-HB-ZHA-YU&BBOX=114.19197556,39.554768735,115.064021605,40.1974164850001&ServiceKey=1c226889648944208022de5e096dc1ae&UserName=18986642665",
            "bbox": "114.19197556,39.554768735,115.064021605,40.1974164850001"
        }

获取作物苗情时间轴 ​

接口描述 ​

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

请求示例 url ​

json
https://gw.datall.cn/productapi/jh-api/seedlingRegionApi/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/seedlingRegionApi/queryTimeAxis?regionId=3104001644&cropId=107&startDate=2018-02-10&endDate=2021-05-01

返回 ​

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/seedlingRegionApi/queryConfigRank

请求方式 ​

GET

请求头 ​

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

例子 ​

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

返回 ​

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/seedlingRegionApi/queryRealtimeDataToday

请求方式 ​

GET

请求头 ​

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

请求参数 ​

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

例子 ​

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

返回 ​

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/seedlingRegionApi/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/seedlingRegionApi/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/seedlingRegionApi/queryRealtimeDataLimitNum

请求方式 ​

GET

请求头 ​

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

请求参数 ​

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

例子 ​

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

返回 ​

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/seedlingRegionApi/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/seedlingRegionApi/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/seedlingRegionApi/queryRealtimeDataNextRegion

请求方式 ​

GET

请求头 ​

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

请求参数 ​

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

例子 ​

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

返回 ​

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/seedlingRegionApi/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/seedlingRegionApi/queryNextRegionLastYears?regionId=3104001644&cropId=107&dataTime=2021-04-20&yearOnYearNum=3

返回 ​

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/seedlingRegionApi/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/seedlingRegionApi/loadTileLayer?regionId=3104001644&cropId=107&dataTime=2021-04-20&bbox=117.861328125,36.826171875,117.94921875,36.9140625

返回 ​

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

获取作物苗情地块图片 ​

接口描述 ​

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

请求示例 url ​

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

请求方式 ​

GET

请求头 ​

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

请求参数 ​

属性说明例如是否必填
landNo地块编号custom3103000100_202205120000000026897454必填
cropId作物 id118必填
dataTime日期2021-08-10必填

例子 ​

json
https://gw.datall.cn/productapi/jh-api/seedlingLandApi/loadLandImage/custom3103000100_202205120000000026897454/118/2021-08-10

返回 ​

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

获取作物苗情地块统计信息 ​

接口描述 ​

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

请求示例 url ​

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

请求方式 ​

GET

请求头 ​

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

请求参数 ​

属性说明例如是否必填
landNo地块编号custom3103000100_202205120000000026897454必填
cropId作物 id118必填
dataTimeStr日期2021-08-10必填

例子 ​

json
https://gw.datall.cn/productapi/jh-api/seedlingLandApi/statisticsLandData?landNo=custom3103000100_202205120000000026897454&cropId=118&dataTimeStr=2021-08-10

返回 ​

json

{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "RANK_NAME": "一类苗"
  }
}