星と惑星のパランAPI
星と惑星が同時に角度に位置する状態をパランと言います。これは緯度によってのみ決まり、パランは緯度そのものを指します。これがBernadette Bradyの分類方法であり、このエンドポイントは点ではなく緯度を返します。利用可能な星は953個あり、デフォルトセットでは36個です。
星と惑星のパランAPI
各星と惑星に対して、エンドポイントは4つの角度イベント(上昇、沈没、南中、反南中)を取り、両者が同じ恒星時に起こる緯度を計算します。南中は恒星時を天体の赤経で固定し、上昇と沈没は半日弧によって移動させます。半日弧は緯度と赤緯の関数です。12のイベントペアそれぞれが解かれ、緯度、恒星時、ペアがこの特定のチャート瞬間に角度にある子午線と共にすべての根が報告されます。子午線対子午線は拒否されます:その条件には緯度が含まれないため、それは決して成立しないか、どこでも成立します。どこでも成立するということは、両者が同じ赤経を持つだけのことです。解決されたが何も生成しなかった星は、沈没星のようにほぼ全域で起こるように、応答に名前が記載され、黙って削除されるのではありません。
POST/v1/parans/star
curl -X POST https://api.astroway.info/v1/parans/star \
-H "X-Api-Key: aw_live_..." \
-H "Content-Type: application/json" \
-d '{
"date": "1990-05-15",
"time": "14:30:00",
"timezoneOffset": 3,
"stars": ["Regulus", "Sirius"],
"planets": [0, 4]
}' {
"ok": true,
"data": {
"type": "star-parans",
"horizon": "geometric",
"latitudeLimit": 60,
"count": 16,
"stars": [
{ "name": "Regulus", "magnitude": 1.36, "rightAscension": 151.9686, "declination": 12.0133 }
],
"parans": [
{
"star": "Regulus",
"starEvent": "rise",
"planetId": 0,
"planetName": "Sun",
"planetEvent": "culminate",
"latitude": 39.1022,
"longitude": 6.5735,
"lst": 51.6
}
]
}
} Parameters
| name | type | Required | |
|---|---|---|---|
| date | string (YYYY-MM-DD) | yes | Birth date. |
| time | string (HH:MM:SS) | yes | Local clock time at birth. |
| timezoneOffset | number (hours) | no | UTC offset in effect at the birth moment. Defaults to 0. |
| stars | string[] | no | Star names from the Swiss Ephemeris catalogue. Defaults to the 36-star astrological set. The full list is at GET /v1/fixed-stars/catalog. |
| planets | number[] | no | Swiss Ephemeris planet ids. Defaults to 0-9, Sun through Pluto. |
| latitudeLimit | number (degrees) | no | Search range either side of the equator. Defaults to 60, the range Brady tabulates. |
| horizon | "geometric" | "apparent" | no | Which horizon counts as rising. Geometric (default) is altitude 0; apparent is -34 arcmin, where refraction lifts a body into view first. Worth about two degrees of paran latitude at mid-latitudes. |
When to use it
チャートの固定星層が単なる合致リスト以上に必要な場合に使用します。黄道経度による星と惑星の合致は投影ですが、パランは実際に星と惑星が角度に立つ状態です。これはBradyの研究の基礎となり、星を地図の場所に結びつける関係です。再配置製品では緯度が水平帯としてプロットされ、その上にある都市はその星-惑星ペアを持ちます。エンドポイントは出生地を必要とせず、瞬間のみを必要とすることに注意してください:存在する緯度は空の性質であり、人が生まれた場所の性質ではありません。
Notes
地図のポリラインの交点ではなく時角で解かれるため、緯度はポリラインステップに量子化されるのではなく正確であり、星の実際の赤緯が投影される黄道度ではなく使用されます。その区別は重要です:ベガは黄道緯度61度にあり、シリウスはマイナス39度にあり、彼らが占める度は彼らが上昇する時刻に近くでは上昇しません。星の位置はスイス星暦の固定星カタログから来ており、黄道から赤道への変換は惑星を通して星暦自体に対してチェックされます。Bradyの作業したカストルの例は1度以内で再現されます;彼女が幾何学的地平線または見かけの地平線のどちらを使用したかは決定されません。そして、両者は約2度のパラン緯度で異なるため、その選択は黙ってのデフォルトではなくリクエストパラメータです。
Try the 星と惑星のパラン API
Grab a key and make your first call in under a minute.