区域农情监测api文档

Appearance

成熟度 ​

产品简介 ​

成熟度用来评估作物生长末期的成熟情况，是判断作物能否进行收割的重要参数。该产品不仅为收割工作提供指导，还可为政府相关部门提供农机调配的信息，优化资源配置，提高农业生产效率。

技术原理 ​

作物成熟情况通常与温度的累积情况密切相关。通过计算有效积温，并根据不同区域和作物划定积温阈值，可以准确评估作物的成熟度。

分辨率 ​

覆盖范围更新频率数据源分辨率准确度
中国、泰国、柬埔寨1 天3 千米
全球1 天9 千米

图层示例 ​

An image

接口 ​

作物成熟度缩略图时间轴 ​

接口描述 ​

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

请求示例 url ​

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

请求方式 ​

GET

请求头 ​

属性说明例如是否必填
ServiceKey密钥f35a*************e5680b8必填
UserName用户名156****1376必填
请求参数 ​
属性说明例如是否必填
regionId区域 id3104001644必填
cropId作物 id102必填
startDate起始日期2021-01-01选填
endDate终止日期2022-05-01选填

例子 ​

json
https://gw.datall.cn/productapi/jh-api/ripenessRegionApi/queryTimeAxisInfoBetweenDate?regionId=3104000705&cropId=102&startDate=2021-01-01&endDate=2022-05-01

返回 ​

json

{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "bbox": "114.19197556,39.554768735,115.064021605,40.1974164850001",
    "dataTime": "2020-06-15",
    "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/ripenessRegionApi/queryTimeAxis

请求方式 ​

GET

请求头 ​

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

请求参数 ​

属性说明例如是否必填
regionId区域 id3104000705必填
cropId作物 id102必填
startDate起始日期2018-06-15选填
endDate终止日期2021-08-30选填

例子 ​

json
https://gw.datall.cn/productapi/jh-api/ripenessRegionApi/queryTimeAxis?regionId=3104000705&cropId=102&startDate=2018-06-15&endDate=2021-08-30

返回 ​

json

{
  "flag": true,
  "code": null,
  "msg": null,
  "data": [
    "2021-07-30",
    "2021-08-15",
    "2021-08-30"
  ]
}

获取作物成熟度图例 ​

请求示例 url ​

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

请求方式 ​

GET

请求头 ​

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

例子 ​

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

返回 ​

json

{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "id": "01",
    "name": "作物成熟度模板",
    "unit": "无",
    "levelDataVos": [
      {
        "id": 98,
        "levelName": 10,
        "maxValue": 0.1,
        "minValue": 0,
        "colorCode": "#ECFFEC",
        "colorName": null
      }
    ]
  }
}

当前区域指定日期成熟度数据 ​

接口描述 ​

根据区域 id、作物 id、日期条件, 获取当前区域指定日期成熟度数据。

请求示例 url ​

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

请求方式 ​

GET

请求头 ​

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

请求参数 ​

属性说明例如是否必填
regionId区域 id3105009692必填
cropId作物 id102必填
dataTime日期2021-08-30必填

例子 ​

json
https://gw.datall.cn/productapi/jh-api/ripenessRegionApi/queryRealtimeDataToday?regionId=3105009692&cropId=102&dataTime=2021-08-30

返回 ​

json

{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "regionId": 3105009692,
    "dataTime": "2021-08-30",
    "regionChinaName": "北水泉镇",
    "minValue": 0,
    "avgValue": 0.66,
    "maxValue": 0.67,
    "minValueText": "很差",
    "avgValueText": "好",
    "maxValueText": "好"
  }
}

当前区域指定时间段内成熟度数据 ​

接口描述 ​

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

请求示例 url ​

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

请求方式 ​

GET

请求头 ​

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

请求参数 ​

属性说明例如是否必填
regionId区域 id3104000705必填
cropId作物 id102必填
startDate起始日期2021-06-15必填
endDate终止日期2021-08-30必填

例子 ​

json
https://gw.datall.cn/productapi/jh-api/ripenessRegionApi/queryRealtimeDataBetweenDate?regionId=3104000705&cropId=102&startDate=2021-06-15&endDate=2021-08-30

返回 ​

json

{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "regionId": 3104000705,
    "dataTime": "2021-08-30",
    "regionChinaName": "蔚县",
    "minValue": 0,
    "avgValue": 0.66,
    "maxValue": 0.67,
    "minValueText": "很差",
    "avgValueText": "好",
    "maxValueText": "好"
  }
}

当前区域前几期成熟度数据 ​

接口描述 ​

