区域农情监测api文档

Appearance

作物生物量 ​

产品简介 ​

作物生物量评估了作物在生长过程中物质累积状况。生物量的累积情况与作物的生长状态和最终产量密切相关。通过监测生物量，可以及时获得作物产量的趋势信息，为农业管理者提供预警，帮助他们及早发现潜在问题并进行干预。

技术原理 ​

基于温度、湿度、太阳辐射等气象因子和红波段（R）、近红外波段（NIR）等遥感数据，构建针对不同作物的模型，以获取作物生物量信息。

分辨率 ​

覆盖范围更新频率数据源分辨率准确度
全球10 天10 米
全球16 天30 米
全球8 天500 米

接口 ​

根据区域 id、作物 id、指定日期条件, 查询数据集的数据时间列表 ​

接口描述 ​

根据区域 id、作物 id、指定日期条件, 查询数据集的数据时间列表

请求示例 url ​

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

请求方式 ​

GET

请求头 ​

属性说明例如是否必填
ServiceKey密钥f35a*************e5680b8必填
UserName用户名156****1376必填
请求参数 ​
属性说明例如是否必填
regionId区域 id71041722569079必填
dataTime指定日期2024-10-08必填
cropId作物 id102必填

例子 ​

json
https://gw.datall.cn/productapi/jh-api/cropBiomassRegionApi/queryRealtimeDataLimitNum?regionId=71041722569079&dataTime=2024-10-08&cropId=102

返回 ​

json

{
    "flag": true,
    "code": null,
    "msg": null,
    "data": [
        {
            "regionId": 71041722569079,
            "maxValue": 1.39,
            "maxValueText": null,
            "maxSumValue": null,
            "maxAreaNum": 0,
            "max": 0,
            "minValue": 0,
            "minValueText": null,
            "minSumValue": null,
            "minAreaNum": 0,
            "min": 0,
            "avgValue": 0.34,
            "avgValueText": null,
            "avgSumValue": null,
            "avgAreaNum": 0,
            "avg": 0,
            "dataTime": "2024-10-08",
            "preMonthAvg": null,
            "preMonthAvgTxt": "--",
            "growthRate": null,
            "growthRateTxt": "--",
            "landId": null,
            "regionChinaName": "肃州区",
            "regionEnglishName": "suzhouqu",
            "totalOutput": null,
            "avg5yearNum": 0,
            "atYearMonth": null,
            "monthMeanInfoVo": null,
            "m": null,
            "m2": null
        },
        {
            "regionId": 71041722569079,
            "maxValue": 1.26,
            "maxValueText": null,
            "maxSumValue": null,
            "maxAreaNum": 0,
            "max": 0,
            "minValue": 0,
            "minValueText": null,
            "minSumValue": null,
            "minAreaNum": 0,
            "min": 0,
            "avgValue": 0.37,
            "avgValueText": null,
            "avgSumValue": null,
            "avgAreaNum": 0,
            "avg": 0,
            "dataTime": "2024-10-07",
            "preMonthAvg": null,
            "preMonthAvgTxt": "--",
            "growthRate": null,
            "growthRateTxt": "--",
            "landId": null,
            "regionChinaName": "肃州区",
            "regionEnglishName": "suzhouqu",
            "totalOutput": null,
            "avg5yearNum": 0,
            "atYearMonth": null,
            "monthMeanInfoVo": null,
            "m": null,
            "m2": null
        }
    ]
}

根据下属区域 id、作物 id、指定日期条件, 查询数据集的数据时间列表 ​

接口描述 ​

根据下属区域 id、作物 id、指定日期条件, 查询数据集的数据时间列表。

请求示例 url ​

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

请求方式 ​

GET

请求头 ​

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

请求参数 ​

属性说明例如是否必填
regionId区域 id71041722569079必填
dataTime指定日期2024-10-08必填
cropId作物 id102必填

例子 ​

json
https://gw.datall.cn/productapi/jh-api/growRegionApi/queryRealtimeDataNextRegion?regionId=71041722569079&dataTime=2024-10-08&cropId=102

返回 ​

json

