日の出・日の入りAPI

47都道府県について、2000年から2100年までの毎日の日の出・南中・日の入り・南中高度・昼の長さと、月の出・月の南中・月の入りを返すAPIです。今日の日の出を画面に出す、1年の昼の長さをグラフにする、夜明け前の撮影の予定を立てる、といったことが手軽にできます。

できること

日ごとの 日の出・太陽の南中・日の入り・南中高度・昼の長さ・月の出・月の南中・月の入り（時刻は日本時間の時:分）

地点

47都道府県に1地点ずつ（都道府県庁のある市。国立天文台「各地のこよみ」と同じ地点・経緯度・標高0m）。地点の一覧

期間

2000年1月1日〜2100年12月31日（1地点の1年分を1つのファイルで返します）

費用・登録

無料・登録不要・APIキー不要（提供条件は利用状況で変わることがあります）

計算のもと

NASA JPL の天体暦 DE440s。定義は国立天文台 暦計算室と同じ。国立天文台「各地のこよみ」と23年分・47地点の毎日を照合し、99.98%が一致（違いは四捨五入の境目で1分・0.1°ずれるものだけ）

気をつけること

標高0m・地平線まで見通せる場所での時刻です。山や建物の陰、高い所からの見え方の違いは含みません。

データの版は /sun/v1/meta.json で確認できます。

はじめかた（3ステップ）

1. ブラウザで開いてみる: https://api.shirugear.com/sun/v1/13/2026.json を開くと、東京の2026年の365日分が返ります。13 は都道府県コード（東京都）、2026 は年です。
2. その日の1件を取り出す: days の中から date が目当ての日付（例: "2026-11-04"）のものを探します。使い方の例にそのまま使えるコードがあります。
3. 利用規約を確かめる: 利用規約をご確認ください。登録や申し込みは要りません。

いろいろな言語から呼ぶ

サーバー側のプログラムやコマンドからも、URLを開くだけで使えます。1地点の1年分（約66KB、通信は圧縮されて約9KB）を1回で受け取れるので、手元に保存して使い回すと効率的です。

const res = await fetch("https://api.shirugear.com/sun/v1/13/2026.json");
const data = await res.json();
const day = data.days.find((d) => d.date === "2026-06-21");
console.log(day.sunrise, day.sunset); // 04:25 19:00

curl -s https://api.shirugear.com/sun/v1/13/2026.json \
  | jq '.days[] | select(.date == "2026-06-21") | {sunrise, sunset, day_length}'

<?php
$data = json_decode(file_get_contents('https://api.shirugear.com/sun/v1/13/2026.json'), true);
foreach ($data['days'] as $day) {
    if ($day['date'] === '2026-06-21') {
        echo $day['sunrise'], ' ', $day['sunset'], "\n"; // 04:25 19:00
    }
}

import json
import urllib.request

url = "https://api.shirugear.com/sun/v1/13/2026.json"
with urllib.request.urlopen(url, timeout=10) as res:
    data = json.load(res)
day = next(d for d in data["days"] if d["date"] == "2026-06-21")
print(day["sunrise"], day["sunset"])  # 04:25 19:00

その場で試す

URLの一覧

どれも、URLを開く（GET）だけで JSON（UTF-8）が返ります。先頭は https://api.shirugear.com です。自分のサイトのJavaScriptから直接呼べます（CORS対応）。

• 都道府県コードは半角数字2桁です（01 北海道〜47 沖縄県。JIS X 0401 の順）。1 のような1桁や、都道府県名は使えません。
• 年は半角数字4桁の西暦で指定します（2026）。和暦や2桁の年は使えません。
• 1日分・1か月分だけを返すURLはありません。1年分のファイルを一度取り、その中から引いてください。
• 呼び出しは GET（または HEAD）だけです。独自のヘッダを付けずに呼んでください。

応答の例と各項目

応答の例

GET https://api.shirugear.com/sun/v1/13/2026.json

{
  "pref": "13",
  "pref_name": "東京都",
  "point": { "name": "東京", "lat": 35.6581, "lon": 139.7414, "elevation": 0 },
  "year": 2026,
  "days": [
    {
      "date": "2026-01-01",
      "sunrise": "06:51",
      "sun_transit": "11:44",
      "sunset": "16:38",
      "sun_altitude": 31.4,
      "day_length": "09:47",
      "moonrise": "14:04",
      "moon_transit": "21:47",
      "moonset": "04:21"
    },
    …
    {
      "date": "2026-01-03",
      "sunrise": "06:51",
      "sun_transit": "11:45",
      "sunset": "16:40",
      "sun_altitude": 31.5,
      "day_length": "09:49",
      "moonrise": "16:16",
      "moon_transit": null,
      "moonset": "06:42"
    },
    …
  ],
  "data_version": "2026-11-01"
}

