AstroWay/api v2.173.1 · ja
すべてのシステムが正常です
// astrology api · POST /v1/geodetic

測地等価チャート API

測地チャートは地理情報だけで4つの角度を算出するんだ。牡羊座の0度はグリニッジ子午線に固定され、経度1度が黄道の1度になる。地球上のどこでも出生時間なしでMidheavenとAscendantが得られるんだよ。

Endpoint
POST /v1/geodetic
Cost
10 credits
Latency
~121 ms
Tier
Tier 1
// 01 / What it computes

測地等価チャート API

緯度と経度を渡すと、endpointは測地のMidheaven、Imum Coeli、Ascendant、Descendantをecliptic degreesで返す。さらにMCとAscendantのサインインデックスとサイン内の度数も含む。2つの方式に対応している。デフォルトのSepharialは地上の経度をそのまま黄道経度にマッピングし、たとえば東経30.52度は牡牛座0度31分になる。Johndroはobliquity補正を行い、AscendantをSepharial値からシフトさせ、年か明示的なobliquity(度)を必要とする。人物情報が計算に入らないので、同じ座標は常に同じ角度を返す。そのためendpointはキャッシュしやすく、場所ベースの機能の自然なアンカーになるんだ。

// 02 / Live request

POST/v1/geodetic

curl -X POST https://api.astroway.info/v1/geodetic \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
  "latitude": 50.45,
  "longitude": 30.52,
  "method": "sepharial"
}'
Response (excerpt)
{
  "ok": true,
  "data": {
    "mc": 30.52,
    "ic": 210.52,
    "asc": 317.7269,
    "dsc": 137.7269,
    "mcSign": 1,
    "mcDegree": 0.52,
    "ascSign": 10,
    "ascDegree": 17.7269,
    "method": "sepharial"
  }
}
// 03 / Parameters

Parameters

nametypeRequired
latitude number yes Place latitude, decimal degrees (north positive).
longitude number yes Place longitude, decimal degrees (east positive). This is what drives the geodetic MC.
method string no sepharial (default) maps longitude directly onto the zodiac; johndro applies an obliquity correction.
year number no Year used for the obliquity value in the johndro method. Ignored by sepharial.
obliquity number no Explicit obliquity in degrees, overriding the year-derived value.
// 04 / When to use it

When to use it

日常的な作業で、対象が国や都市、イベントで人物でないときに測地チャートを使うといいよ。典型的な使い方は、日食やイングレスが首都の測地角度に当たるかテストしたり、創設時刻が不明でもチャートが必要な国のプロフィールページを作ったり、astrocartographyと全く独立した手法でクロスチェックしたりすることだ。実用的な問題も解決できる。ユーザーに出生時間がなくても、ほとんどのチャートendpointは精度が落ちるが、現在の都市の測地チャートは完全に定義されていて、その場所について具体的に語ってくれる。レスポンスは小さく決定的だから、1回のtier-oneコールで済み、都市リスト全体を一括で計算しても安全だよ。

// 05 / Notes

Notes

SepharialとJohndroは設計上の違いで合意しないだけで、エラーではない。どちらもリクエスト時に返され、どちらかが正規とされることはない。技術は20世紀初頭のSepharialが起源で、L. Edward Johndroが拡張した。測地フレームはグリニッジ子午線に固定されているので、結果は時間に対して安定し、ephemeris参照が不要だ。だからastro-geographyファミリーで唯一Swiss Ephemerisに依存しないendpointなのさ。

Try the 測地チャート API

Grab a key and make your first call in under a minute.

99.9% SLA · 有料プラン · 30日間 ステータス →