レスポンスに含まれる項目
確認したい項目
- 科学と自然
- Sunrise-Sunset の結果
- 公開ソース
Sunrise-Sunset
科学と自然 · Sunrise-Sunset の結果 · 公開ソース
現在の公開データ
Sunrise-Sunset から新しい結果を読み込みます。検索語の入力は不要です。
各時刻が示すもの
応答には sunrise、sunset、solar_noon、day_length と、3 種類の薄明の境界が入ります。sunrise と sunset は太陽の上端が地平線を横切る時刻、solar_noon はその日の太陽高度が最も高い時点です。day_length は秒なので、時間と分で表示する前に変換が必要です。
- solar_noon を時計の 12:00 と混同しないでください。
- day_length は時刻ではなく継続時間として読みます。
- 画面で結果の項目を使う前に status を確認してください。
返されるタイムゾーンと現地時刻
このページは formatted=0 を付けた /json ルートを使います。確認した応答は ISO 8601 の日付、status OK、tzid UTC を含み、時刻は +00:00 で終わります。地域の予定と比べる前に必要なタイムゾーンへ変換するか、そのタイムゾーン用に設定した情報源のリクエストを利用してください。都市名だけから現地時刻を推測しないでください。
- 元の応答を見せるときは時刻のそばに tzid を表示します。
- +00:00 はこの応答で使われる UTC オフセットを示します。
- 保存や比較では問い合わせ日を残してください。
薄明の種類は別々の問いに答える
civil_twilight は人工照明なしで屋外活動ができる程度の明るさがある期間、nautical_twilight は海上で地平線が見える期間、astronomical_twilight は空が完全に暗くなるまでの期間を示します。これらは座標と日付に基づく太陽計算であり、雲、実際の視界、交通、現地の安全を表すものではありません。
- 同じ薄明の begin と end を組にして使います。
- 太陽時刻で天気予報を代用しないでください。
- 屋外活動の前に地域の条件と規則を確認してください。