区域农情监测api文档

Appearance

土壤湿度 ​

产品简介 ​

土壤湿度产品提供了自 2016 年以来的多年历史数据，包括每日逐三小时的土壤湿度信息。

技术原理 ​

基于星载卫星传感器，主动遥感通过发射微波并接收地面反射回来的信号来测量土壤湿度，被动遥感通过接收地球自然发射的微波信号来测量。两者结合使用可以提供更全面的土壤湿度信息。

分辨率 ​

覆盖范围更新频率数据源分辨率准确度
全球1 天9 千米

图层示例 ​

An image

接口 ​

获取土壤湿度缩略图时间轴 ​

接口描述 ​

根据区域 id、起始日期、终止日期条件, 获取土壤湿度缩略图时间轴

请求示例 url ​

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

请求方式 ​

GET

请求头 ​

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

请求参数 ​

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

示例 ​

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

返回 ​

json

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

获取土壤湿度图例 ​

请求示例 url ​

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

请求方式 ​

GET

请求头 ​

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

例子 ​

json

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

返回 ​

json

{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "id": "01",
    "name": "土壤湿度模板",
    "unit": "无",
    "levelDataVos": [
      {
        "id": 98,
        "levelName": 0.1,
        "maxValue": 0.1,
        "minValue": 0,
        "colorCode": "#8C510A",
        "colorName": null
      }
    ]
  }
}

当前区域指定日期土壤湿度数据 ​

接口描述 ​

根据区域 id、日期条件, 获取当前区域指定日期土壤湿度数据。

请求示例 url ​

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

请求方式 ​

GET

请求头 ​

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

请求参数 ​

属性说明例如是否必填
regionId区域 id3104001644必填
dataTime日期2021-11-01必填

示例 ​

json
https://gw.datall.cn/productapi/jh-api/soilmoistureRegionApi/queryRealtimeDataToday?regionId=3104001644&dataTime=2021-11-01

返回 ​

json


{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "regionId": 3104001644,
    "dataTime": "2021-11-01",
    "regionChinaName": "邹平市",
    "minValue": 0.44,
    "avgValue": 0.55,
    "maxValue": 0.64,
    "minValueText": "中度",
    "avgValueText": "轻度",
    "maxValueText": "无"
  }
}

当前区域指定时间段内土壤湿度数据 ​

接口描述 ​

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

请求示例 url ​

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

请求方式 ​

GET

请求头 ​

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

请求参数 ​

属性说明例如是否必填
regionId区域 id3104001644必填
startDate起始日期2021-02-05必填
endDate终止日期2021-11-01必填

示例 ​

json
https://gw.datall.cn/productapi/jh-api/soilmoistureRegionApi/queryRealtimeDataBetweenDate?regionId=3104001644&startDate=2021-02-05&endDate=2021-11-01

返回 ​

json


{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "regionId": 3104001644,
    "dataTime": "2021-11-01",
    "regionChinaName": "邹平市",
    "minValue": 0.44,
    "avgValue": 0.55,
    "maxValue": 0.64,
    "minValueText": "中度",
    "avgValueText": "轻度",
    "maxValueText": "无"
  }
}

当前区域前几期土壤湿度数据 ​

接口描述 ​

根据区域 id、日期、当前前 N 期条件, 获取当前区域前几期土壤湿度数据。

请求示例 url ​

json

https://gw.datall.cn/productapi/jh-api/soilmoistureRegionApi/queryRealtimeDataBeforeDays

请求方式 ​

GET

请求头 ​

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

请求参数 ​

属性说明例如是否必填
regionId区域 id3104001644必填
dataTime日期2021-11-01必填
beforeDay当前日期前 N 期，默认 55选填

示例 ​

json
https://gw.datall.cn/productapi/jh-api/soilmoistureRegionApi/queryRealtimeDataBeforeDays?regionId=3104001644&dataTime=2021-11-01&beforeDay=5

返回 ​

json

{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "regionId": 3104001644,
    "dataTime": "2021-11-01",
    "regionChinaName": "邹平市",
    "minValue": 0.44,
    "avgValue": 0.55,
    "maxValue": 0.64,
    "minValueText": "中度干旱",
    "avgValueText": "轻度干旱",
    "maxValueText": "无旱"
  }
}

当前区域前 N 年同比土壤湿度数据 ​

接口描述 ​

根据区域 id、日期、同比年份条件, 获取当前区域前 N 年同比土壤湿度数据。

请求示例 url ​

js
https://gw.datall.cn/productapi/jh-api/soilmoistureRegionApi/queryRealtimeLastYears

请求方式 ​

GET

请求头 ​

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

请求参数 ​

