AstroWay/api v2.201.6 · cs
všechny systémy jsou v pořádku
// astrology api · POST /v1/parans/star

API hvězda-planeta parany

Hvězda a planeta jsou v paranu, když jsou obě v úhlové pozici ve stejný okamžik, a zda se to může stát, závisí pouze na zeměpisné šířce. Paran je tedy zeměpisná šířka, takto ji Bernadette Brady tabuluje, a tento endpoint vrací zeměpisné šířky nikoli body. Je dostupných 953 hvězd, 36 ve výchozím souboru.

Endpoint
POST /v1/parans/star
Cost
50 credits
Latency
~152 ms
Tier
Tier 3
// 01 / What it computes

API hvězda-planeta parany

Pro každou hvězdu a planetu endpoint vezme čtyři úhlové události (východ, západ, kulminace, antikulminace) a ptá se, na jaké zeměpisné šířce se tyto dvě události dějí ve stejný místní siderický čas. Kulminace stanoví siderický čas na tělesse right ascension; východ a západ ho posouvají o poloviční denní oblouk, což je funkce zeměpisné šířky a deklinace. Každý z dvanácti párů událostí je vyřešen a každý kořen je hlášen, se zeměpisnou šířkou, siderickým časem a poledníkem, kde je pár v úhlové pozici v tomto konkrétním okamžiku horoskopu. Poledník proti poledníku je odmítnut: tato podmínka nemíří na žádnou zeměpisnou šířku, takže buď nikdy neplatí, nebo platí všude, a platí všude pouze znamená, že sdílejí stejné right ascension. Hvězdy, které byly vyřešeny, ale nevyprodukovaly nic, jsou v odpovědi jmenovány místo tichého odstranění, což se děje u cirkumpolární hvězdy jako Polaris napříč téměř celým rozsahem.

// 02 / Live request

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]
}'
Response (excerpt)
{
  "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
      }
    ]
  }
}
// 03 / Parameters

Parameters

nametypeRequired
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.
// 04 / When to use it

When to use it

Použijte to, když pevná hvězdná vrstva horoskopu potřebuje být více než seznam konjunkcí. Hvězda v konjunkci s planetou podle zodiakální délky je projekce; paran je hvězda a planeta skutečně stojící na úhlech společně, což je vztah, na kterém je postavena Bradyho práce a který váže hvězdu k místu na mapě. V produktu pro změnu místa se zeměpisné šířky zakreslují jako vodorovné pásy a město ležící na jednom z nich nese toto párování hvězda-planeta. Upozorňujeme, že endpoint nepotřebuje místo narození, pouze okamžik: které zeměpisné šířky existují, je vlastností oblohy, nikoli místem, kde se člověk narodil.

// 05 / Notes

Notes

Řešeno na hodinových úhlech nikoli průsečíkem mapových linií, takže zeměpisná šířka je přesná místo kvantizace na krok linií, a je použita skutečná deklinace hvězdy nikoli zodiakální stupeň, na který promítá. Tato rozdílnost je důležitá: Vega leží na ekliptické šířce 61 stupňů a Sirius na minus 39, takže stupeň, který zaujímají, nevychází nikde blízko, když ony vycházejí. Pozice hvězd pocházejí ze katalogu Swiss Ephemeris fixed-star a převod z ekliptického na rovníkový je ověřen proti samotnému efemeridám spuštěním planet skrz něj. Bradyho vyřešený příklad Castoru je reprodukován na jeden stupeň přes; neurčuje, zda použila geometrický nebo zjevný horizont, a protože se dva liší asi o dva stupně paran šířky, je tento výběr parametrem požadavku místo tichého výchozího nastavení.

Try the Hvězda-planeta parany API

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

99,9% SLA · placené plány · 30 dní status →