区域农情监测api文档

Appearance

气温 ​

产品简介 ​

气温数据分为历史、实时和预报三类。历史温度数据可追溯至 2016 年，实时预报数据可提供每小时气温，预报数据包括未来 16 天的日平均温度和未来 5 天逐三小时气温。

技术原理 ​

购买的数据。

分辨率 ​

类型覆盖范围更新频率数据源分辨率准确度
历史中国、泰国、柬埔寨
全球		1 小时
1 天		3 千米
9 千米
实时中国、泰国、柬埔寨1 小时3 千米
预报中国、泰国、柬埔寨3 小时/1 天3 千米

图层示例 ​

An image

接口 ​

获取气温图例 ​

请求示例 url ​

json


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

请求方式 ​

GET

请求头 ​

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

例子 ​

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

返回 ​

json
{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "id": "01",
    "name": "气温模板",
    "unit": "无",
    "levelDataVos": [
      {
        "id": 98,
        "levelName": 35,
        "maxValue": 30,
        "minValue": 35,
        "colorCode": "#BEF4B0",
        "colorName": null
      }
    ]
  }
}

当前区域指定日期气温数据 ​

接口描述 ​

根据区域 id、日期条件, 获取当前区域指定日期气温数据。

请求示例 url ​

json

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

请求方式 ​

GET

请求头 ​

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

请求参数 ​

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

例子 ​

json
https://gw.datall.cn/productapi/jh-api/airtRegionApi/queryRealtimeDataToday?regionId=3105020740&dataTime=2021-10-01

返回 ​

json
{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "regionId": 3105020740,
    "dataTime": "2021-10-01",
    "regionChinaName": "台子镇",
    "minValue": 11,
    "maxValue": 3,
    "avgValue": 7,
    "maxValueText": "暖",
    "minValueText": "暖",
    "avgValueText": "暖"
  }
}

当前区域指定时间段气温数据 ​

接口描述 ​

根据区域 id、起始日期、终止日期条件, 获取当前区域指定时间段气温数据。

请求示例 url ​

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

请求方式 ​

GET

请求头 ​

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

例子 ​

json
https://gw.datall.cn/productapi/jh-api/airtRegionApi/queryRealtimeDataBetweenDate?regionId=3102000006&startDate=2021-01-15&endDate=2021-05-15

返回 ​

json
{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "regionId": 3105020740,
    "dataTime": "2021-10-01",
    "regionChinaName": "台子镇",
    "minValue": 11,
    "maxValue": 3,
    "avgValue": 7,
    "maxValueText": "暖",
    "minValueText": "暖",
    "avgValueText": "暖"
  }
}

当前区域历史前 N 天的气温数据 ​

接口描述 ​

根据区域 id、日期、历史前 N 天条件, 获取当前区域历史前 N 天的气温数据。

请求示例 url ​

json

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

请求方式 ​

GET

请求头 ​

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

例子 ​

json
https://gw.datall.cn/productapi/jh-api/airtRegionApi/queryRealtimeDataBeforeDays?regionId=3102000006&dataTime=2021-10-01&beforeDay=15

返回 ​

json
{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "regionId": 3102000006,
    "dataTime": "2021-10-01",
    "regionChinaName": "湖北省",
    "minValue": 11,
    "maxValue": 3,
    "avgValue": 7,
    "maxValueText": "暖",
    "minValueText": "暖",
    "avgValueText": "暖"
  }
}

当前区域前 N 年的同比气温数据 ​

接口描述 ​

根据区域 id、日期、同比年份条件, 获取当前区域前 N 年的同比气温数据。

请求示例 url ​

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

请求方式 ​

GET

请求头 ​

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

请求参数 ​

属性说明例如是否必填
regionId区域 id3102000006必填
dataTime日期2021-02-12必填
yearOnYearNum同比年份,默认前 3 年3选填

例子 ​

json
https://gw.datall.cn/productapi/jh-api/airtRegionApi/queryRealtimeLastYears?regionId=3102000006&dataTime=2021-02-12&yearOnYearNum=3

返回 ​

json
{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "2021-02-05": {
      "regionId": 3102000006,
      "dataTime": "2021-02-12",
      "regionChinaName": "湖北省",
      "minValue": 11,
      "maxValue": 3,
      "avgValue": 7,
      "maxValueText": "暖",
      "minValueText": "暖",
      "avgValueText": "暖"
    }
  }
}

气温瓦片图层 ​

请求示例 url ​

json



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

请求方式 ​

GET

请求头 ​

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

请求参数 ​

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

例子 ​

json

https://gw.datall.cn/productapi/jh-api/airtRegionApi/loadTileLayer?regionId=3104000957&dataTime=2021-10-28&bbox=112.5,22.5,123.75,33.75

返回 ​

an imgge

获取气温地块图片 ​

接口描述 ​

根据地块编号、日期条件, 获取当前区域气温地块图片。

请求示例 url ​

json

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

请求方式 ​

GET

请求头: ​

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

请求参数 ​

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

例子 ​

json
https://gw.datall.cn/productapi/jh-api/airtLandApi/loadLandImage/custom3103000244_202111110000000002886946/2021-02-19

返回 ​

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

获取气温地块统计信息 ​

接口描述 ​

根据地块编号、日期条件, 获取当前区域气温地块统计信息。

请求示例 url： ​

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

请求方式 ​

GET

请求头 ​

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

请求参数 ​

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

例子 ​

json
https://gw.datall.cn/productapi/jh-api/airtLandApi/statisticsLandData?landNo=custom3103000244_202111110000000002886946&dataTimeStr=2021-02-19

返回 ​

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