まぢぽん製作所

太陽位置(方位角・高度)計算API

【概要】

太陽の方位角・高度を計算するAPIです。
日本を基準としています。国外ではうまくいかないかもしれません
ブログにも説明を書きました。ここを見てください。
この場では軽く使い方の説明をします。
月バージョンもあります。  

【使い方】

[応答形式]
XML : https://mgpn.org/api/sun/position.cgi?
JSON : https://mgpn.org/api/sun/position.cgi?json&
JSONP : https://mgpn.org/api/sun/position.cgi?jsonp=caller&
 
[パラメータ]
y=年(2005年~2050年の間で指定してください)
m=月
d=日
h=時
min=分(省略可:省略時00分)
lat=北緯(必須)
lon=東経(必須)
 
[その他]
時間に関するパラメータ(年月日時分)を省略した場合、現在時刻で計算されます。
時刻は日本標準時(JST:UTC+9:00)で計算しています。
指定日の日の出、日の入りを表示します。計算結果は±1分の誤差を含んでいます。
 
[サンプル]
2000年5月5日12時00分 北緯35.6544 東経139.7447 JSON形式  

【使い方 v3】

[変更点]
一度のリクエストで連続した計算を行えるようにしました。
応答内容を変更しました。
・時刻のフォーマットを(2000-11-22T12:55:00+09:00)に変更
・altitude azimuthの型をstrからfloatに変更
[応答形式]
JSON : https://mgpn.org/api/sun/v3position.cgi
[パラメータ]
 time:計算で使用する日本標準時[yyyy-mm-ddTHH:MM](省略可)省略時はサーバーの現在時刻を使用。(2005年~2050年の間で指定してください)
 lat:北緯(必須)
 lon:東経(必須)
 loop:計算回数(省略可)省略時は1。0~370の間で指定
 interval:計算時間の間隔[分](loop省略時のみ省略可)timeで指定した時間を基準に、interval間隔でloop回数計算します。0~9999の間で指定可能。
 code:市区町村コード[5桁整数] 緯度経度の代わりに市区町村コードで現在地を指定できます。内部で市区町村コード変換APIを呼び出して処理をしています。詳細は該当APIのページを確認してください。
[その他]
 時刻は全て日本標準時(JST:UTC+9:00)です。
[サンプル]
 2000年5月5日12時00分 北緯35.6544 東経139.7447 JSON形式
 現在時刻から1分間隔で1時間先までの位置 北緯35.6544 東経139.7447 JSON形式  

【必読】

不具合があった場合、報告をお願い致します。
本サービスは予告なく変更、中断、終了する場合があります。
本サービスによる計算結果の精度は保証しません。
本サービスを重要なシステムに利用する事を禁止します。
本サービスを利用した事により損害や不利益が生じても管理者・製作者は一切責任を負いません。
本サービスが利用できなかった事により損害や不利益が生じても管理者・製作者は一切責任を負いません。
以上に同意の上、ご利用ください。  

【APIの利用について】

サーバーに過剰な負荷をかけないように注意してね。
詳細はAPIトップページを参照してください。  

【更新履歴】

2014/08/20 ΔT(TT-UT1)を2014年基準に変更しました(+3sec)。現在ΔTは固定値だが、今後指定年数によって自動で適切な値を選択するように変更するかも。
2014/12/17 J2000.0の求め方の誤りを修正(m=1,m=2の場合に正しくなかった)。
2014/12/17 黄経から赤経への変換式の誤りを修正。
2014/12/20 XMLのフォーマットを変更。黄経追加。
2016/12/29 日の出、日の入り時刻の計算を追加。XMLのフォーマットを変更しました。
2017/ 7/29 新ドメインへ転送開始。
2017/12/ 2 SSLに対応。APIにSSLで接続できます(気休めですが)。利用する場合は、https:(以下同じ)でアクセスしてくだい。
2018/04/21 利用制限を開始。大量のリクエストを継続的に行う方は事前に連絡をお願いします。
2020/11/23 ドメイン変更
2021/10/22 ΔTの値を固定値(2014年)から推定計算式へ変更しました。
2022/02/26 v3公開 2022/9/11 サーバOSアップデートに伴い、APIが使用できませんでした。現在は復旧しています。
2022/12/19 Ver3の仕様変更
 

【問い合わせ】

本サービスに関するお問い合わせはこちらからお願い致します。  

【参考書籍・関連サイト】

 

・長沢工 著 「日の出・日の入りの計算」 (地人書館)
   この書籍に基づいて作成しています。
 
日の出・日の入計算Finds.jp
   本サービスのフォーマットは、ここを参考に作成しました。
   日の出・日の入り・南中・薄明については、こちらが便利です。
 上記サービスは残念ながら終了してしまいました。