赤緯
ホロスコープは黄道への投影であり、その投影は一つの軸を捨てています。赤緯とは、同じ天体を天の 赤道から測ったときに残るもの — 印刷された天体暦の二番目の表であり、どのアスペクト表にも載って いない座標です。
この軸には二つのものが存在し、どちらも黄道十二宮のチャートには現れません。
- パラレルとコントラパラレル。 同じ赤緯にある二つの天体はパラレルを形成し、コンジャンク ションのように働きます。赤道からの距離が等しく反対側にある場合はコントラパラレルで、オポジ ションのように働きます。どちらも、黄経では何のアスペクトも作らない天体どうしのあいだに生じ ることがあります。
- アウト・オブ・バウンズ。 太陽自身の最大赤緯を超えた天体のことです。月は大停止(メジャー スタンドスティル)の前後に月に数日そうなります。水星、金星、火星、冥王星は間隔をおいてそう なります。実在し、よく議論される状態でありながら、一般向けソフトウェアはほとんど報告しません。
必要なモジュール
どちらのエンドポイントも declination:calc モジュールを必要とします。すべてのプランに含まれて おり、単体では販売していません。
ある瞬間の赤緯
curl -X POST "https://api.astroapi.cloud/api/calc/declination" \
-H "X-Api-Key: your-api-key" \
-H "Content-Type: application/json" \
-d '{
"dateTime": "1990-06-15T14:30",
"location": {
"latitude": 52.37,
"longitude": 4.89,
"timezone": "Europe/Amsterdam"
},
"orb": 1
}'パラメータ
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
dateTime | string | はい | YYYY-MM-DDTHH:mm 形式、location における現地時計時刻 |
location | object | はい | latitude、longitude、および IANA の timezone |
points | array | いいえ | 計算する天体点。既定は 10 天体、両ノード、両リリス |
orb | number | いいえ | パラレルとコントラパラレルのオーブ、0〜3 度。既定は 1 |
moonCenter | string | いいえ | topocentric(既定)または geocentric |
ここでのオーブは、あちらのオーブではありません
赤緯のオーブは黄経のオーブよりはるかに狭いものです。1 度が慣例であり既定値です。2 度を超えると、 ほとんどすべてが何かにパラレルになってしまいます。
レスポンス
{
"data": {
"dateTime": "1990-06-15T12:30:00.000Z",
"points": {
"sun": {
"pointId": "sun",
"declination": 23.32,
"declinationDms": [23, 19, 12],
"rightAscension": 84.1,
"latitude": 0,
"speedDeclination": 0.04,
"outOfBounds": false,
"hemisphere": "north"
},
"moon": {
"pointId": "moon",
"declination": -18.44,
"declinationDms": [18, 26, 24],
"rightAscension": 312.7,
"latitude": -4.61,
"speedDeclination": -3.1,
"outOfBounds": false,
"hemisphere": "south"
}
},
"aspects": [
{
"pointA": "venus",
"pointB": "mars",
"aspect": "parallel",
"orb": 0.31,
"applying": true,
"declinationA": 21.08,
"declinationB": 21.39
}
],
"extremes": {
"northernmost": "sun",
"southernmost": "moon",
"outOfBoundsCount": 0
},
"obliquity": 23.4405
}
}declinationDms は [度, 分, 秒] 形式の絶対値です。どちら側かは hemisphere と declination の符号にあります。speedDeclination は 1 日あたりの度数で、負の値は南向きを意味 します。パラレルが接近中か分離中かはこれで分かります。黄経のアスペクトで applying が答えるの と同じ問いです。
アウト・オブ・バウンズの境界
obliquity は要求された日付における黄道の真の傾斜角 — 太陽自身の最大赤緯であり、したがって outOfBounds が判定された境界です。クライアントが独自の限界値を作り出さずに帯を描けるよう返され ます。
慣例的な値は 23°26' です。しかし実際の値は動きます。章動によって最大 9 秒角ずれ、それは境界上の ケースをどちらかに決めるのに十分です。返された obliquity と比較するのと、固定値 23.4367 と比較 するのとでは、ちょうど線上にある天体について答えが食い違います。
太陽が アウト・オブ・バウンズになることはありません
定義上そうです — 条件は「太陽を超えている」ことだからです。ちょうど境界上にある天体はアウト・ オブ・バウンズではありません。境界を超えていなければなりません。
期間にわたる赤緯
もう半分であり、これが出生図のフィールドではなく独立したエンドポイントである理由です。赤緯のグラ フは時間の系列であり、天体がアウト・オブ・バウンズの境界を横切る日付こそ、占星術師が実際に書き 留めるものだからです。
curl -X POST "https://api.astroapi.cloud/api/calc/declination/series" \
-H "X-Api-Key: your-api-key" \
-H "Content-Type: application/json" \
-d '{
"startDate": "2025-01-01",
"endDate": "2025-12-31",
"stepDays": 2,
"points": ["sun", "moon", "mercury", "venus", "mars", "pluto"]
}'パラメータ
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
startDate | string | はい | YYYY-MM-DD または ISO 8601 |
endDate | string | はい | YYYY-MM-DD または ISO 8601 |
stepDays | number | いいえ | 系列の点の間隔(日)、0.25〜30。既定は 1 |
points | array | いいえ | 描画する天体点。既定は上記と同じ |
レスポンス
{
"data": {
"startDate": "2025-01-01T00:00:00.000Z",
"endDate": "2025-12-31T23:59:00.000Z",
"stepDays": 2,
"points": ["sun", "moon", "mercury", "venus", "mars", "pluto"],
"series": {
"moon": [
["2025-01-01T00:00:00.000Z", -14.02],
["2025-01-03T00:00:00.000Z", 8.71]
]
},
"crossings": [
{
"pointId": "moon",
"date": "2025-03-06T07:41:12.000Z",
"direction": "out",
"declination": 23.4392
},
{
"pointId": "moon",
"date": "2025-03-10T02:18:55.000Z",
"direction": "in",
"declination": 23.4392
}
]
}
}横断は stepDays ではサンプリングされません
月が境界を超えて出る期間は数日です。週単位で描いた系列はそれをまたいで通り過ぎてしまいます。 そのため横断は、系列が返される格子よりも細かい格子で探索され、その後それぞれが天体暦に対して 秒単位まで精密化されます。
実用上の帰結は、広い stepDays は曲線の形を失わせますが、横断の日付を失わせることは決してない という点です。グラフに必要な解像度だけを求めてください。
系列の上限
系列は 400 点に制限されています。1 年を日単位で刻むと 365 点、10 年を日単位で刻むと 3653 点 となり、刻み幅を広げるよう助言する 400 が返ります。
{
"error": "That range at a 1-day step is 3654 points; the limit is 400. Widen stepDays or shorten the range."
}いずれにせよこれは 1 リクエストです。同じ表を 400 回の個別呼び出しで組み立てると、月間割当から 400 リクエストを消費します。系列エンドポイントは 1 回のパスで計算し、1 リクエストとして数えられ ます。
出生図における赤緯
API バージョン 2026-09-10 以降、出生図レスポンスのすべての天体点 も declination と outOfBounds を持つため、ホイールは 2 回目の呼び出しなしにアウト・オブ・ バウンズの天体を示せます。
curl -X POST "https://api.astroapi.cloud/api/calc/natal" \
-H "X-Api-Key: your-api-key" \
-H "X-Api-Version: 2026-09-10" \
-H "Content-Type: application/json" \
-d '{ "dateTime": "1990-06-15T14:30", "location": { "latitude": 52.37, "longitude": 4.89, "timezone": "Europe/Amsterdam" } }'古いバージョンの呼び出し側は、これまでずっと受け取ってきたレスポンス形式をそのまま保ちます。 バージョンの固定方法については API バージョニングを参照してください。
出生図レスポンスが持つのはこの 2 つのフィールドだけです。パラレル、コントラパラレル、赤経、赤緯 の速度、そして系列はすべて上記のエンドポイントにあります。
これは何ではないか
ここに 3D ビューはなく、それは意図的なものです。赤緯の正しい描き方は軸に対する線です。天球は 見た目を美しくしますが、分かりやすくはしません。