{
  "flag": true,
  "code": null,
  "msg": null,
  "data": [
    {
      "regionId": 71051729772096,
      "datatime": "2024-10-08",
      "cropId": 102,
      "regionChinaName": "沙山村六队王光军22",
      "regionEnglishName": "HD-1826083872052383745-0001",
      "cropName": "夏玉米",
      "levelDataVos": [
        {
          "regionId": null,
          "levelId": 12,
          "areaNum": 2.31,
          "numberOfPlants": null,
          "levelName": "很差",
          "sortNo": 1,
          "cropId": null,
          "cropName": null,
          "dataTime": null,
          "colorCode": "#E8AF64",
          "tenThousandAreaNum": 0.000231
        },
        {
          "regionId": null,
          "levelId": 18,
          "areaNum": 9.42,
          "numberOfPlants": null,
          "levelName": "差",
          "sortNo": 2,
          "cropId": null,
          "cropName": null,
          "dataTime": null,
          "colorCode": "#D1B54D",
          "tenThousandAreaNum": 0.000942
        },
        {
          "regionId": null,
          "levelId": 13,
          "areaNum": 0.96,
          "numberOfPlants": null,
          "levelName": "较差",
          "sortNo": 3,
          "cropId": null,
          "cropName": null,
          "dataTime": null,
          "colorCode": "#B6BA36",
          "tenThousandAreaNum": 0.000096
        },
        {
          "regionId": null,
          "levelId": 14,
          "areaNum": 0,
          "numberOfPlants": null,
          "levelName": "中等",
          "sortNo": 4,
          "cropId": null,
          "cropName": null,
          "dataTime": null,
          "colorCode": "#83A624",
          "tenThousandAreaNum": 0
        },
        {
          "regionId": null,
          "levelId": 15,
          "areaNum": 0,
          "numberOfPlants": null,
          "levelName": "较好",
          "sortNo": 5,
          "cropId": null,
          "cropName": null,
          "dataTime": null,
          "colorCode": "#508F15",
          "tenThousandAreaNum": 0
        },
        {
          "regionId": null,
          "levelId": 16,
          "areaNum": 0,
          "numberOfPlants": null,
          "levelName": "好",
          "sortNo": 6,
          "cropId": null,
          "cropName": null,
          "dataTime": null,
          "colorCode": "#267A0A",
          "tenThousandAreaNum": 0
        },
        {
          "regionId": null,
          "levelId": 17,
          "areaNum": 0,
          "numberOfPlants": null,
          "levelName": "很好",
          "sortNo": 7,
          "cropId": null,
          "cropName": null,
          "dataTime": null,
          "colorCode": "#006600",
          "tenThousandAreaNum": 0
        }
      ],
      "meanOfLevelVos": null,
      "cropStatistics": null,
      "areaNum": 12.69,
      "numberOfPlants": 0,
      "title": null,
      "option": null,
      "landId": null,
      "levelId": null,
      "tenThousandAreaNum": 0.001269,
      "m": null
    }
  ]
}

根据作物id、区域id、起始日期、终止日期条件, 带缩略图的时间轴 ​

接口描述 ​

根据作物id、区域id、起始日期、终止日期条件, 带缩略图的时间轴。

请求示例 url ​

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

请求方式 ​

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/cropBiomassRegionApi/queryTimeAxisInfoBetweenDate?regionId=71041722569079&cropId=102&startDate=2023-01-01&endDate=2024-12-31

返回 ​

json

{
  "flag": true,
  "code": null,
  "msg": null,
  "data": [
    {
      "dataTime": "2024-04-20",
      "layerName": "JH_PRODUCT:ly_DST-1722568945-1722568986-1722569079_1731636501960_SummerCorn_20240420_S2_10M_ddtMeanExt8_tif_rankid-215",
      "regionId": null,
      "regionCode": "DST-1722568945-1722568986-1722569079",
      "dictCropId": null,
      "dictDatasetId": null,
      "regionMinMaxPoint": "99.2022054310179,39.34458405167545,99.25316410579593,39.398540448553625",
      "layerMinMaxPoint": "",
      "thumbnailUrl": "https://gw.datall.cn/productapi/jh-api/geoserverApi/getAnimateThumbnail?layerName=JH_PRODUCT:ly_DST-1722568945-1722568986-1722569079_1731636501960_SummerCorn_20240420_S2_10M_ddtMeanExt8_tif_rankid-215&regionCode=DST-1722568945-1722568986-1722569079&BBOX=99.2022054310179,39.34458405167545,99.25316410579593,39.398540448553625&ServiceKey=2478ad8beba9b2db7939a2e156d989d6&UserName=18986642665",
      "rankId": 215,
      "landId": null,
      "list": null,
      "bbox": ""
    }
  ]
}

根据数据集类型查询配置分级信息 ​

接口描述 ​

根据数据集类型查询配置分级信息。

请求示例 url ​

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

请求方式 ​

GET

请求头 ​

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

请求参数 ​

属性说明例如是否必填
datasetType数据集类型10308必填

例子 ​

json
https://gw.datall.cn/productapi/jh-api/cropBiomassRegionApi/queryConfigRank?datasetType=10308

返回 ​

json

{
  "flag": true,
  "code": null,
  "msg": null,
  "data": {
    "id": 215,
    "name": "耗水量分级模板",
    "unit": "mm/d",
    "isDefault": true,
    "dictDataset": 10308,
    "levelCacheVos": [
      {
        "id": 2398,
        "levelName": "1.00",
        "maxValue": 1,
        "minValue": 0,
        "sortNo": 1,
        "colorName": null,
        "colorCode": "#A5F38D",
        "pixelValue": 1,
        "remark": null,
        "colorExt": null,
        "colorList": [
          "#A5F38D"
        ],
        "cloud": false
      },
      {
        "id": 2399,
        "levelName": "2.00",
        "maxValue": 2,
        "minValue": 1,
        "sortNo": 2,
        "colorName": null,
        "colorCode": "#90DB5F",
        "pixelValue": 2,
        "remark": null,
        "colorExt": null,
        "colorList": [
          "#90DB5F"
        ],
        "cloud": false
      }
    ]
  }
}

根据区域id查询地块 ​

接口描述 ​

根据区域id查询地块。

请求示例 url ​

json
https://gw.datall.cn/productapi/jh-api/initLandApi/queryLandByRegionId

请求方式 ​

GET

请求头 ​

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

请求参数 ​

属性说明例如是否必填
regionId区域id1660787064360必填

例子 ​

json
https://gw.datall.cn/productapi/jh-api/initLandApi/queryLandByRegionId?regionId=1660787064360

返回 ​

json

{
  "flag": true,
  "code": null,
  "msg": "",
  "data": "JH_PRODUCT:ly_init_land_3103000105_sql"
}

图层示例 ​

An images