2026年1月3日の東京は、月の南中が無い日です（1月2日の22時54分の次は、1月4日の0時00分）。そのため moon_transit が null になっています（日付またぎと null）。

年の項目

days の各項目（1日分）

時刻はすべて日本時間の "HH:MM"（24時間制・2桁ずつ。"00:00"〜"23:59"。月の時刻だけは "24:00" もあります。日付またぎと null）です。days は1月1日から順に並んでいるので、その年の何日目かが分かれば番号でも引けます（1月1日が days[0]）。

時刻の決め方（日付またぎ・null）

定義は、国立天文台 暦計算室の「各地のこよみ」と同じです。

日付またぎと null

• 時刻はどれも、その日（日本時間の0時から24時まで）の中の時刻です。前の日や次の日の時刻が入ることはありません。たとえば、夜に昇った月が翌朝に沈むとき、その月の入りは翌日の moonset に入ります。
• 月の出・月の南中・月の入りは、その日に無ければ null です。月はおよそ24時間50分で1回りするので、毎日およそ50分ずつ遅くなり、ほぼ1か月に1回、その日のうちに来ない日があります（例: 2026年1月10日の東京は月の出が無く、前の日の23時04分の次は1月11日の0時03分です）。null は「その日には起こらない」という意味で、データが欠けているわけではありません。
• 同じ日に月の出と月の入りの順番が入れ替わることもあります（月の入りが朝、月の出が夕方、など）。どちらが先かは時刻で比べてください。
• どの日の出来事かは、分に丸める前の時刻で決めています。そのため、23時59分30秒以降の月の出・月の南中・月の入りは、その日の "24:00" になります（次の日の "00:00" にはしません。国立天文台の表と同じ扱い）。"24:00" は「その日の終わり＝次の日の0時」と同じ時刻です。0時0分30秒より前の出来事は、その日の "00:00" です。
• 日の出・太陽の南中・日の入り・南中高度・昼の長さは、日本のどの地点でも毎日あります（null になりません）。

地点の一覧

国立天文台「各地のこよみ」と同じ地点・同じ経緯度です。都道府県庁のある市の代表の地点で、経緯度は1分（約1.5km）単位です（東京だけは、港区麻布台にある日本経緯度原点の値）。標高はどれも0mとして計算しています。/sun/v1/meta.json の points でも取れます。

正確さ（国立天文台との照合）

天文の計算には、NASA ジェット推進研究所（JPL）が公開している天体暦 DE440s を、Python の skyfield で使っています。地点ごとに、日・月の出入りと南中の瞬間を秒より細かく求めてから、分に四捨五入しています。

この結果を、国立天文台 暦計算室が公表している「各地のこよみ」の2005年から2027年までの23年分・47地点・毎日と、1件ずつ照らし合わせました（月の出入りが無い日は、無いことが一致するかも比べています）。

• 食い違い630件は、どれも1分（南中高度は0.1°）の違いです。こちらの秒までの値が「◯分30秒」のごく近く（秒まで出した2005年・2026年分では、どれも前後0.06秒以内。南中高度は0.05°の境目から0.00001°以内）にあり、四捨五入の向きが計算のわずかな違いで分かれたものです。月の出入りが「ある・無い」の食い違いはありません。
• 月の出・月の南中・月の入りが無い日（null）と、"24:00" になる日も、国立天文台の表と同じです。
• 国立天文台の表に合わせて、太陽の視半径は1天文単位のとき 16'01.18" とし、時計の時刻（UTC）と地球の自転による時刻（UT1）の差（1秒未満）は無視しています。
• 遠い将来の値について: 地球の自転はわずかにゆらいでおり（ΔT）、将来の分は予測を含みます。うるう秒の扱いが変わる見込みもあり、2050年以降は時刻が数秒から数十秒ずれている可能性があります。そのため、遠い将来ほど1分ずれる日が増えることがあります。

使い方の例

どの例も、ブラウザの JavaScript（フレームワーク不要）で動きます。年のファイルは一度取ったら覚えておき、同じ地点・同じ年では呼び直しません。

今日の日の出・日の入りを出す

const API = "https://api.shirugear.com/sun/v1/";
const files = new Map(); // 地点・年のファイルは一度だけ取り、使い回す

function loadYear(pref, year) {
  const key = pref + "/" + year;
  if (!files.has(key)) {
    const p = fetch(API + key + ".json").then((res) => {
      if (!res.ok) throw new Error("HTTP " + res.status);
      return res.json();
    });
    p.catch(() => files.delete(key)); // 失敗したら次は取り直す
    files.set(key, p);
  }
  return files.get(key);
}

// 日本時間の今日（"YYYY-MM-DD"）
const today = new Intl.DateTimeFormat("sv-SE", { timeZone: "Asia/Tokyo" }).format(new Date());