属性说明例如是否必填
regionId区域 id3104001644必填
dataTime日期2021-11-01必填
yearOnYearNum同比年份(默认 3)3选填

示例 ​

js
https://gw.datall.cn/productapi/jh-api/soilmoistureRegionApi/queryRealtimeLastYears?regionId=3104001644&dataTime=2021-11-01&yearOnYearNum=3

返回 ​

json
{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "2021-02-05": {
      "regionId": 3104001644,
      "dataTime": "2021-11-01",
      "regionChinaName": "邹平市",
      "minValue": 0.44,
      "avgValue": 0.55,
      "maxValue": 0.64,
      "minValueText": "中度干旱",
      "avgValueText": "轻度干旱",
      "maxValueText": "无旱"
    }
  }
}

下级区域指定日期土壤湿度数据 ​

接口描述 ​

根据区域 id、日期条件, 获取下级区域指定日期土壤湿度数据。

请求示例 url ​

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

请求方式 ​

GET

请求头 ​

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

请求参数 ​

属性说明例如是否必填
regionId区域 id3104003172必填
dataTime日期2021-10-10必填

示例 ​

json
https://gw.datall.cn/productapi/jh-api/soilmoistureRegionApi/queryRealtimeDataNextRegion?regionId=3104003172&dataTime=2021-10-10

返回 ​

json

{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "regionId": 3105025073,
    "dataTime": "2021-10-10",
    "regionChinaName": "兵团一零三团",
    "minValue": 0.44,
    "avgValue": 0.55,
    "maxValue": 0.64,
    "minValueText": "中度干旱",
    "avgValueText": "轻度干旱",
    "maxValueText": "无旱"
  }
}

下级区域前 N 年同比土壤湿度数据 ​

接口描述 ​

根据区域 id、日期、同比年份条件, 获取下级区域前 N 年同比土壤湿度数据。

请求示例 url ​

json

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

请求方式 ​

GET

请求头 ​

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

请求参数 ​

属性说明例如是否必填
regionId区域 id3104003172必填
dataTime日期2021-10-10必填
yearOnYearNum同比年份(默认 3)3选填

示例 ​

json
https://gw.datall.cn/productapi/jh-api/soilmoistureRegionApi/queryNextRegionLastYears?regionId=3104003172&dataTime=2021-10-10&yearOnYearNum=3

返回 ​

json

{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "2021": [
      {
        "regionId": 3105025073,
        "dataTime": "2021-10-10",
        "regionChinaName": "兵团一零三团",
        "minValue": 0.44,
        "avgValue": 0.55,
        "maxValue": 0.64,
        "minValueText": "中度干旱",
        "avgValueText": "轻度干旱",
        "maxValueText": "无旱"
      }
    ]
  }
}

土壤湿度瓦片图层 ​

请求示例 url ​

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

请求方式 ​

GET

请求头 ​

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

请求参数 ​

属性说明例如是否必填
regionId区域 id3104001644必填
dataTime日期2021-10-27必填
bbox瓦片范围112.5,33.75,123.75,45必填
ServiceKey密钥f35a*************e5680b8必填
UserName用户名156****1376必填

示例 ​

json
https://gw.datall.cn/productapi/jh-api/soilmoistureRegionApi/loadTileLayer?regionId=3104001644&dataTime=2021-10-27&bbox=112.5,33.75,123.75,45

返回 ​

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

获取土壤湿度地块图片 ​

接口描述 ​

根据地块编号、日期条件, 获取当前区域土壤湿度地块图片。

请求示例 url ​

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

请求方式 ​

GET

请求头 ​

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

请求参数 ​

属性说明例如是否必填
landNo地块编号custom3103000244_202111110000000002886946必填
dataTime日期2021-11-01必填

示例 ​

json
https://gw.datall.cn/productapi/jh-api/soilmoistureLandApi/loadLandImage/custom3103000244_202111110000000002886946/2021-11-01

返回 ​

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

获取土壤湿度地块统计信息 ​

接口描述 ​

根据地块编号、日期条件, 获取当前区域土壤湿度地块统计信息。

请求示例 url ​

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

请求方式 ​

GET

请求头 ​

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

请求参数 ​

属性说明例如是否必填
landNo地块编号custom3103000244_202111110000000002886946必填
dataTimeStr日期2021-11-01必填

示例 ​

json
https://gw.datall.cn/productapi/jh-api/soilmoistureLandApi/statisticsLandData?landNo=custom3103000244_202111110000000002886946&dataTimeStr=2021-01-10

返回 ​

json

{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "MAX": 0.9,
    "MEAN": 0.5,
    "MIN": 0.1
  }
}