分钟级预报

访问限制

本部分 API 属于增值服务，仅提供给企业套餐开发者，如需采购请联系彩云商务

返回指定地点未来两小时的逐分钟降水预报。

更新频率与空间分辨率

分钟级降水数据为分钟滑动发布（发布周期约 5 分钟），时间分辨率为 1 分钟（从当前分钟起算），空间分辨率为 1 km 级，时间范围为未来两小时逐分钟。详情见 时空变量覆盖情况。

请求

GET https://api.caiyunapp.com/v2.6/{token}/{经度},{纬度}/minutely

路径参数

参数	说明
token	API 认证凭证，详见 认证与鉴权
经度	目标地点经度
纬度	目标地点纬度

注意：URL 路径中经度在前、纬度在后（如 101.6656,39.2072）；响应中的 location 字段为 [纬度, 经度] 顺序（如 [39.2072, 101.6656]）。

查询参数

参数	必填	默认值	取值范围	说明
lang	否	zh_CN	zh_CN、zh_TW、en_US、en_GB、ja、ug、bo	返回语言；未匹配时回落 zh_CN，详见 语言
unit	否	metric	metric、metric:v1、metric:v2、SI、imperial	单位制；其他取值报 422，详见 单位制
alert	否	false	true、false	alert=true 且 token 有预警权限时，响应附带 result.alert 块，详见 预警数据
callback	否	—	—	JSONP 包装

请求示例

curl "https://api.caiyunapp.com/v2.6/{token}/101.6656,39.2072/minutely"

{
  "status": "ok", // 返回状态
  "api_version": "v2.6", // API 版本
  "api_status": "active", // API 服务状态
  "lang": "zh_CN", // 返回语言
  "unit": "metric", // 单位
  "tzshift": 28800, // 时区偏移
  "timezone": "Asia/Shanghai", // 时区
  "server_time": 1640747476, // 服务器时间
  "location": [39.2072, 101.6656], // 请求经纬度，[纬度, 经度] 顺序
  "result": {
    "minutely": {
      "status": "ok", // 分钟级预报状态
      "datasource": "radar", // 数据源（雷达覆盖区为 radar）
      "precipitation_2h": [
        0,
        // ...
        0
      ], // 未来 2 小时逐分钟雷达降水强度（120 个值）
      "precipitation": [
        0,
        // ...
        0
      ], // 未来 1 小时逐分钟雷达降水强度（前 60 个值）
      "accumulation": [0, 0], // 未来 2 小时按小时累计降水量（2 个值）
      "probability": [0, 0, 0, 0], // 未来 [0-30, 30-60, 60-90, 90-120] 分钟的降水概率(0~1)
      "description": "未来两小时不会下雪，放心出门吧" // 未来 2 小时自然语言降水描述
    },
    "primary": 0, // 主要预报
    "forecast_keypoint": "未来两小时不会下雪，放心出门吧" // 预报关键点，与 minutely.description 内容一致
  }
}

响应字段

JSONPath	类型	说明
$.result.minutely.datasource	string	数据源，雷达覆盖区为 radar
$.result.minutely.precipitation_2h	array<number>	未来 2 小时逐分钟雷达降水强度，共 120 个值；unit=metric 时为雷达降水强度(0~1)，unit=metric:v2 时为 mm/h，详见 降水强度
$.result.minutely.precipitation	array<number>	未来 1 小时逐分钟雷达降水强度（precipitation_2h 的前 60 个值），单位同上
$.result.minutely.accumulation	array<number>	未来 2 小时按小时累计降水量，长度 2 的数组 [第1小时, 第2小时]；由 precipitation_2h 按前/后 60 分钟分别累计，并对极端大值做分段订正后封顶；metric / metric:v1 / metric:v2 / SI 为 mm，imperial 为 inch，详见 单位制
$.result.minutely.probability	array<number>	4 个值，分别对应未来 [0-30, 30-60, 60-90, 90-120] 分钟的降水概率(0~1)；条件出现
$.result.minutely.description	string	未来 2 小时自然语言降水描述；条件出现

JSONPath	类型	说明
$.result.forecast_keypoint	string	与 minutely.description 内容一致

description 与 forecast_keypoint

分钟级接口中，description 与 forecast_keypoint（位于 $.result.forecast_keypoint，result 级）内容一致，均为近 2 小时的降水/天气变化描述，适用于短时降水或天气说明。

accumulation 与逐分钟 / 小时降水不对齐

accumulation 与 precipitation / precipitation_2h、以及小时级降水不保持数值一致，不宜互相反推或校验相等。例如：metric / metric:v1 下逐分钟仍为雷达降水强度，而 accumulation 已内部转为 mm/h 再累计；accumulation 还会做分段订正并封顶；小时融合路径与分钟累计口径也不同。

备注

• token 无分钟级权限时，整个 minutely 块不返回。

错误

接口错误统一返回如下结构，HTTP 状态码与含义详见 错误信息。

{
  "status": "failed",
  "error": "token is invalid",
  "api_version": "2.6"
}