朝晚霞

访问限制

本部分 API 属于增值服务，开发者 Token 需要额外开通权限，请联系商务

• 认证与鉴权 | 错误信息

curl "https://singer.caiyunhub.com/v3/glow/location?longitude=116&latitude=39&token={token}"

curl "https://singer.caiyunhub.com/v3/glow/location?longitude=116&latitude=39&token={token}&image=false"

请求参数

参数	类型	必填	说明
longitude	number	是	经度
latitude	number	是	纬度
token	string	是	认证令牌
image	boolean	否	是否返回图层 URL，默认为 true。设置为 false 时不返回图层相关字段

返回结构

默认返回（image=true 或不传）

{
  "bbox": {
    "lon": [72, 135],
    "lat": [17, 54]
  },
  "evening": {
    "probability": 22,
    "quality": 32,
    "start_time": 1766735488,
    "end_time": 1766747776,
    "probability_layer": "http://meteorology.caiyuncdn.com/dvf/prod/ljweather/image/2025/12/25/22/S_2025122522_20251226_PR.png?auth_key={auth_key}",
    "quality_layer": "http://meteorology.caiyuncdn.com/dvf/prod/ljweather/image/2025/12/25/22/S_2025122522_20251226_QU.png?auth_key={auth_key}",
    "publish_time": 1766700000,
    "predict_date": {
      "year": 2025,
      "month": 12,
      "day": 26
    }
  },
  "morning": {
    "probability": 0,
    "quality": 0,
    "start_time": 0,
    "end_time": 0,
    "probability_layer": "http://meteorology.caiyuncdn.com/dvf/prod/ljweather/image/2025/12/25/10/R_2025122510_20251226_PR.png?auth_key={auth_key}",
    "quality_layer": "http://meteorology.caiyuncdn.com/dvf/prod/ljweather/image/2025/12/25/10/R_2025122510_20251226_QU.png?auth_key={auth_key}",
    "publish_time": 1766656800,
    "predict_date": {
      "year": 2025,
      "month": 12,
      "day": 26
    }
  }
}

精简返回（image=false）

当设置 image=false 时，返回结果不包含 bbox、probability_layer 和 quality_layer 字段：

{
  "evening": {
    "probability": 22,
    "quality": 32,
    "start_time": 1766735488,
    "end_time": 1766747776,
    "publish_time": 1766700000,
    "predict_date": {
      "year": 2025,
      "month": 12,
      "day": 26
    }
  },
  "morning": {
    "probability": 0,
    "quality": 0,
    "start_time": 0,
    "end_time": 0,
    "publish_time": 1766656800,
    "predict_date": {
      "year": 2025,
      "month": 12,
      "day": 26
    }
  }
}

字段说明

根对象

字段	类型	说明
bbox	BBox	数据覆盖范围边界框（仅当 image=true 时返回）
evening	GlowInfo	晚霞信息
morning	GlowInfo	朝霞信息

BBox

字段	类型	说明
lon	number[]	经度范围，格式为 [最小经度, 最大经度]
lat	number[]	纬度范围，格式为 [最小纬度, 最大纬度]

GlowInfo

字段	类型	说明
probability	number	出现概率，取值范围 0-100
quality	number	质量评分，取值范围 0-100
start_time	number	开始时间戳（Unix 时间戳，秒）
end_time	number	结束时间戳（Unix 时间戳，秒）
probability_layer	string	概率图层 URL（仅当 image=true 时返回）
quality_layer	string	质量图层 URL（仅当 image=true 时返回）
publish_time	number	发布时间戳（Unix 时间戳，秒）
predict_date	PredictDate	预测日期（北京时间 UTC+8）

PredictDate

字段	类型	说明
year	number	年份
month	number	月份
day	number	日期

数据覆盖范围

本接口数据覆盖中国区域，地理坐标范围为：

• 经度范围：[72, 135]
• 纬度范围：[17, 54]

数据更新说明

数据时效性

朝晚霞数据仅提供最新批次数据，不提供历史数据查询。当数据尚未完成更新时，接口将返回上一批次的有效预报数据。

更新频率

• 晚霞：每日更新 3 次，预计更新时间为北京时间 02:00、08:00、14:00，提供当日晚霞预报数据。
• 朝霞：每日更新 2 次，预计更新时间为北京时间 14:00、19:00，提供次日朝霞预报数据。

更新时间说明

更新时间可能因系统维护或数据处理需要而有所调整，具体时间以实际更新为准。

备注

• probability_layer 和 quality_layer 为图层图片 URL，可用于可视化展示