月位置(方位角･高度･月齢)計算API
【概要】
月の方位角・高度・月齢を計算するAPIです。
日本を基準としています。国外ではうまくいかないかもしれません
ブログにも説明を書きました。ここを見てください。
この場では軽く使い方の説明をします。
太陽の位置計算もあります→ここ
【使い方】
《Version1［非推奨］》
このバージョンは廃止予定です。ver2以降の利用を検討してください。
継続的なリクエストを行う場合は、このバージョンを利用しないでください。
[応答形式]
XML : https://mgpn.org/api/moon/position.cgi?
JSON : https://mgpn.org/api/moon/position.cgi?json&
JSONP : https://mgpn.org/api/moon/position.cgi?jsonp=caller&
[パラメータ]
y=年（2005年～2050年の間で指定してください）
m=月
d=日
h=時
min=分（省略可：省略時00分）
lat=北緯（必須）
lon=東経（必須）
[その他]
時間に関するパラメータ（年月日時分）を省略した場合、現在時刻で計算されます。
時刻は日本標準時（JST：UTC+9:00）で計算しています。
[サンプル]
2000年5月5日12時00分 北緯35.6544 東経139.7447 JSON形式
現在 北緯35.6544 東経139.7447 XML形式
《Version2》
一度のリクエストで連続した計算を行えるようにしました。
連続したデータを収集する場合は、１リクエストで複数の結果を取得するようにしてください。負荷軽減にご協力ください。
[応答形式]
JSON : https://mgpn.org/api/moon/v2position.cgi?
XML、JSONPでの応答はできません。
[パラメータ]
time：計算で使用する日本標準時[yyyy-mm-ddTHH:MM]（省略可）省略時はサーバーの現在時刻を使用。（2005年～2050年の間で指定してください）
lat：北緯（必須）
lon：東経（必須）
loop:計算回数（省略可）省略時は1。0～370の間で指定
interval：計算時間の間隔[分]（loop省略時のみ省略可）timeで指定した時間を基準に、interval間隔でloop回数計算します。0～9999の間で指定可能。
[その他]
時刻は全て日本標準時（JST：UTC+9:00）です。
応答内容はVersion1と同じです。
[サンプル]
2000年5月5日12時00分 北緯35.6544 東経139.7447 JSON形式
現在時刻から1分間隔で1時間先までの位置 北緯35.6544 東経139.7447 JSON形式
《Version3》
このバージョンは、予告なく仕様変更することがあります。
[応答形式]
JSON : https://mgpn.org/api/moon/v3position.cgi?
[パラメータ]
Version2から以下が追加になっています。
code：市区町村コード[5桁整数] 緯度経度の代わりに市区町村コードで現在地を指定できます。
内部で市区町村コード変換APIを呼び出して処理をしています。詳細は該当APIのページを確認してください。
[Version2からの変更点]
・応答内容の時刻の形式をyyyy-MM-ddTHH:mm:ss+09:00へ変更しました。
・応答内容の数値は小数点第3位までとしました（緯度、経度を除く）。
[サンプル]
現在時刻 東京都港区(市区町村コード：13103)
【免責】
不具合があった場合、報告をお願い致します。
本サービスは予告なく変更、中断、終了する場合があります。
本サービスによる計算結果の精度は保証しません。
本サービスを重要なシステムに利用する事を禁止します。
本サービスを利用した事により損害や不利益が生じても管理者・製作者は一切責任を負いません。
本サービスが利用できなかった事により損害や不利益が生じても管理者・製作者は一切責任を負いません。
以上に同意の上、ご利用ください。
【APIの利用について】
サーバーに過剰な負荷をかけないように注意してね。
特にスクリプトなどを実行する場合の意図しない大量アクセスに注意してください。
連続したデータを収集する場合、ver2以降を利用し、１リクエストで複数の結果を取得するようにしてください。
リクエストは次を超えないように調整してください。
短期間に連続したリクエスト：1回/秒
24時間連続したリクエスト：1回/分
他への影響が出る場合は、利用制限します。
特定のAPIで403エラーが発生している場合は制限対象になっています。解除が必要な場合はご連絡ください。
旧ドメインからアクセスしている方は修正をお願いします。旧ドメインからの転送はそのうちやめます。
【問い合わせ】
本サービスに関するお問い合わせはこちらからお願い致します。
【更新履歴】
2015/02/17 視差パラメータの誤りを修正(0.1度以下の誤差)。
2015/03/28 月齢計算の不備を修正（暫定的修正）。
2016/12/29 XMLのフォーマットを変更。
2017/ 7/29 新ドメインへ転送開始。
2017/12/ 2 SSLに対応。APIにSSLで接続できます（気休めですが）。利用する場合は、https:（以下同じ）でアクセスしてくだい。
2020/04/12 月齢計算の不備を修正（放置していた2015年の暫定修正を根本的に修正。もう問題ないはず）。（直近では2020/4/10 8:03～2020/4/18 10:11の月齢計算結果が正しくありませんでした）
2020/04/28 レスポンスの仕様変更。JSONPレスポンスを一時停止。
2020/04/29 ver2公開
2020/11/23 ドメイン変更
2021/10/22 ΔTの値を固定値（2014年）から推定計算値へ変更しました。
2022/02/26 ver3公開。ver1廃止予定。
2022/9/11 サーバOSアップデートに伴い、APIが使用できませんでした。現在は復旧しています。
2022/12/12 APIリクエスト回数について明文化しました。
2022/12/19 Ver3の仕様を変更しました。
【参考書籍・関連サイト】
・長沢工 著 「日の出・日の入りの計算」 (地人書館)
この書籍に基づいて作成しています。