測地等価チャート API
測地チャートは地理情報だけで4つの角度を算出するんだ。牡羊座の0度はグリニッジ子午線に固定され、経度1度が黄道の1度になる。地球上のどこでも出生時間なしでMidheavenとAscendantが得られるんだよ。
測地等価チャート API
緯度と経度を渡すと、endpointは測地のMidheaven、Imum Coeli、Ascendant、Descendantをecliptic degreesで返す。さらにMCとAscendantのサインインデックスとサイン内の度数も含む。2つの方式に対応している。デフォルトのSepharialは地上の経度をそのまま黄道経度にマッピングし、たとえば東経30.52度は牡牛座0度31分になる。Johndroはobliquity補正を行い、AscendantをSepharial値からシフトさせ、年か明示的なobliquity(度)を必要とする。人物情報が計算に入らないので、同じ座標は常に同じ角度を返す。そのためendpointはキャッシュしやすく、場所ベースの機能の自然なアンカーになるんだ。
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"
}' {
"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"
}
} Parameters
| name | type | Required | |
|---|---|---|---|
| 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. |
When to use it
日常的な作業で、対象が国や都市、イベントで人物でないときに測地チャートを使うといいよ。典型的な使い方は、日食やイングレスが首都の測地角度に当たるかテストしたり、創設時刻が不明でもチャートが必要な国のプロフィールページを作ったり、astrocartographyと全く独立した手法でクロスチェックしたりすることだ。実用的な問題も解決できる。ユーザーに出生時間がなくても、ほとんどのチャートendpointは精度が落ちるが、現在の都市の測地チャートは完全に定義されていて、その場所について具体的に語ってくれる。レスポンスは小さく決定的だから、1回のtier-oneコールで済み、都市リスト全体を一括で計算しても安全だよ。
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.