Sunset Predictor

Score any sunset 0–100, anywhere on Earth, up to 5 days ahead.

原始信息汇总

数据集概述：Sunset Predictor API

核心功能：提供全球任意地点未来5天内的日落观赏质量评分（0-100分），基于实时气象和大气数据计算，而非简单预测。

评分依据：综合以下实时数据计算得分：

• 云层覆盖（低/中/高云）
• 湿度与露点
• 能见度与气溶胶光学厚度（雾霾）
• 空气质量指数（AQI）
• 风速与风向
• 降水概率

关键特性：

• 单次调用：无需组合天气和天文学API，一次请求即得结果。
• 全球覆盖：支持通过经纬度或城市名称查询，内置地理编码。
• 多语言支持：附带14种语言的人类可读解释（en, ru, fr, ro, uk, de, es, it, ar, ja, he, zh-CN, pt, hi）。
• 返回信息：包含日落/日出时间、时区、置信度（高/中/低）以及原始气象因子。

适用场景：

• 摄影应用
• 旅游规划工具
• 智能家居仪表盘
• 天气聚合应用

API 端点：

方法	路径	描述
GET	/api/v1/predict	主要端点，获取指定地点和日期的日落质量评分
GET	/api/v1/cities	按名称搜索城市，返回坐标
GET	/api/v1/cities/reverse	根据坐标查询城市名称
GET	/ping	健康检查

主要请求参数（/predict）：

• lat+lon 或 city：指定位置（二选一）
• date（可选）：目标日期，格式YYYY-MM-DD，范围：昨天至+5天，默认今天
• lang（可选）：解释字段的语言，默认英语

响应关键字段：

字段	类型	说明
score	整数 (0-100)	日落质量评分，越高越绚丽
label	字符串	质量标签：Low / Moderate / High / Very High
explanation	字符串	本地化的散文解释
confidence	字符串	置信度：high / medium / low
sunsetTime	ISO 8601	日落时间（评分针对此时间）
sunriseTime	ISO 8601	日出时间（仅为参考）
rawFactors	对象	原始气象输入数据（始终为公制单位）

评分等级：

• 90-100：Very High（绚丽色彩，值得设置提醒）
• 70-89：High（可能拥有好色彩）
• 40-69：Moderate（有些色彩，但不惊艳）
• 0-39：Low（天空平淡或偏白）

错误码：使用JSON格式返回错误，包含error和code字段，常见错误如无效位置、无效日期、城市未找到、速率限制等。

定价与认证：

• 通过RapidAPI处理认证和配额，无需管理独立API密钥。
• 提供多个订阅计划：BASIC（免费）、PRO（$9.99/月）、ULTRA（$29.99/月）。