了解太阳数据
太阳看起来每天都会东升西落，但“一天从什么时候开始变亮”、“太阳什么时候最高”，以及“什么时候才算完全黑下来”需要用不同的太阳事件描述。
日出日落#
日出是太阳上边缘刚从地平线出现的时刻，而非整个日面离开地平线的时刻。日落则是太阳上边缘完全消失在地平线下的时刻。
大气折射会使地平线附近的太阳看起来比实际位置稍高，实际观测还会受海拔、地形、建筑、云雾和大气状况影响，所以 API 时间不等同于肉眼一定能看见太阳的时间。
对于高纬度地区，由于极昼和极夜，太阳可能在整个当地日期内都没有穿越地平线。此时 sunrise 和 sunset 可能为 null。在极昼或极夜的起止日期，也可能只有其中一个事件。例如在朗伊尔城，每年11月份至次年3月份处于极夜期，在此期间查询该城市的日出日落将可能返回空数值。
太阳正午和太阳子夜#
太阳正午是太阳经过观测者子午圈上方、当日高度最高的时刻，也称太阳上中天。
太阳子夜是太阳经过子午圈下方、当日高度最低的时刻，也称太阳下中天。
太阳正午和太阳子夜是由观测地点的经度和太阳的视运动决定的，两者大致相隔 12 小时，并且它们出现的时间并不是当地固定的 12:00 或 24:00。
曙暮光#
太阳位于地平线下时，其光线仍可通过大气散射照亮天空，这段明暗过渡称为曙暮光（也称为晨昏蒙影）。根据太阳几何中心低于地平线的角度，可分为三个阶段：
| 阶段 | 太阳中心高度角 | 一般观感 |
|---|---|---|
| 民用曙暮光 | 0° 至 -6° | 地平线和地面物体通常仍可分辨 |
| 航海曙暮光 | -6° 至 -12° | 地平线仍可分辨，较亮星体已经出现 |
| 天文曙暮光 | -12° 至 -18° | 天空已很暗，但仍有微弱的太阳散射光 |
正常情况下，太阳事件按以下顺序发生：
天文晨光 → 航海晨光 → 民用晨光 → 日出 → 太阳正午 → 日落 → 民用暮光 → 航海暮光 → 天文暮光
晨光字段表示对应晨光阶段的开始，暮光字段表示对应暮光阶段的结束。例如，早晨从 civilDawn 到 sunrise 是民用晨光，傍晚从 sunset 到 civilDusk 是民用暮光。
在高纬度地区，太阳可能不会穿越某个高度角，因此某一类或全部晨昏蒙影字段可能为 null。
曙暮光示意图。请注意，图中角度并非按比例绘制，仅为更清晰地展示曙暮光的类型。（改编自 Twilight description full day，TWCarlson，CC BY-SA 4.0）
