API Arah Gerak Matahari
Arah gerak matahari memindahkan seluruh carta maju satu angka: jarak yang ditempuh Matahari oleh progresi sekunder. Setiap planet, setiap kuspis dan kedua sudut bergeser dengan busur yang sama, sehingga aspek natal yang dua derajat dari tepat menjadi tepat sekitar dua tahun kemudian. Endpoint ini mengembalikan carta yang diarahkan dan busur yang menghasilkannya.
API Arah Gerak Matahari
Dari data kelahiran dan tanggal target, endpoint pertama-tama memprogresikan carta hari-per-tahun, mengukur seberapa jauh Matahari yang telah bergerak dari posisi natalnya, dan mengambil jarak itu sebagai busur. Kemudian ia menambahkan busur ke setiap bujur natal sekaligus: semua planet, semua kuspis rumah, ascendant dan MC. Respon membawa posisi yang diarahkan di bawah data.planets dan data.houses, busur itu sendiri dalam derajat di bawah data.arc, dan kunci yang menghasilkannya di bawah data.key. Karena satu busur diterapkan secara seragam, geometri carta natal dipertahankan dan hanya hubungannya dengan derajat natal yang berubah, yang membuat teknik ini sangat ekonomis untuk dibaca: satu angka memberi tahu Anda keadaan seluruh carta pada usia tertentu. Dua kunci lain tersedia di endpoint yang sama. Atur kunci ke naibod untuk laju rata-rata matahari 59'08.3" per tahun, atau abaikan untuk satu derajat per tahun biasa. Mengirim converse true mengarahkan mundur dari momen kelahiran bukan maju, membalik tanda busur.
POST/v1/symbolic-directions
curl -X POST https://api.astroway.info/v1/symbolic-directions \
-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,
"targetDate": "2026-05-15",
"key": "solar_arc"
}' {
"ok": true,
"data": {
"arc": 34.5083,
"key": "solar_arc",
"planets": [
{
"id": 0,
"name": "Sun",
"longitude": 88.8843,
"isRetrograde": false
}
],
"houses": {
"system": "P",
"ascendant": 204.4763,
"mc": 111.5826
}
}
} 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. 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). |
| targetDate | string (YYYY-MM-DD) | yes | The date the chart is directed to. |
| key | string | no | Directional key: solar_arc (the arc of the progressed Sun), naibod (59'08.3" per year), or one_degree (the default, 1° per year). |
| converse | boolean | no | Direct backwards from the birth moment instead of forwards. Reverses the sign of the arc. |
When to use it
Gunakan arah gerak matahari ketika Anda memerlukan timing yang simbolis daripada astronomis, dan ketika Anda menginginkannya dalam bentuk yang pembaca bisa ikuti. Karena semua bergerak pada satu laju, kontak yang diarahkan mendarat pada tahun tertentu bukan jendela waktu, yang cocok untuk fitur garis waktu hidup, laporan tonggak usia, atau narasi AI yang harus menjelaskan apa tentang tahun tertentu. Ini berpasangan secara alami dengan progresi sekunder, karena busur berasal dari Matahari yang sama yang diprogresikan: progresi memberi Anda carta dalam bergerak, arah gerak matahari memberi Anda seluruh carta yang diterjemahkan maju. Bandingkan ketiga kunci ketika presisi penting bagi audiens Anda. Arah gerak matahari mengikuti Matahari sebenarnya dan bervariasi sedikit menurut tanggal kelahiran, Naibod menggunakan laju rata-rata, dan satu derajat per tahun adalah konvensi bilangan bulat. Untuk kelahiran pertengahan Mei, ketiganya menghasilkan sekitar 34.5, 35.5 dan 36.0 derajat selama 36 tahun, cukup dekat untuk setuju pada dekade dan cukup jauh untuk menamai tahun yang berbeda.
Notes
Busur adalah jarak yang ditempuh oleh Matahari yang diprogresikan secara sekunder, hari per tahun, yang merupakan definisi standar; kunci Naibod menggunakan gerakan harian rata-rata Matahari, 59'08.3" per tahun. Untuk arah gerak matahari, carta yang diprogresikan dihitung maju dan arah perjalanan diterapkan sekali, sehingga arah sebaliknya mengembalikan busur yang dinotasikan bukan digandakan. Posisi berasal dari mesin Swiss Ephemeris di zodiak tropis, pada badan dan sistem rumah yang sama dengan endpoint natal.
Try the Arah Gerak Matahari API
Grab a key and make your first call in under a minute.