Astrocartography API
Astrocartography mengambil satu momen kelahiran dan memproyeksikannya ke seluruh planet: alih-alih menanyakan di mana planet berada di langit, ia menanyakan di mana di Bumi tiap planet berada secara angular. Endpoint mengembalikan line geometry yang kamu plot di world map untuk melihat longitude mana yang mengaktifkan planetary energy.
Astrocartography API
Dari tanggal lahir, waktu jam, offset UTC, dan koordinat lahir, endpoint menetapkan langit tepat pada saat itu, lalu menyapu globe untuk menemukan setiap meridian dan kurva dimana planet berada pada salah satu dari empat sudut. Untuk masing-masing dari sepuluh planet plus node, ia menelusuri empat keluarga line: rising line dimana benda berada di Ascendant, setting line di Descendant, culminating line di Midheaven, dan anti-culminating line di Imum Coeli. Garis MC dan IC berjalan sebagai meridian bersih; garis AC dan DC melengkung tergantung lintang, karena benda yang terbit tepat timur di satu lintang terbit jauh ke utara atau selatan di lintang lain. Semua dikembalikan sebagai serialisable line geometry di data.lines, siap langsung dimasukkan ke mapping library. Ini teknik relokasi yang dipopulerkan Jim Lewis sebagai 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
Gunakan endpoint ini ketika lokasi menjadi variabel dan kamu ingin tahu bagaimana chart mengekspresikan diri di seluruh peta - untuk saran relokasi, travel, dan alat cari tempat tinggal, atau fitur apa pun yang menimpa chart seseorang di globe. Ini backend alami untuk interactive map: request garis sekali untuk momen kelahiran, render mereka sebagai polylines, dan biarkan user pan melintasi benua untuk membaca planet mana yang menguasai koridor mana. Karena outputnya pure geometry bukan prose, ia mudah digabungkan dengan styling front-end kamu, clustering, dan click-to-interpret layers. Padukan dengan panggilan natal-chart ketika kamu ingin struktur home-chart dan relocated lines berdampingan; keduanya berbagi resolusi kelahiran yang sama, jadi posisi planet di balik peta cocok persis.
Notes
Posisi diambil dari Swiss Ephemeris (Astrodienst), mesin yang sama di belakang endpoint natal, jadi lines terikat pada identical planetary longitudes. Angularity dihitung dalam tropical zodiac. Respons hanya membawa geometry - drawing, projection, dan styling world map diserahkan ke client kamu.
Try the Astrocartography API
Grab a key and make your first call in under a minute.