根据区域 id、作物 id、日期、当前前 N 期条件, 获取当前区域前几期成熟度数据。

请求示例 url ​

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

请求方式 ​

GET

请求头 ​

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

请求参数 ​

属性说明例如是否必填
regionId区域 id3104000705必填
cropId作物 id102必填
dataTime日期2021-08-30必填
limitNum当前日期前 N 期，默认 55选填

例子 ​

json
https://gw.datall.cn/productapi/jh-api/ripenessRegionApi/queryRealtimeDataLimitNum?regionId=3104000705&cropId=102&dataTime=2021-08-30&limitNum=5

返回 ​

json

{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "regionId": 3104000705,
    "dataTime": "2021-08-30",
    "regionChinaName": "蔚县",
    "minValue": 0,
    "avgValue": 0.66,
    "maxValue": 0.67,
    "minValueText": "很差",
    "avgValueText": "好",
    "maxValueText": "好"
  }
}

当前区域前 N 年同比成熟度数据 ​

接口描述 ​

根据区域 id、作物 id、日期、同比年份条件, 获取当前区域前 N 年同比成熟度数据。

请求示例 url ​

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

请求方式 ​

GET

请求头 ​

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

请求参数 ​

属性说明例如是否必填
regionId区域 id3104000705必填
cropId作物 id102必填
dataTime日期2021-08-30必填
yearOnYearNum同比年份(默认 3)3选填

例子 ​

json
https://gw.datall.cn/productapi/jh-api/ripenessRegionApi/queryRealtimeLastYears?regionId=3104000705&cropId=102&dataTime=2021-08-30&yearOnYearNum=3

返回 ​

json

{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "regionId": 3104000705,
    "dataTime": "2021-08-30",
    "regionChinaName": "蔚县",
    "minValue": 0,
    "avgValue": 0.66,
    "maxValue": 0.67,
    "minValueText": "很差",
    "avgValueText": "好",
    "maxValueText": "好"
  }
}

下级区域指定日期成熟度数据 ​

接口描述 ​

根据区域 id、作物 id、日期条件, 获取下级区域指定日期成熟度数据。

请求示例 url ​

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

请求方式 ​

GET

请求头 ​

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

请求参数 ​

属性说明例如是否必填
regionId区域 id3104000705必填
cropId作物 id102必填
dataTime日期2021-08-30必填

例子 ​

json
https://gw.datall.cn/productapi/jh-api/ripenessRegionApi/queryRealtimeDataNextRegion?regionId=3104000705&cropId=102&dataTime=2021-08-30

返回 ​

json

{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "regionId": 3105009702,
    "dataTime": "2021-08-30",
    "regionChinaName": "暖泉镇",
    "minValue": 0,
    "avgValue": 0.66,
    "maxValue": 0.67,
    "minValueText": "很差",
    "avgValueText": "好",
    "maxValueText": "好"
  }
}

下级区域前 N 年同比成熟度数据 ​

接口描述 ​

根据区域 id、作物 id、日期、同比年份条件, 获取下级区域前 N 年同比成熟度数据。

请求示例 url ​

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

请求方式 ​

GET

请求头 ​

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

请求参数 ​

属性说明例如是否必填
regionId区域 id3104000705必填
cropId作物 id102必填
dataTime日期2021-08-30必填
yearOnYearNum同比年份(默认 3)3选填

例子 ​

json
https://gw.datall.cn/productapi/jh-api/ripenessRegionApi/queryNextRegionLastYears?regionId=3104000705&cropId=102&dataTime=2021-08-30&yearOnYearNum=3

返回 ​

json

{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "regionId": 3105009702,
    "dataTime": "2021-08-30",
    "regionChinaName": "暖泉镇",
    "minValue": 0,
    "avgValue": 0.66,
    "maxValue": 0.67,
    "minValueText": "很差",
    "avgValueText": "好",
    "maxValueText": "好"
  }
}

作物成熟度瓦片图层 ​

请求示例 url ​

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

请求方式 ​

GET

请求头 ​

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

请求参数 ​

属性说明例如是否必填
regionId区域 id3104001644必填
cropId作物 id107必填
dataTime日期2022-05-10必填
bbox瓦片范围117.421875,36.9580078125,117.4658203125,37.001953125必填
ServiceKey密钥f35a*************e5680b8必填
UserName用户名156****1376必填

例子 ​

json
https://gw.datall.cn/productapi/jh-api/ripenessRegionApi/loadTileLayer?regionId=3104001644&cropId=107&dataTime=2022-05-10&bbox=117.421875,36.9580078125,117.4658203125,37.001953125

返回 ​

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