朝晚霞

访问限制

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

• 错误信息

请求

GET https://singer.caiyunhub.com/v3/glow/location

查询参数

参数	必填	默认值	取值范围	说明
longitude	是	—	—	经度
latitude	是	—	—	纬度
token	是	—	—	API 认证凭证，详见 认证与鉴权
image	否	true	true、false	是否返回图层 URL；false 时不返回图层相关字段

请求示例

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"

响应示例

默认返回（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
    }
  }
}

响应字段

根对象

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

BBox

JSONPath	类型	说明
$.bbox.lon	array<number>	经度范围，格式为 [最小经度, 最大经度]
$.bbox.lat	array<number>	纬度范围，格式为 [最小纬度, 最大纬度]

GlowInfo

以下路径以 evening 为例，morning 字段结构相同。

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

PredictDate

JSONPath	类型	说明
$.evening.predict_date.year	number	年份
$.evening.predict_date.month	number	月份
$.evening.predict_date.day	number	日期

数据覆盖范围

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

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

数据更新说明

数据时效性

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

更新频率

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

更新时间说明

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

备注

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