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

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

## Ендпоінт

`POST /v1/solar-acg`

- Operation ID: `solar-acg`
- Вартість: 100 кредитів (тариф 4)
- Типова латентність: 346 мс, заміряно на проді
- Канонічна сторінка: https://api.astroway.info/astrology-api/solar-return-astrocartography/

## Що обчислює

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

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

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

## Параметри запиту

| Parameter | Type | Required | Description |
|---|---|---|---|
| `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. |
| `latitude` | number | yes | Birth-place latitude, decimal degrees. |
| `longitude` | number | yes | Birth-place longitude, decimal degrees. |
| `year` | number | yes | Calendar year of the solar return whose map you want. |

## Приклад запиту

```bash
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
}'
```

## Приклад відповіді

```json
{
  "ok": true,
  "data": {
    "year": 2026,
    "lines": [
      {
        "planet": "Sun (SR)",
        "planetId": 0,
        "type": "MC",
        "coordinates": [[-85, 110.4845], [-84.5, 110.4845], "…"]
      }
    ]
  }
}
```

## Нотатки

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

## Пов’язані техніки

- https://api.astroway.info/astrology-api/astrocartography/
- https://api.astroway.info/astrology-api/solar-return/
- https://api.astroway.info/astrology-api/parans/

---

Повна машиночитана специфікація: https://api.astroway.info/v1/openapi.json
Інструкції для агента: https://api.astroway.info/AGENTS.md