Swiss Ephemeris API

Swiss Ephemeris - 事実上の天文学計算の標準で、Astrodienst (astro.com)、Solar Fire、Kerykeion、そしてほとんどの本格的なソフトが使用しています。NASA JPL の DE431 エフェメリスを読み取り、サブ秒精度を提供します。AstroWay API は直接 HTTP アクセスを提供します - C ライブラリのコンパイル不要、.se1 ファイルのダウンロード不要、メモリ管理不要です。POST リクエスト 1 回で、JSON が返ります。

Swiss Ephemeris を API 経由で使う理由

Self-host で Swiss Ephemeris を使うということは、C ライブラリ（または WASM ビルド）をビルドし、数百メガバイトの .se1 ファイルを配置し、最新の状態に保ち、ハウスカスピディ、アスペクト、フェーズを自分で実装することです。API を使えば、これらすべてが他人の面倒です：

インフラゼロ: バイナリやエフェメリスファイル、cold-start の遅延が一切ありません。計算は server-side で Astrodienst と同じエンジンで実行されます。
サブ秒精度: < 0.1″ と Astrodienst の基準 swetest CGI を比較し、873 件の凍結されたスナップショットテストで各デプロイ時に検証されています。
完全な日付範囲: DE431 は 13201 BCE – 17191 CE をカバーしており、歴史的なものから遠い未来のチャートまで精度を失わずに計算できます。
位置情報だけでなく: エフェメリスの上にハウスカスピディ（15 システム）、アスペクト、食、トランジット、プログレッションがすぐに利用可能です。self-host では自分で実装しなければなりません。

Swiss Ephemeris で計算できるもの

エンドポイント	クレジット	返却内容
`/v1/chart`	20	完全なチャート: 惑星 + ハウス + アスペクト
`/v1/planets`	10	地心座標の惑星位置（経度、緯度、速度、逆行）
`/v1/houses`	10	ハウスカスピディ - 15 システム (Placidus, Koch, Whole Sign, Equal…)
`/v1/transits`	50	出生図に対する指定日のトランジット
`/v1/progressions`	50	二次プログレッション（1日 = 1年）
`/v1/eclipses`	100	太陽と月の食（NASA カタログと比較検証済み）
`/v1/moon-phase`	10	月相、照度、次の四半期
`/v1/fixed-stars`	20	固定星との惑星合（コンジャンクション）

これはプラットフォームの 760 エンドポイントの一部です - 完全なリストは API リファレンスにあります。

例

curl -X POST https://api.astroway.info/v1/planets \
  -H "X-Api-Key: aw_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "date": "1990-07-14",
    "time": "14:30:00",
    "timezoneOffset": 3,
    "latitude": 50.4501,
    "longitude": 30.5234
  }'

const r = await fetch('https://api.astroway.info/v1/planets', {
  method: 'POST',
  headers: {
    'X-Api-Key': process.env.ASTROWAY_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    date: '1990-07-14',
    time: '14:30:00',
    timezoneOffset: 3,
    latitude: 50.4501,
    longitude: 30.5234,
  }),
});
const { data } = await r.json();
const sun = data.planets.find((p) => p.name === 'Sun');
console.log(`Sun: ${sun.longitude.toFixed(4)}° retrograde: ${sun.isRetrograde}`);

import os, requests

r = requests.post(
    'https://api.astroway.info/v1/planets',
    headers={'X-Api-Key': os.environ['ASTROWAY_API_KEY'], 'Content-Type': 'application/json'},
    json={
        'date': '1990-07-14',
        'time': '14:30:00',
        'timezoneOffset': 3,
        'latitude': 50.4501,
        'longitude': 30.5234,
    },
)
data = r.json()['data']
sun = next(p for p in data['planets'] if p['name'] == 'Sun')
print(f"Sun: {sun['longitude']:.4f}° retrograde: {sun['isRetrograde']}")

利用者

アストロアプリ開発者: self-host の C ライブラリなしでサブ秒レベルの位置情報が取得可能
AI エージェント: LLM のグラウンディングとして正確なエフェメリス（MCP サーバー経由）
研究者: DE431 の歴史的範囲で大量計算が可能
self-host からの移行: ローカル swisseph を HTTP に置き換えて精度を維持

料金

惑星位置 (/v1/planets) は 10 クレジット、完全なチャート (/v1/chart) は 20。Free プランでは (760+ エンドポイント、10 000 クレジット/月) - 月に約 1000 回の惑星リクエストが無料で、カードは不要です。

Точність розрахунків → Триангуляція, NASA-валідація, snapshot-тести

Швидкий старт Перший запит за 5 хвилин

Тарифи Від безкоштовного до Enterprise

参考になりましたか？

Запропонувати правку

最終更新日: 2026/09/11