区域农情监测api文档

Appearance

长势 ​

产品简介 ​

长势产品用于评估和监测作物从萌芽、生长、成熟到开花结果的整个过程中生长状态、健康状况以及环境变化对作物生长的影响。通过将长势从“很差”到“很好”划分为若干等级，帮助农业管理者及时发现潜在问题，从而采取优化管理措施，最终实现提高作物产量和质量的目标。

技术原理 ​

基于反映作物生长的植被指数（如 NDVI、EVI、MSAVI 等），结合历年平均水平、物候期、区域和作物类型构建分级标准，进而获取作物长势信息。

分辨率 ​

覆盖范围更新频率数据源分辨率准确度
全球10 天10-16 米
全球16 天30 米
全球8 天500 米

图层示例 ​

An image

接口 ​

获取长势缩略图时间轴 ​

接口描述 ​

根据区域 id、作物 id、起始日期、终止日期条件, 获取长势缩略图时间轴

请求示例 url ​

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

请求方式 ​

GET

请求头 ​

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

请求参数 ​

属性说明例如是否必填
regionId区域 id3104001644必填
cropId作物 id107必填
startDate起始日期2022-01-01选填
endDate终止日期2022-12-31选填

例子 ​

json
https://gw.datall.cn/productapi/jh-api/growRegionApi/queryTimeAxisInfoBetweenDate?regionId=3104001644&cropId=102

返回 ​

json

{
    "flag": true,
    "code": null,
    "msg": null,
    "data": [
        {
            "dataTime": "2024-03-01",
            "layerName": "JH_PRODUCT:ly_DST-HU-JZU-1710138507_1710157536780_EarlyRice_20240301_S2_10M_grow_tif_rankid-1",
            "regionId": null,
            "regionCode": "DST-HU-JZU-1710138507",
            "dictCropId": null,
            "dictDatasetId": null,
            "regionMinMaxPoint": "113.24689030291357,29.967771839294688,113.27682992756964,29.98156061678144",
            "layerMinMaxPoint": "",
            "thumbnailUrl": "https://gw.datall.cn/productapi/jh-api/geoserverApi/getAnimateThumbnail?layerName=JH_PRODUCT:ly_DST-HU-JZU-1710138507_1710157536780_EarlyRice_20240301_S2_10M_grow_tif_rankid-1&regionCode=DST-HU-JZU-1710138507&BBOX=113.24689030291357,29.967771839294688,113.27682992756964,29.98156061678144&ServiceKey=3b1d1c180a1390443d161011c1ef1dec&UserName=15830756986",
            "urlRoot": "https://gw.datall.cn/productapi",
            "rankId": 1,
            "landId": null,
            "list": null,
            "bbox": ""
        },
        {
            "dataTime": "2024-03-11",
            "layerName": "JH_PRODUCT:ly_DST-HU-JZU-1710138507_1710157530988_EarlyRice_20240311_S2_10M_grow_tif_rankid-1",
            "regionId": null,
            "regionCode": "DST-HU-JZU-1710138507",
            "dictCropId": null,
            "dictDatasetId": null,
            "regionMinMaxPoint": "113.24689030291357,29.967771839294688,113.27682992756964,29.98156061678144",
            "layerMinMaxPoint": "",
            "thumbnailUrl": "https://gw.datall.cn/productapi/jh-api/geoserverApi/getAnimateThumbnail?layerName=JH_PRODUCT:ly_DST-HU-JZU-1710138507_1710157530988_EarlyRice_20240311_S2_10M_grow_tif_rankid-1&regionCode=DST-HU-JZU-1710138507&BBOX=113.24689030291357,29.967771839294688,113.27682992756964,29.98156061678144&ServiceKey=3b1d1c180a1390443d161011c1ef1dec&UserName=15830756986",
            "urlRoot": "https://gw.datall.cn/productapi",
            "rankId": 1,
            "landId": null,
            "list": null,
            "bbox": ""
        }
    ]
}

获取长势时间轴 ​

接口描述 ​

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

请求示例 url ​

json
https://gw.datall.cn/productapi/jh-api/growRegionApi/queryTimeAxisBetweenDate
请求方式 ​

GET

请求头 ​
属性说明例如是否必填
ServiceKey密钥f35a*********e5680b8必填
UserName用户名156****1376必填
请求参数 ​
属性说明例如是否必填
regionId区域 id3104001644必填
cropId作物 id107必填
startDate起始日期2021-04-20选填
endDate终止日期2021-04-20选填
例子 ​
json
https://gw.datall.cn/productapi/jh-api/growRegionApi/queryTimeAxisBetweenDate?regionId=3104001644&cropId=107&startDate=2018-01-01&endDate=2021-05-01
返回 ​
json

{
  "flag": true,
  "code": null,
  "msg": null,
  "data": ["2021-03-20", "2021-04-10", "2021-04-30"]
}

获取长势图例 ​

请求示例 url ​

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

请求方式 ​

GET

请求头 ​

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

例子 ​

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

