ForHosting KIT · 開発者向けツール

恒星時と赤経から時角を計算

この計算機は、地方恒星時と天体の赤経から地方時角を求めます。両方の座標を0以上24未満の十進時で入力してください。赤経を地方恒星時から引き、その差を1時間あたり15度で換算して、0以上360未満に正規化します。得られる値は、天体が観測地点の子午線から西向きにどれだけ回転したかを、正の一周角で表したものです。望遠鏡の指向計算や天文ソフトウェアの検証にそのまま利用できます。

● Beta無料・ブラウザ内で実行

無料で実行 API仕様を見る

ご利用方法ウェブAPIメールTelegramアプリ近日

地方時角から分かること

地方時角は、天体が観測地点の天の子午線に対してどの角度位置にあるかを示します。0度なら天体はその子午線上にあります。恒星時が進むにつれて時角は増え、天体が子午線を通過してから空がどれだけ回転したかを表します。本計算では、地方時角＝地方恒星時－赤経という標準的な関係を使います。入力はどちらも十進時なので、差に1時間あたり15度を掛けます。その後、結果を0以上360未満の正の一周角へ正規化します。たとえば15度に近い値は、天体が子午線の西側へおよそ1恒星時進んだことを意味します。345度は－15度と同値で、子午線の東側へおよそ1恒星時の位置です。負数を使わない形式は、ソフトウェア、望遠鏡の指向、作図、角座標の比較に適しています。

地方恒星時と赤経の入力方法

地方恒星時と赤経は、度や時分秒の文字列ではなく十進時で入力してください。10時間30分は10.5時間、8時間15分は8.25時間になります。各入力は有限の数値で、0以上かつ24未満でなければなりません。24時間は0時間と同じ円周上の位置を示すため、1つの座標に2通りの表記が生じないよう除外しています。負数、24以上の値、数字を含む文字列、未入力、無限大、数値以外は無効です。地方恒星時が、観測者の経度と目的の観測時刻に対応していることをご確認ください。本機能は暦日、時計時刻、場所から地方恒星時を算出しません。赤経についても、ご利用の処理に必要な天球基準系で用意してください。すでに準備された2つの赤道座標量の角度差だけを確実に計算します。

正規化された度数の読み方

結果は hour_angle_degrees フィールドに返されます。減算してから正規化するため、0時間をまたぐ場合も正しく処理されます。地方恒星時が1時間、赤経が23時間なら、直接の差は－22時間、すなわち－330度ですが、正規化後は同値の30度です。この規約は負の出力を避け、回転を0度から360度の円で扱うシステムに便利です。符号付き時角が必要な天文アプリケーションでは、180度を超える結果から360度を引いてください。したがって345度は－15度に相当します。通常の数値演算を超える丸めは行わないため、小数入力の有効な精度が保たれます。大気差、歳差、章動、極運動、地心視差の補正は行いません。これらは入力座標の決定に関わる処理であり、時角の減算そのものとは別です。

活用例

望遠鏡の指向計算を準備

天体の赤経と既知の地方恒星時を、次の座標計算で使える正規化済み地方時角へ変換します。

子午線に対する位置を確認

準備済みの2つの恒星座標から、対象が地方子午線上か、その東西どちらにあるかを判定します。

天文ソフトウェアを検証

0時間をまたぐ決定論的な事例で、時単位の値を角度へ変換する処理を試験できます。

よくある質問

どの式で計算しますか？

地方恒星時から赤経を引き、差に1時間あたり15度を掛けて、0以上360未満へ正規化します。

時間、度、時分秒のどれで入力しますか？

両方とも十進時で入力してください。分は60で、秒は3600で割ってから計算します。

24時間が無効なのはなぜですか？

24時間は円周上で0時間と同じ座標です。24未満に限定することで、各座標の表現を一意にします。

負の角度ではなく大きな正の角度になるのはなぜですか？

出力は正規化された一周角です。符号付きの同値角が必要なら、180度を超える結果から360度を引いてください。

日付と経度から地方恒星時も計算しますか？

いいえ。地方恒星時は事前に用意してください。本機能は赤経との差だけを角度として計算します。

API での計算料金はいくらですか？

API リクエスト1回につき $0.002 です。同じ決定論的な計算をブラウザーで無料実行することもできます。

開発者向け — APIアクセス

このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。

エンドポイント

POSThttps://api.kit.forhosting.com/astro/hour-angle-from-lst

Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。

お使いのスタックから呼び出す

curl -X POST https://api.kit.forhosting.com/astro/hour-angle-from-lst \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"local_sidereal_time_hours":10.5,"right_ascension_hours":8.25}'

const res = await fetch("https://api.kit.forhosting.com/astro/hour-angle-from-lst", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "local_sidereal_time_hours": 10.5,
    "right_ascension_hours": 8.25
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/astro/hour-angle-from-lst",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "local_sidereal_time_hours": 10.5,
    "right_ascension_hours": 8.25
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/astro/hour-angle-from-lst", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"local_sidereal_time_hours":10.5,"right_ascension_hours":8.25}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"local_sidereal_time_hours":10.5,"right_ascension_hours":8.25}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/astro/hour-angle-from-lst", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "local_sidereal_time_hours": 10.5,
  "right_ascension_hours": 8.25
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "astro.hour_angle_from_lst",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

非同期APIです。task_idは即時に返ります。ポーリングは1秒あたり1リクエストまでです。

料金

1リクエストあたり$0.002

単価はすべて公開しています。トークン換算や独自クレジットはありません。失敗したタスクは課金されません。

エラー

HTTP	コード	意味
`401`	`unauthorized`	APIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。
`402`	`insufficient_balance`	残高が不足しています。チャージ後に再度お試しください。
`404`	`unknown_type`	指定されたタスクタイプは存在しません。タイプ名を確認してください。
`429`	`rate_limited`	リクエストが多すぎます。しばらく待ってから再度お試しください。

KITの完全なドキュメントを見る →