const data = await loadYear("13", Number(today.slice(0, 4)));
const day = data.days.find((d) => d.date === today);
console.log("日の出 " + day.sunrise + " ／ 日の入り " + day.sunset);

月の出が無い日を考えて表示する

月の出・月の南中・月の入りは null のことがあります。そのまま画面に出すと「null」と表示されるので、言葉に置きかえます。

function moonText(day) {
  const t = (v) => (v === null ? "なし" : v);
  return "月の出 " + t(day.moonrise) + " ／ 月の入り " + t(day.moonset);
}
// 2026年1月10日の東京 → "月の出 なし ／ 月の入り 10:43"

1年の昼の長さを分にする

day_length は "HH:MM" の文字列です。グラフにするときは分に直します。上の loadYear を使います。

const data = await loadYear("01", 2026); // 札幌
const minutes = data.days.map((d) => {
  const [h, m] = d.day_length.split(":").map(Number);
  return h * 60 + m;
});
console.log(Math.max(...minutes), Math.min(...minutes)); // 923 540（夏至のころと冬至のころ）

値は textContent で画面に入れてください（HTML として解釈させない）。取れなかったときに画面が止まらないよう、fetch の失敗も受け止めておくと安心です。

エラー

うまくいかないときは、HTTPの状態コードと、次の形の JSON を返します。code は固定の値なので、プログラムで見分けるときはこれを使ってください（message は説明文で、言い回しが変わることがあります）。

{"error":{"status":404,"code":"not_in_range","message":"この都道府県・年のデータはありません。都道府県コードは01（北海道）〜47（沖縄県）、年は2000年から2100年までで指定してください。"}}

通信できない・サーバーが止まっているときは、JSON が返らないことがあります。fetch の失敗（例外）も受け止めて、日の出の表示なしでも画面が使えるようにしてください。

データの更新・キャッシュ・呼び出し回数

• 作り方: 日・月の出入りは前もって計算して、地点・年ごとのファイルにしてあります。秒までの計算結果を分に丸めた表をシルギアの手元で作って保管し、サーバーが毎日の確認（4:50 日本時間ごろ）でそこから組み立て直します。
• 中身が変わるとき: 表を作り直したとき（計算の誤りの修正・地球の自転の予測の更新など）だけです。それ以外は、何度組み立てても同じ値になります。
• データの版（data_version）: 元データが変わった日付です（例: "2026-11-01"）。祝日・営業日API・暦APIと共通の版なので、祝日のデータが更新されたときは、日の出入りの中身が同じでも版の日付が進みます。/sun/v1/meta.json には、作った日時（built_at・UTC）・期間・計算のもと・定義・地点の一覧も入っています。
• キャッシュ: 応答は1日（エラーは1時間）キャッシュしてかまいません。中身はめったに変わらないので、アプリの中に年のファイルを長く持っておいてもかまいません。ETag／Last-Modified に対応しているので、変わっていなければ 304 が返ります。
• 呼び出し回数の目安: 決まった上限はありませんが、1つの利用元から1秒あたり10回程度までにしてください。年のファイルは使い回して、日付ごと・画面を開くごとに同じ地点・同じ年を取り直さないでください。
• 全部をまとめて使いたいとき: 47地点×101年（4,747ファイル）を一度に取るような使い方は控え、必要な地点・年だけを取ってください。

変更の方針と更新履歴

• v1 の中では、項目を足すことはあっても、今ある項目の名前や意味は変えません。知らない項目が増えていても無視するように作ってください。
• 計算の誤りを直したときは、同じ v1 のまま値を直します。そのときはこのページの更新履歴でお知らせします。
• 互換性のない変更は、URLの版を分けて（/sun/v2/ など）行います。v1 を終わらせるときは、できるかぎり6か月以上前にこのページでお知らせします。
• 提供条件（無料・登録不要・アクセス回数の上限など）は、利用状況に応じて変えることがあります（利用規約第4条）。

更新履歴

2026年11月4日

公開。

機械で読める仕様（型定義・OpenAPI）

• TypeScript の型定義: /sun/types.d.ts
• OpenAPI 3.1: /sun/openapi.json（コード生成やテストに使えます）

用語の説明

よくある質問

ご利用にあたって

ご利用の前に利用規約をご確認ください。データの正確さや、止まらないことは保証していません。登山・航海・撮影など、時刻が安全にかかわる使い方では、山や建物の陰・標高・天気で実際の見え方が変わることに気をつけ、余裕を持った計画にしてください。公式の値を確かめたいときは、国立天文台 暦計算室の「各地のこよみ」をご覧ください。ご質問・不具合のご連絡は、シルギアのお問い合わせ窓口から、件名に「API」と入れてお送りください。