# Релокаційний звіт у PDF

До п'яти місць, порівняних для однієї карти народження, багатосторінковим PDF, який клієнт залишає собі. Для кожного місця: релокаційні кути зі зсувом від народження, перелік планет, що змінили дім, кожна астрокартографічна лінія в межах 300 км із тлумаченням, і підтримувальні та напружені бали по дев'ятнадцяти сферах життя.

## Ендпоінт

`POST /v1/reports/relocation`

- Operation ID: `reports-relocation`
- Вартість: 5000 кредитів (тариф 7)
- Типова латентність: 6100 мс, заміряно на проді
- Канонічна сторінка: https://api.astroway.info/astrology-api/relocation-report/

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

Релокаційна карта це те саме небо, побачене з іншого місця, тож кожна планета лишається на тому градусі зодіаку, який мала при народженні, і перераховуються тільки доми та кути. Звіт каже це першим, а далі показує наслідок: асцендент і середину неба зі знаковим зсувом і список планет, які справді змінили дім, зведений різницею, а не двома таблицями, які читач мав би звіряти сам. Відстань до кожної кутової лінії рахується з часового кута й висоти світила, а не по намальованій полілінії, і тому вона точна. Бали сфер життя беруть ті самі ваги й полярності, що й ендпоінт за категоріями, і кожен підсумок друкується поруч із відсотком від того максимуму, який ця сфера взагалі може дати, бо сире число власної шкали не має.

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

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

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

| Parameter | Type | Required | Description |
|---|---|---|---|
| `chart` | object | yes | The birth chart. Coordinates are required, as everywhere on /v1. |
| `locations` | object[] | yes | One to five places, each with latitude, longitude and an optional name. Coordinates are required per place and never defaulted. |
| `categories` | string[] | no | Which of the 19 life areas to score. Omit for all of them. The list is at GET /v1/acg/categories. |
| `orbKm` | number | no | How far a line reaches when scoring the categories. Default 1126, the 700 miles Jim Lewis used. It does not affect the angular-line section, which is fixed at 300 km. |
| `language` | string | no | One of the 21 report locales. Defaults to uk. |
| `whitelabel` | boolean | no | Apply the caller's stored branding to the document. |
| `format` | "html" (query) | no | Add ?format=html to stream the document instead of rendering a PDF. |

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

```bash
curl -X POST https://api.astroway.info/v1/reports/relocation \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
  "chart": {
    "date": "1990-05-15",
    "time": "14:30:00",
    "timezoneOffset": 3,
    "latitude": 50.45,
    "longitude": 30.52
  },
  "locations": [
    { "name": "Lisbon", "latitude": 38.7223, "longitude": -9.1393 },
    { "name": "Vancouver", "latitude": 49.2827, "longitude": -123.1207 }
  ],
  "categories": ["career", "love"],
  "language": "en"
}'
```

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

```json
{
  "ok": true,
  "data": {
    "url": "https://api.astroway.info/reports/abc-relocation.pdf",
    "storage_key": "reports/abc-relocation.pdf",
    "byte_length": 190518,
    "page_count": 6,
    "duration_ms": 3435,
    "expires_at": "2026-08-14T21:19:34.527Z"
  }
}
```

## Нотатки

Ані AI-розповіді, ані колеса карти, і те й те свідомо. Колесо релокаційної карти показує ті самі планети в повернутій рамці, що читається як друга карта, а саме це непорозуміння й покликаний зняти вступний розділ; а розповідь про місце була б порадою, де жити, чим цей звіт не є. Звіт упорядковує і пояснює. Якщо місце не набрало нічого позитивного в жодній із запитаних сфер, таблиця порівняння ставить прочерк, а не називає найменш погану сферу його сильною стороною. Координати обов'язкові для кожного місця: релокаційний звіт, збудований на 0N 0E, це впевнений документ про Гвінейську затоку, і, на відміну від неправильного поля в JSON, PDF залишається у клієнта.

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

- https://api.astroway.info/astrology-api/acg-best-places/
- https://api.astroway.info/astrology-api/relocated-chart/
- https://api.astroway.info/astrology-api/astrocartography/
- https://api.astroway.info/astrology-api/astrocartography-interpretations/

---

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