Yıldız-gezegen parans API
Bir yıldız ve bir gezegen aynı anda açısal olduğunda paran içindedir ve bunun olup olmayacağı sadece enleme bağlıdır. Yani paran bir enlemdir, Bernadette Brady'nin bunu tabloya dökme şeklidir ve bu endpoint noktalar yerine enlemler döndürür. 953 yıldız mevcut, varsayılan sette 36.
Yıldız-gezegen parans API
Her bir yıldız ve gezegen için endpoint dört açısal olayı (doğuş, batış, doruk, antidoruk) alır ve iki olayın aynı yerel sidereal zamanda hangi enlemde gerçekleştiğini sorar. Doruk, sidereal zamanı gövdenin right ascension'ına sabitler; doğuş ve batış, yarı günlük yayla, enlem ve declination'ın bir fonksiyonu olarak hareket ettirir. On iki olay çiftinin her biri çözülür ve her kök, enlem, sidereal zaman ve çiftin bu belirli chart anında açısal olduğu meridian ile raporlanır. Meridian karşı meridian reddedilir: bu koşulda enlem yoktur, bu yüzden ya hiç gerçekleşmez ya da her yerde gerçekleşir ve her yerde gerçekleşmek sadece iki nesnenin aynı right ascension'ı paylaştığı anlamına gelir. Çözülüp hiçbir şey üretmeyen yıldızlar, yanıt içinde isimleriyle verilir, sessizce atlanmaz; bu, neredeyse tüm aralıkta Polaris gibi circumpolar yıldızın başına gelen şeydir.
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
Bunu, bir haritanın sabit yıldız katmanının sadece bir birleşim listesi olmaktan daha fazlasına ihtiyaç duyduğunda kullan. Bir yıldızın bir gezegeni zodiacal uzunlukla birleşmesi bir projeksiyondur; bir paran, yıldız ve gezegenin gerçekten aynı anda açılarda durmasıdır, bu Brady'nin çalışmasının temeli ve bir yıldızı haritadaki bir konuma bağlayan ilişkidir. Yeniden konumlandırma ürününde enlemler yatay bantlar olarak çizilir ve bir şehir bunlardan birinde durduğunda o yıldız-gezegen eşleşmesini taşır. Endpoint'in doğum yeri gerekmez, sadece an gerekir: hangi enlemlerin var olduğu gökyüzünün bir özelliğidir, kişinin doğduğu yerin değil.
Notes
Harita polylinelerini kesiştirerek değil, saat açıları üzerinden çözüldü, böylece enlem polylin adımına göre kuantize olmak yerine tamdır ve yıldızın gerçek declination'ı, üzerine projekte ettiği zodiac derecesi yerine kullanılır. Bu ayrım önemlidir: Vega ekliptik enlem 61 derece, Sirius ise -39 derecededir, bu yüzden işgal ettikleri derece, gerçekleştiğinde yakın bir yerde yükselmez. Yıldız konumları Swiss Ephemeris sabit yıldız kataloğundan gelir ve ekliptik-equatorial dönüşümü, gezegenler üzerinden çalıştırılarak ephemeris'e karşı kontrol edilir. Brady'nin Castor örneği bir derece içinde yeniden üretilir; geometrik mi yoksa görünür ufuk mu kullandığı kesinleşmez ve iki değer paran enleminde yaklaşık iki derece farklı olduğundan, bu seçim sessiz bir varsayılan yerine istek parametresidir.
Try the Yıldız-gezegen parans API
Grab a key and make your first call in under a minute.