AstroWay/api v2.105.4 · astrology-api
усі системи в нормі
// astrology api · POST /v1/solar-acg

API астрокартографії соляра

Натальна астрокартографія відповідає, де карта працює. Астрокартографія соляра відповідає, де вона працює цього року. Ендпоінт обчислює точний момент, коли Сонце повертається до своєї натальної довготи у вказаному році, і наносить цю карту на глобус як власний набір кутових ліній.

Ендпоінт
POST /v1/solar-acg
Вартість
100 кредитів
Латентність
~346 ms
Тариф
Tier 4
// 01 / Що обчислює

API астрокартографії соляра

Ендпоінт спершу будує натальну карту, потім шукає в заданому році мить, коли транзитне Сонце досягає натальної сонячної довготи, з точністю значно меншою за кутову секунду. Він обчислює позиції планет для цієї миті й простежує чотири родини кутових ліній по всьому світу так само, як натальний ендпоінт астрокартографії, повертаючи шістдесят три лінії. Кожна назва планети несе суфікс SR, тож клієнт, що рендерить обидві мапи одночасно, не сплутає натальну лінію Юпітера з солярною. Лінії повертаються парами координат у тій самій формі, що й у /acg, тож наявному рендереру не потрібно нічого, крім стилю для другого шару.

// 02 / Живий запит

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], "…"]
      }
    ]
  }
}
// 03 / Параметри

Параметри

nametypeОбов’язк.
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.
// 04 / Коли використовувати

Коли використовувати

Це ендпоінт, що стоїть за найкомерційнішим питанням релокаційної астрології: де провести день народження і де базуватися цього року. Солярну карту традиційно будують на місце, де людина фізично перебуває в момент повернення, тож локація стає рішенням, а не даністю, і саме ця мапа перетворює рішення на те, що користувач може побачити. Будуйте річний релокаційний звіт, рекомендатор поїздки на день народження або річний шар поверх наявної астрокартографічної мапи. Оскільки момент повернення щороку інший, результат природно придатний до повторного продажу, а не є разовим розрахунком, і він прямо поєднується з /solar-return, коли користувач хоче ще й саму карту.

// 05 / Нотатки

Нотатки

Позиції беруться зі Swiss Ephemeris (Astrodienst), скомпільованого у WASM. Момент повернення розв'язується відносно натальної сонячної довготи в тропічному зодіаку; сидеричні соляри це інша техніка, і цей ендпоінт її не рахує. Мапа будується лише з солярної карти, тож на цей рік вона є повною заміною натальних ліній, а не їхньою модифікацією. Деякі школи будують соляр на місце народження, а не на теперішнє; цей вибір належить вашому шару інтерпретації, бо геометрія ліній в обох випадках однакова.

Спробуйте Астрокартографія соляра API

Отримайте ключ і зробіть перший виклик за хвилину.

99.9% SLA · платні плани · 30d status →