区域农情监测api文档

Appearance

大宗作物分布 ​

产品简介 ​

该产品实现了对中国各区域大宗主粮作物（水稻、小麦、玉米等）空间分布状况的精准绘制。全面掌握作物的空间分布信息，是开展作物长势监测、灾害评估、区域粮食产量估算以及粮食价格预测的重要基础。同时，也为各级政府部门制定粮食生产政策提供了关键的数据支持和科学参考。

技术原理 ​

该产品基于机器学习和深度学习技术，结合丰富的空间样本数据，提取作物关键生育期的关键特征，实现了大宗作物空间分布信息的快速提取。

分辨率 ​

覆盖范围更新频率数据源分辨率准确度
全球关键物候期/每月亚米级
全球关键物候期/每月1-3 米
全球关键物候期/每月10-30 米

图层示例 ​

An image

接口 ​

获取作物分布缩略图时间轴 ​

接口描述 ​

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

请求示例 url ​

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

请求方式 ​

GET

请求头 ​

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

请求参数 ​

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

例子 ​

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

返回 ​

json
响应json格式数据
{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "bbox": 87.3987592522049,
    "dataTime": "2020-05-10",
    "layerName": "JH_PRODUCT:ly_CHN-XU-WU******id-38",
    "regionCode": "CHN-XU-WUJ",
    "thumbnailUrl": "https://gw.datall.cn/productapi/jh-map/******-9a6902817111"
  }
}

作物分布时间轴 ​

接口描述 ​

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

请求示例 url ​

json
https://gw.datall.cn/productapi/jh-api/distRegionApi/queryTimeAxisBetweenDate

请求方式 ​

GET

请求头 ​

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

请求参数 ​

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

例子 ​

json
https://gw.datall.cn/productapi/jh-api/distRegionApi/queryTimeAxisBetweenDate?regionId=3104001644&cropId=107&startDate=2018-01-01&endDate=2021-05-01

返回 ​

json
响应json格式数据
{
  "flag": true,
  "code": null,
  "msg": null,
  "data": [
    "2019-12-21",
    "2020-12-21",
    "2021-02-19"
  ]
}

获取作物分布图例 ​

请求示例 url ​

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

请求方式 ​

GET

请求头 ​

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

例子 ​

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

返回 ​

json

{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "id": "01",
    "name": "分布模板",
    "unit": "无",
    "levelDataVos": [
      {
        "id": 98,
        "levelName": "春玉米",
        "maxValue": 0.1,
        "minValue": 0,
        "colorCode": "#005BFF",
        "colorName": null
      }
    ]
  }
}

当前区域作物分布统计 ​

接口描述 ​

根据作物id、日期、区域id条件, 获取当前区域作物分布统计数据。

请求示例 url ​

json
https://gw.datall.cn/productapi/jh-api/distRegionApi/queryRealtimeData

请求方式 ​

POST

请求头 ​

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

请求参数 ​

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

例子 ​

json
{
  "regionId": "3104001644",
  "cropId": "107",
  "dataTime": "2021-03-15"
}

返回 ​

json

{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "regionId": 3104001644,
    "dataTime": "2021-03-15",
    "regionChinaName": "邹平市",
    "cropId": 107,
    "cropName": "冬小麦",
    "areaNum": 4173.13,
    "tenThousandAreaNum": 0.4
  }
}

下级区域作物分布统计 ​

接口描述 ​

根据作物id、日期、区域id条件, 获取下级区域作物分布统计数据。

请求示例 url ​

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

请求方式 ​

POST

请求头 ​

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

请求参数 ​

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

例子 ​

json
{
  "regionId": "3104001644",
  "cropId": "107",
  "dataTime": "2021-03-15"
}

返回 ​

json

{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "regionId": 3105020734,
    "dataTime": "2021-03-15",
    "regionChinaName": "焦桥镇",
    "cropId": 107,
    "cropName": "冬小麦",
    "areaNum": 4173.13,
    "tenThousandAreaNum": 0.4
  }
}

下级区域近3年的作物面积统计 ​

接口描述 ​

根据区域id、作物id、日期条件, 获取下级区域近3年的作物面积统计。

请求示例 url ​

json
https://gw.datall.cn/productapi/jh-api/distRegionApi/queryNextRegionLast3Years

请求方式 ​

GET

请求头 ​

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

请求参数 ​

属性说明例如是否必填
regionId区域id3105020734必填
cropId作物id107必填
dataTime日期2021-03-15必填

例子 ​

json
https://gw.datall.cn/productapi/jh-api/distRegionApi/queryNextRegionLast3Years?regionId=3105020734&cropId=107&dataTime=2021-03-15

返回 ​

json

{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "2021": [
      {
        "regionId": 3105020734,
        "dataTime": "2021-03-15",
        "regionChinaName": "焦桥镇",
        "cropId": 107,
        "cropName": "冬小麦",
        "areaNum": 4173.13,
        "tenThousandAreaNum": 0.4
      }
    ]
  }
}

作物分布瓦片图层 ​

请求示例 url ​

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

请求方式 ​

GET

请求头 ​

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

请求参数 ​

属性说明例如是否必填
regionId区域id3102000019必填
cropId作物id122必填
dataTime日期2021-03-01必填
bbox瓦片范围112.5,28.828125,113.203125,29.53125必填
ServiceKey密钥f35a*************e5680b8必填
UserName用户名156****1376必填

例子 ​

json
https://gw.datall.cn/productapi/jh-api/distRegionApi/loadTileLayer?regionId=3102000019&cropId=122&dataTime=2021-03-01&bbox=112.5,28.828125,113.203125,29.53125

返回 ​

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

获取作物分布地块图片 ​

接口描述 ​

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

请求示例 url ​

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

请求方式 ​

GET

请求头 ​

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

请求参数 ​

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

例子 ​

json
https://gw.datall.cn/productapi/jh-api/distLandApi/loadLandImage/custom3103000364_202205120000000021531694/120/2021-10-15

返回 ​

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

获取作物分布地块统计信息 ​

接口描述 ​

根据地块编号、日期、作物id条件, 获取当前区域作物分布统计信息。

请求示例 url ​

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

请求方式 ​

GET

请求头 ​

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

请求参数 ​

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

例子 ​

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

返回 ​

json

{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "area_num": 299.0098
  }
}