API астрокартографії соляра
Натальна астрокартографія відповідає, де карта працює. Астрокартографія соляра відповідає, де вона працює цього року. Ендпоінт обчислює точний момент, коли Сонце повертається до своєї натальної довготи у вказаному році, і наносить цю карту на глобус як власний набір кутових ліній.
API астрокартографії соляра
Ендпоінт спершу будує натальну карту, потім шукає в заданому році мить, коли транзитне Сонце досягає натальної сонячної довготи, з точністю значно меншою за кутову секунду. Він обчислює позиції планет для цієї миті й простежує чотири родини кутових ліній по всьому світу так само, як натальний ендпоінт астрокартографії, повертаючи шістдесят три лінії. Кожна назва планети несе суфікс SR, тож клієнт, що рендерить обидві мапи одночасно, не сплутає натальну лінію Юпітера з солярною. Лінії повертаються парами координат у тій самій формі, що й у /acg, тож наявному рендереру не потрібно нічого, крім стилю для другого шару.
POST/v1/solar-acg
curl -X POST https://api.astroway.info/v1/solar-acg \
-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,
"year": 2026
}' {
"ok": true,
"data": {
"year": 2026,
"lines": [
{
"planet": "Sun (SR)",
"planetId": 0,
"type": "MC",
"coordinates": [[-85, 110.4845], [-84.5, 110.4845], "…"]
}
]
}
} Параметри
| name | type | Обов’язк. | |
|---|---|---|---|
| date | string (YYYY-MM-DD) | так | Birth date. |
| time | string (HH:MM:SS) | так | Local clock time at birth. |
| timezoneOffset | number (hours) | так | UTC offset in effect at the birth moment. |
| latitude | number | так | Birth-place latitude, decimal degrees. |
| longitude | number | так | Birth-place longitude, decimal degrees. |
| year | number | так | Calendar year of the solar return whose map you want. |
Коли використовувати
Це ендпоінт, що стоїть за найкомерційнішим питанням релокаційної астрології: де провести день народження і де базуватися цього року. Солярну карту традиційно будують на місце, де людина фізично перебуває в момент повернення, тож локація стає рішенням, а не даністю, і саме ця мапа перетворює рішення на те, що користувач може побачити. Будуйте річний релокаційний звіт, рекомендатор поїздки на день народження або річний шар поверх наявної астрокартографічної мапи. Оскільки момент повернення щороку інший, результат природно придатний до повторного продажу, а не є разовим розрахунком, і він прямо поєднується з /solar-return, коли користувач хоче ще й саму карту.
Нотатки
Позиції беруться зі Swiss Ephemeris (Astrodienst), скомпільованого у WASM. Момент повернення розв'язується відносно натальної сонячної довготи в тропічному зодіаку; сидеричні соляри це інша техніка, і цей ендпоінт її не рахує. Мапа будується лише з солярної карти, тож на цей рік вона є повною заміною натальних ліній, а не їхньою модифікацією. Деякі школи будують соляр на місце народження, а не на теперішнє; цей вибір належить вашому шару інтерпретації, бо геометрія ліній в обох випадках однакова.
Спробуйте Астрокартографія соляра API
Отримайте ключ і зробіть перший виклик за хвилину.