# API релокаційної карти

Лишіть планети, перенесіть карту. Релокаційна карта зберігає кожну натальну довготу планети точно такою, як при народженні, але перебудовує каркас домів — Асцендент, Середину неба, куспіди — для нового місця. Передайте натальні дані й цільове місце — отримаєте обидві карти плюс кутову різницю. Точність Swiss Ephemeris, відповідь у JSON.

## Ендпоінт

`POST /v1/relocation`

- Operation ID: `relocation`
- Вартість: 50 кредитів (тариф 3)
- Типова латентність: 62 мс, заміряно на проді
- Канонічна сторінка: https://api.astroway.info/astrology-api/relocated-chart/

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

Релокаційний ендпоінт обчислює натальну карту з переданих даних народження, а потім перебудовує каркас домів для другого місця, лишаючи позиції планет недоторканими. Планети зберігають свої вроджені знаки й градуси — вони є функцією моменту, а не місця — але Асцендент, Середина неба й усі куспіди домів перераховуються за цільовою широтою й довготою, що перепризначає кожну планету до нового дому. Відповідь повертає поряд і початкову натальну карту, і релокаційну, плюс об'єкт різниці, що повідомляє, наскільки змістилися кути: ascendantShift і mcShift. Ця різниця кількісно показує, наскільки сильно релокація змінює акценти карти — велике зміщення означає, що доми, а отже й сфери життя, які активує планета, суттєво змінюються, хоча самі планети не зрушили.

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

Використовуйте релокаційну карту для питань, суміжних з астрокартографією — «як читалася б моя карта, якби я жив у цьому місті», релокаційний звіт для того, хто розглядає переїзд, чи функція подорожей, що показує, які доми засвічуються в пункті призначення. Це природний вибір щоразу, коли місце має значення, а дані народження фіксовані: планетний склад лишається сталим, зсувається лише кутовий і домовий акцент. Повернення обох карт і кутової різниці в одній відповіді дозволяє одразу показати «до й після», а різниця полегшує позначення релокацій, що майже нічого не змінюють, проти тих, що зсувають Асцендент чи Середину неба на знак або більше. Подавайте релокаційні доми в інтерпретацію, щоб описати, як місце змінює відчутний акцент тієї самої наталки.

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

| Parameter | Type | Required | Description |
|---|---|---|---|
| `natal` | object | yes | Natal birth data as an object: date, time, timezoneOffset, latitude, longitude. |
| `target` | object | yes | Target relocation place as an object: latitude, longitude, and an optional city label. |

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

```bash
curl -X POST https://api.astroway.info/v1/relocation \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
  "natal": {
    "date": "1990-05-15",
    "time": "14:30:00",
    "timezoneOffset": 3,
    "latitude": 50.45,
    "longitude": 30.52
  },
  "target": {
    "latitude": 40.71,
    "longitude": -74.01,
    "city": "New York"
  }
}'
```

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

```json
{
  "ok": true,
  "data": {
    "natal": {
      "houses": {
        "ascendant": 160.4,
        "mc": 70.1
      }
    },
    "relocated": {
      "houses": {
        "ascendant": 243.8,
        "mc": 152.6
      }
    },
    "delta": {
      "ascendantShift": 83.4,
      "mcShift": 82.5
    }
  }
}
```

## Нотатки

Релокується лише каркас домів; довготи планет, знаки й міжпланетні аспекти ідентичні натальній карті, бо залежать від моменту народження, а не від місця. Відповідь несе обидві карти плюс різницю {ascendantShift, mcShift}, щоб виміряти кутове зміщення. Ціль приймає необов'язкову мітку міста для відображення. Доми за обраною системою; скрізь тропічний зодіак і Swiss Ephemeris.

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

- https://api.astroway.info/astrology-api/astrocartography/
- https://api.astroway.info/astrology-api/natal-chart/

---

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