区域农情监测api文档

Appearance

霜冻预警 ​

产品简介 ​

霜冻预警产品旨在提前预警可能发生的霜冻事件。霜冻对经济作物、果树、蔬菜等的生长和产量影响较大。该产品帮助为果农提供精准的霜冻预警信息，帮助确定收获时间，防止霜冻对果实品质的影响。同时，帮助政府和应急管理部门提前了解霜冻的潜在风险，及时部署应急响应资源，保障公众安全。

技术原理 ​

根据中国气象局发布的霜冻预警信号标准进行划分。

分辨率 ​

覆盖范围更新频率数据源分辨率准确度
中国、泰国、柬埔寨3 小时3 千米

接口 ​

获取霜冻预警缩略图时间轴 ​

接口描述 ​

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

请求示例 url ​

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

请求方式 ​

GET

请求头 ​

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

请求参数 ​

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

示例 ​

json
https://gw.datall.cn/productapi/jh-api/frostWaveWarningRegionApi/queryTimeAxisInfoBetweenDate?regionId=3103000052&cropId=0&startDate=2022-01-01&endDate=2024-01-01

返回 ​

json

{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "bbox": 87.3987592522049,
    "dataTime": "2022-08-30",
    "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/frostWaveWarningRegionApi/queryConfigRank

请求方式 ​

GET

请求头 ​

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

例子 ​

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

返回 ​

json

{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "id": "01",
    "name": "霜冻预警分级模板",
    "unit": "℃",
    "levelDataVos": [
      {
        "id": 1050,
        "levelName": "红色预警",
        "maxValue": 1,
        "minValue": 1,
        "colorCode": "#C82737",
        "colorName": null
      }
    ]
  }
}

当前区域指定日期霜冻预警数据 ​

接口描述 ​

根据作物id、日期、区域id条件, 获取当前区域指定日期霜冻预警数据

请求示例 url ​

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

请求方式 ​

GET

请求头 ​

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

请求参数 ​

属性说明例如是否必填
regionId区域id3103000052必填
cropId作物id0必填
dataTime日期2022-08-30必填

示例 ​

json
https://gw.datall.cn/productapi/jh-api/frostWaveWarningRegionApi/queryRealtimeDataToday?regionId=3103000052&cropId=0&dataTime=2022-08-30

返回 ​

json

{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "regionId": 3103000052,
    "dataTime": "2022-08-30",
    "regionChinaName": "梅州市",
    "cropId": 0,
    "cropName": "null",
    "levelDataVos": [
      {
        "levelId": 1,
        "levelName": "红色预警",
        "areaNum": 0,
        "tenThousandAreaNum": 0
      }
    ]
  }
}

下级区域指定日期霜冻预警数据 ​

接口描述 ​

根据作物id、日期、区域id条件, 获取下级区域指定日期霜冻预警数据

请求示例 url ​

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

请求方式 ​

GET

请求头 ​

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

请求参数 ​

属性说明例如是否必填
regionId区域id3103000052必填
cropId作物id0必填
dataTime日期2022-08-30必填

示例 ​

json
https://gw.datall.cn/productapi/jh-api/frostWaveWarningRegionApi/queryRealtimeDataNextRegion?regionId=3103000052&cropId=0&dataTime=2022-08-30

返回 ​

json
{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "regionId": 3104000311,
    "dataTime": "2022-08-30",
    "regionChinaName": "大埔县",
    "cropId": 0,
    "cropName": "null",
    "levelDataVos": [
      {
        "levelId": 1,
        "levelName": "红色预警",
        "areaNum": 0,
        "tenThousandAreaNum": 0
      }
    ]
  }
}

获取霜冻预警瓦片图层 ​

请求示例 url ​

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

请求方式 ​

GET

请求头 ​

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

请求参数 ​

属性说明例如是否必填
regionId区域id3103000052必填
cropId作物id0必填
dataTime日期2022-08-30必填
bbox瓦片范围115.83984375000001,24.257812499999993,116.01562499999999,24.43359375必填
ServiceKey密钥f35a*************e5680b8必填
UserName用户名156****1376必填

示例 ​

json
https://gw.datall.cn/productapi/jh-api/frostWaveWarningRegionApi/loadTileLayer?regionId=3103000052&cropId=0&dataTime=2022-08-30&bbox=115.83984375000001,24.257812499999993,116.01562499999999,24.43359375

返回 ​

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