API paran bintang-planet

Untuk setiap bintang dan planet, endpoint mengambil empat peristiangan sudut (terbit, tenggelam, mencapai puncak, dan anti-puncak) dan bertanya di lintang mana keduanya terjadi pada waktu sidereal lokal yang sama. Puncak menetapkan waktu sidereal pada asensio kanan benda; terbit dan tenggelam memindahkannya dengan busur semi-diurnal, yang merupakan fungsi dari lintang dan deklinasi. Setiap dari pasangan peristiangan dua belas diselesaikan dan setiap akar dilaporkan, dengan lintang, waktu sidereal, dan meridian di mana pasangan bersudut pada momen chart tertentu ini. Meridian melawan meridian ditolak: kondisi itu tidak memiliki lintang di dalamnya, jadi itu entah tidak pernah berlaku atau berlaku di mana-mana, dan berlaku di mana-mana hanya berarti keduanya berbagi asensio kanan. Bintang yang terselesaikan tetapi menghasilkan apa-apa dinamai dalam respons daripada dijatuhkan diam-diam, yang terjadi pada bintang kutub seperti Polaris di hampir seluruh rentang.

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
      }
    ]
  }
}

Gunakan ini ketika lapisan bintang tetap dari chart perlu lebih dari daftar konjungsi. Bintang bersatu dengan planet melalui lintang zodiak adalah proyeksi; paran adalah bintang dan planet benar-benar berdiri di sudut bersama, yang merupakan hubungan yang menjadi dasar karya Brady dan yang menghubungkan bintang dengan tempat di peta. Dalam produk relokasi, lintang diplot sebagai pita horizontal, dan kota yang berada di salah satunya membawa pasangan bintang-planet tersebut. Perhatikan endpoint tidak memerlukan tempat lahir, hanya momen: lintang mana yang ada adalah sifat dari langit, bukan dari tempat orang lahir.

diselesaikan pada sudut jam daripada dengan memotong polyline peta, sehingga lintangnya tepat daripada terkuantisasi ke langkah polyline, dan deklinasi sebenarnya bintang digunakan daripada derajat zodiak yang diproyeksikannya. Perbedaan itu penting: Vega berada di lintang ekliptik 61 derajat dan Sirius di minus 39, jadi derajat yang mereka tempati tidak terbit di mana-mana dekat dengan waktu mereka. Posisi bintang berasal dari katalog bintang tetap Swiss Ephemeris, dan konversi ekliptik-ke-ekuatorial diperiksa terhadap ephemeris itu sendiri dengan menjalankan planet melaluinya. Contoh Castor yang dikerjakan Brady direproduksi hingga dalam satu derajat; itu tidak menetapkan apakah dia menggunakan horizon geometris atau yang tampak, dan karena keduanya berbeda sekitar dua derajat lintang paran, pilihan itu adalah parameter permintaan daripada default diam.