Αστροκαρτογραφία API
Η αστροκαρτογραφία παίρνει μια μοναδική στιγμή γέννησης και την προβάλλει σε όλο τον πλανήτη: αντί να ρωτάει πού ήταν οι πλανήτες στον ουρανό, ρωτάει πού στη Γη κάθε πλανήτης ήταν γωνιακός. Το endpoint σου επιστρέφει τη γεωμετρία των γραμμών που σχεδιάζεις σε παγκόσμιο χάρτη για να δεις ποιες γεωγραφικές μήκες ενεργοποιούν ποια πλανητική ενέργεια.
Αστροκαρτογραφία API
Από την ημερομηνία γέννησης, την ώρα, τη διαφορά UTC και τις συντεταγμένες γέννησης, το endpoint καθορίζει τον ακριβή ουρανό για εκείνη τη στιγμή, μετά σαρώνει τη γη για να βρει κάθε μεσημβρινό και καμπύλη όπου ένας πλανήτης βρισκόταν σε μία από τις τέσσερις γωνίες. Για κάθε έναν από τους δέκα πλανήτες συν τους κόμβους, σχεδιάζει τέσσερις οικογένειες γραμμών: τη γραμμή ανόδου όπου το σώμα ήταν στον Ascendant, τη γραμμή δύσης στον Descendant, τη γραμμή κορύφωσης στον Midheaven και τη γραμμή anti-culminating στον Imum Coeli. Οι γραμμές MC και IC τρέχουν ως καθαρά μεσημβρία, οι γραμμές AC και DC λυγίζουν ανάλογα με το γεωγραφικό πλάτος, επειδή ένα σώμα που ανατέλλει ακριβώς ανατολικά σε ένα πλάτος ανατέλλει πολύ πιο βόρεια ή νότια σε άλλο. Όλα επιστρέφονται ως σειριοποιήσιμη γεωμετρία γραμμών στο data.lines, έτοιμα να τροφοδοτηθούν απευθείας σε βιβλιοθήκη χαρτογράφησης. Αυτή είναι η τεχνική μετατόπισης που δημοφιλής από τον Jim Lewis ως Astro*Carto*Graphy.
POST/v1/astrocartography
curl -X POST https://api.astroway.info/v1/astrocartography \
-H "X-Api-Key: aw_live_..." \
-H "Content-Type: application/json" \
-d '{
"date": "1990-05-15",
"time": "14:30:00",
"timezoneOffset": 3,
"latitude": 50.45,
"longitude": 30.52
}' {
"ok": true,
"data": {
"lines": [
{
"planet": "Venus",
"type": "MC",
"longitude": 14.2
},
{
"planet": "Jupiter",
"type": "AC",
"points": [
"…"
]
}
]
}
} 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) | yes | UTC offset in effect at the birth moment (e.g. 3 for Kyiv summer time). Decimal allowed for half-hour zones. |
| latitude | number | yes | Birth-place latitude, decimal degrees (north positive). |
| longitude | number | yes | Birth-place longitude, decimal degrees (east positive). |
When to use it
Χρησιμοποίησε αυτό το endpoint όταν η τοποθεσία είναι η μεταβλητή και θέλεις να ξέρεις πώς ένας χάρτης επαναδιατυπώνεται στον χάρτη – για συμβουλές μετακόμισης, ταξίδια και εργαλεία επιλογής κατοικίας, ή οποιαδήποτε λειτουργία που τοποθετεί το χάρτη ενός ατόμου πάνω σε σφαίρα. Είναι το φυσικό backend για έναν διαδραστικό χάρτη: ζήτησε τις γραμμές μία φορά για τη στιγμή γέννησης, απόδωσε τις ως πολυγραμμές, και άφησε τον χρήστη να περιηγηθεί στις ηπείρους για να διαβάσει ποιος πλανήτης κυβερνά ποιο διάδρομο. Επειδή η έξοδος είναι καθαρά γεωμετρία και όχι κείμενο, ενσωματώνεται άψογα με το δικό σου front-end styling, clustering και επίπεδα click-to-interpret. Συνδύασε το με την κλήση natal-chart όταν θέλεις τόσο τη δομή του αρχικού χάρτη όσο και τις μετατοπισμένες γραμμές πλάι-πλάι· τα δύο μοιράζονται την ίδια ανάλυση γέννησης, έτσι οι πλανητικές θέσεις πίσω από το χάρτη συμφωνούν ακριβώς.
Notes
Οι θέσεις προέρχονται από το Swiss Ephemeris (Astrodienst), την ίδια μηχανή πίσω από τα natal endpoints, έτσι οι γραμμές αγκυροβολούν στις ίδιες πλανητικές γεωγραφικές μήκες. Η γωνιότητα υπολογίζεται στον τροπικό ζώδιο. Η απάντηση περιέχει μόνο γεωμετρία – το σκάρισμα, η προβολή και το styling του παγκόσμιου χάρτη αφήνονται στον πελάτη σου.
Try the Αστροκαρτογραφία API
Grab a key and make your first call in under a minute.