Rectification API: 開発者のための出生時刻の修正

占星術のユーザーの多くは、生年月日は知っていても正確な出生時刻は知りません。30 分の違いでアセンダントが 5 度以上ずれることがあり、それによってハウスの位置やアスペクトが変わります。本格的な占星術の作業では、これは重要な問題です。

占星術師がこれを補正するための技法はレクティファイと呼ばれ、既知の人生の出来事からもっともらしい出生時刻を復元します。従来は何時間もかかる手作業でした。AstroWay は、これを自動化する 2 つのアルゴリズム系エンドポイントを提供しています。

この記事では、レクティファイをいつ使うべきか、アルゴリズムがどう動くか、そしてアプリにどう組み込むかを説明します。

レクティファイとは出生時刻の修正のことです。おおよその時刻 (たとえば “朝” や “14:00 ごろ”) から始めて、次のような情報を使って範囲を絞り込みます:

• 人生の重要な出来事 (結婚、子どもの誕生、キャリアの転機、死別)
• 身体的な特徴 (古典占星術ではアセンダントのサインを体型に対応づけます)
• 出生時の惑星のアングル上の位置

結果として得られるのは修正された出生時刻で、通常は実際の時刻から ±5 分以内に収まります。

ヘルメス・トリスメギストスに由来するとされる古典的な手法です。出生時の月の位置と、受胎時 (約 9 か月前) のアセンダント / ディセンダントとの関係を利用します。

仕組み:

1. おおよその生年月日を取る
2. 受胎日の範囲 (260〜290 日前) を計算する
3. 受胎日の候補ごとに、出生時の月の位置が受胎時のアセンダント / ディセンダントに一致するかを確認する
4. 一致度の高い順に並べた出生時刻の候補リストを返す

高速ですが、精度はやや劣ります。広い範囲を絞り込むのに向いています (たとえば “朝” → 2 時間の範囲)。

const result = await client.rectification.trutine({
  date: '1990-07-14',
  time: '14:30:00',
  timezoneOffset: 3,
  latitude: 50.4501,
  longitude: 30.5234,
});

console.log(`Suggested ascendant: ${result.suggestedAsc.toFixed(2)}°`);
console.log(`Moon above the horizon at conception: ${result.moonAboveHorizon}`);

複数の人生の出来事にもとづくアルゴリズム的なアプローチです。こちらは重い処理です (1 リクエストあたり最大 120 秒)。

入力:

• おおよその出生時刻 (範囲)
• 日付と種類を含む人生の出来事のリスト
• オプション: 身体的な特徴の説明

アルゴリズム:

1. 範囲内で出生時刻の候補を生成する (通常は 1 分刻み)
2. 候補ごとに出生図を計算する
3. 出来事が予測される占星術的パターン (プログレス、ディレクション、トランジット) とどれだけ一致するかで各候補をスコアリングする
4. 上位の候補を信頼度スコア付きで返す

const result = await client.rectification.compute({
  baseInput: {
    date: '1990-07-14',
    time: '14:30:00',
    timezoneOffset: 3,
    latitude: 50.4501,
    longitude: 30.5234,
  },
  events: [
    // type picks which significators are checked; weight is 1-3 importance
    { date: '2015-06-20', type: 'marriage', description: 'married', weight: 3 },
    { date: '2018-03-12', type: 'child', description: 'first child', weight: 2 },
    { date: '2020-09-05', type: 'career', description: 'career change', weight: 2 },
  ],
  searchRangeMinutes: 120,
  stepMinutes: 5,
});

const best = result.candidates[0];
console.log(`Best candidate: ${best.timeFormatted}, score ${best.score.toFixed(2)}, ${result.count} candidates scored`);
console.log(`Candidates: ${result.candidates.length}`);

レクティファイが価値を持つのは次のような場合です:

• 出生時刻を知らないユーザーがいるアプリ: レクティファイをプレミアム機能として提供できます
• プロの占星術師向けツール: クライアント 1 人あたり何時間もの手作業を省けます
• HD アプリ: Human Design は時刻に非常に敏感で、レクティファイによって精度が大きく向上します
• 研究用アプリ: 時刻の記録が不正確な歴史的チャートを検証できます

役に立たないのは次のような場合です:

• ユーザーがすでに ±5 分の精度で時刻を知っているアプリ (メリットがありません)
• 時刻の精度が出力に影響しないカジュアルな星占いアプリ (毎日の sun sign には不要です)

• Trutine: 250 クレジット: 1 リクエストあたり約 1〜2 秒
• 完全なレクティファイ: 500 クレジット: 最大 120 秒

これらは API の中で最も重いエンドポイントです。レクティファイを機能として提供するなら、それに見合った価格設定にしてください: 高いサブスクリプション料金や単発購入に見合うプレミアムな処理です。

予算の目安:

• 月 100 回のレクティファイ: 約 50,000 クレジット = Pro プラン ($59)、他の呼び出しにも余裕あり
• 月 1,000 回のレクティファイ: 500,000 クレジット = Enterprise

レクティファイには時間がかかります。UI には次のものが必要です:

• 非同期処理: リクエストをブロックせず、キューに入れて進捗を表示する
• 進捗インジケーター: 完全版のエンドポイントは最大 120 秒かかるため、ユーザーにはフィードバックが必要です
• 結果の表示: 修正された時刻、信頼度、出来事が不正確だった場合にやり直せる手段

async function handleRectify(input: RectifyInput) {
  setLoading(true);
  setStatus('Running rectification (this may take up to 2 minutes)...');

  try {
    const result = await client.rectification.compute(input);
    setResult(result);
    const best = result.candidates[0];
    setStatus(`Done. Refined time: ${best.timeFormatted} (score ${best.score.toFixed(2)} of ${result.count})`);
  } catch (err) {
    setStatus(`Error: ${err.message}`);
  } finally {
    setLoading(false);
  }
}

アプリでの典型的なレクティファイの流れ:

1. ユーザーがおおよその出生データと人生の出来事を入力する
2. アプリはまず /v1/rectification/trutine を呼び出し (安価で高速)、範囲を絞り込む
3. 次に、絞り込んだ範囲で /v1/rectification (完全版) を呼び出して精度を上げる
4. アプリは結果をキャッシュし、以後のすべての計算で修正後の時刻を使う
5. 以後の呼び出しには “rectified from approximate” のラベルを付ける

この組み合わせでは 1 サイクルあたり約 750 クレジットかかりますが、最も高い精度が得られます。

レクティファイで 100% の精度が得られることはありません。プロの占星術師同士でも、見解が 5〜10 分ずれることがあります。

AstroWay のアルゴリズムが目指すのは相対的な精度です。範囲は絞り込みますが、出力は保証された真実ではなく、常に “最有力の候補” として位置づけられます。ユーザーには必ず confidence スコアを示し、より良い情報を持っている場合は上書きできるようにしてください。

アルゴリズムはパターンの探索です。経験豊富な占星術師は、コード化しにくい文脈を考慮します: “結婚は急なものだったか?” “キャリアの転機は自発的なものだったか?” 重要度の高いチャートでは、次を組み合わせてください:

1. アルゴリズムによるレクティファイ: 範囲を絞り込むため
2. 占星術師による手動のレビュー: 最終的な調整のため

アプリでは、これをプレミアムな相談サービスとして提供することもできます。

• API reference: rectification と rectification/trutine のエンドポイントを確認
• 料金: プラン別のクレジット単価
• クイックスタート: API キーを取得