返回 ​

json

{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "id": "01",
    "name": "长势模板",
    "unit": "无",
    "levelDataVos": [
      {
        "id": 98,
        "levelName": "很好",
        "maxColor": "#005BFF",
        "datasetName": "长势"
      }
    ]
  }
}

当前区域长势分级 ​

接口描述 ​

根据区域 id、作物 id、日期条件, 获取当前区域的长势分级。

请求示例 url ​

json
https://gw.datall.cn/productapi/jh-api/growRegionApi/queryRealtimeDataNew
请求方式 ​

GET

请求头 ​
属性说明例如是否必填
ServiceKey密钥f35a*********e5680b8必填
UserName用户名156****1376必填
请求参数 ​
属性说明例如是否必填
regionId区域 id3104001644必填
cropId作物 id107必填
dataTime日期2021-04-20必填
例子 ​
json
{
  "regionId": "3104001644",
  "cropId": "107",
  "dataTime": "2021-04-20"
}
返回 ​
json

{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "regionId": 3104001644,
    "dataTime": "2021-04-20",
    "regionChinaName": "邹平市",
    "cropId": 107,
    "cropName": "冬小麦",
    "levelDataVos": [
      {
        "sortNo": 1,
        "areaNum": 2064.75,
        "levelName": "很差"
      }
    ]
  }
}

下级区域长势分级 ​

接口描述 ​

根据区域 id、作物 id、日期条件, 获取下级区域的长势分级。

请求示例 url ​

json
https://gw.datall.cn/productapi/jh-api/growRegionApi/queryRealtimeDataNextRegionNew
请求方式 ​

GET

请求头 ​

属性说明例如是否必填
ServiceKey密钥f35a*********e5680b8必填
UserName用户名156****1376必填
请求参数 ​
属性说明例如是否必填
regionId区域 id3104001644必填
cropId作物 id107必填
dataTime日期2021-04-20必填
例子 ​
json
https://gw.datall.cn/productapi/jh-api/growRegionApi/queryRealtimeDataNextRegionNew?regionId=3104001644&cropId=107&dataTime=2021-04-20
返回 ​
json

{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "regionId": 3104001644,
    "dataTime": "2021-04-20",
    "regionChinaName": "邹平市",
    "cropId": 107,
    "cropName": "冬小麦",
    "levelDataVos": [
      {
        "sortNo": 1,
        "areaNum": 2064.75,
        "levelName": "很差"
      }
    ]
  }
}

获取长势近 3 年的同比数据 ​

接口描述 ​

根据区域 id、作物 id、日期条件, 获取长势近 3 年的同比数据。

请求示例 url ​

json

https://gw.datall.cn/productapi/jh-api/growRegionApi/queryLast3YearNew

请求方式 ​

GET

请求头 ​

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

请求参数 ​

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

例子 ​

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

返回 ​

json

{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "regionId": 3104001644,
    "dataTime": "2021-04-20",
    "regionChinaName": "邹平市",
    "cropId": 107,
    "cropName": "冬小麦",
    "levelDataVos": [
      {
        "sortNo": 1,
        "areaNum": 2064.75,
        "levelName": "很差"
      }
    ]
  }
}

获取长势图层 ​

请求示例 url ​

json

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

请求方式 ​

GET

请求头 ​

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

请求参数 ​

属性说明例如是否必填
regionId区域 id3104001644必填
cropId作物 id107必填
dataTime日期2021-04-20必填
bbox瓦片范围117.73773193359375,36.98272705078125,117.740478515625,36.9854736328125必填
ServiceKey密钥f35a*********e5680b8必填
UserName用户名156****1376必填

例子 ​

json
https://gw.datall.cn/productapi/jh-api/growRegionApi/loadTileLayer?regionId=3104001644&cropId=107&dataTime=2021-04-20&bbox=117.73773193359375,36.98272705078125,117.740478515625,36.9854736328125
返回 ​

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

获取长势地块图片 ​

接口描述 ​

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

请求示例 url ​

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

请求方式 ​

GET

请求头 ​

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

请求参数 ​

属性说明例如是否必填
landNo地块编号custom3103000244_202207270000000001347562必填
cropId作物 id107必填
dataTime日期2022-05-10必填

例子 ​

json
https://gw.datall.cn/productapi/jh-api/growLandApi/loadLandImage/custom3103000244_202207270000000001347562/107/2022-05-10

返回 ​

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

获取长势地块统计信息 ​

接口描述 ​

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

请求示例 url ​

json

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

请求方式 ​

GET

请求头 ​

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

请求参数 ​

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

例子 ​

json
https://gw.datall.cn/productapi/jh-api/growLandApi/statisticsLandData?landNo=custom3103000364_202205120000000023875407&cropId=120&dataTimeStr=2021-10-10

返回 ​

json

{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "MAX": 0,
    "MAX_NAME": "很差",
    "MEAN": 0,
    "MEAN_NAME": "很差",
    "MIN": 0,
    "MIN_NAME": "很差"
  }
}