API αστροπλανητικών παρανοών

Για κάθε αστέρι και πλανήτη, το endpoint παίρνει τα τέσσερα γωνιακά γεγονότα (ανατολή, δύση, κορύφωση, αντι-κορυφωση) και ρωτά σε ποιο πλάτος συμβαίνουν τα δύο την ίδια τοπική αστρική ώρα. Η κορύφωση καθορίζει την αστρική ώρα στη δεξιά ανάληψη του σώματος· η ανατολή και η δύση τη μεταβάλλουν κατά το ημιδιαπλανητικό τόξο, που εξαρτάται από το πλάτος και την εκκλίση. Κάθε ένα από τα δώδεκα ζεύγη γεγονότων λύνεται και κάθε ρίζα αναφέρεται, με το πλάτος, την αστρική ώρα και το μεσημβρινό όπου το ζεύγος είναι γωνιακό σε αυτή τη συγκεκριμένη στιγμή του χάρτη. Μεσημβρινό εναντίον μεσημβρινού απορρίπτεται: αυτή η συνθήκη δεν έχει πλάτος, οπότε είτε δεν ισχύει ποτέ είτε ισχύει παντού, και το πανταχού ισχύει σημαίνει ότι τα δύο μοιράζονται τη δεξιά ανάληψη. Τα αστέρια που λύθηκαν αλλά δεν έδωσαν αποτέλεσμα ονομάζονται στην απάντηση αντί να απορρίπτονται σιωπηρά, όπως συμβαίνει με ένα κυκλικο-πολικό αστέρι όπως η Polaris σε σχεδόν όλο το εύρος.

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

Χρησιμοποίησέ το όταν το στρώμα σταθερών αστεριών ενός χάρτη χρειάζεται να είναι κάτι παραπάνω από μια λίστα σύζευξης. Ένα αστέρι σε σύζευξη με πλανήτη κατά το ζωντικό μήκος είναι μια προβολή· ένα paran είναι το αστέρι και ο πλανήτης που πραγματικά στέκονται στις γωνίες μαζί, που είναι η σχέση πάνω στην οποία βασίζεται η δουλειά της Brady και που συνδέει ένα αστέρι με μια θέση στον χάρτη. Σε ένα προϊόν μετεγκατάστασης τα πλάτη εμφανίζονται ως οριζόντιες ζώνες, και μια πόλη που βρίσκεται σε μία φέρει αυτό το ζεύγος αστέρι-πλανήτης. Σημείωσε ότι το endpoint δεν χρειάζεται τόπο γέννησης, μόνο τη στιγμή: ποια πλάτη υπάρχουν είναι ιδιότητα του ουρανού, όχι του τόπου γέννησης.

Λύνεται με γωνίες ώρας αντί για τομή χάρτη πολυγραμμών, έτσι το πλάτος είναι ακριβές αντί για ποσοτικοποιημένο στο βήμα της πολυγραμμής, και η πραγματική εκκλίση του αστεριού χρησιμοποιείται αντί για το ζωντικό βαθμό στο οποίο προβάλλεται. Αυτή η διαφορά μετράει: η Vega βρίσκεται σε ελλειπτική πλάτος 61 μοίρες και ο Σείριος σε -39, οπότε ο βαθμός που καταλαμβάνουν δεν ανεβαίνει πουθενά κοντά όταν το κάνουν. Οι θέσεις των αστεριών προέρχονται από τον κατάλογο σταθερών αστεριών του Swiss Ephemeris, και η μετατροπή ελλειπτικού-σε-ισημερινού ελέγχεται έναντι του εφημερίσματος τρέχοντας τους πλανήτες μέσα από αυτό. Το παράδειγμα Castor της Brady αναπαράγεται εντός ενός βαθμού· δεν καθορίζει αν χρησιμοποίησε το γεωμετρικό ή το εμφανές ορίζοντα, και επειδή τα δύο διαφέρουν περίπου δύο μοίρες σε paran πλάτος, αυτή η επιλογή είναι παράμετρος αιτήματος αντί για σιωπηρή προεπιλογή.