# Relocation API: астрокартографія, парани, локальний простір

Релокаційна астрологія відповідає на питання «де», а не «коли». AstroWay віддає і **геометрію** (лінії, перетини, азимути, кути), і **сенс** (яка лінія за що відповідає та що вона означає) окремими викликами, тож ви самі вирішуєте, який шар вам потрібен.

## Два шари

**Геометрія.** Один момент народження проєктується на всю планету: `/v1/acg` віддає 67 ліній (4 кути × 13 тіл, до 361 точки на лінію), `/v1/parans` віддає понад 400 точок, де дві планети були кутовими одночасно, `/v1/local-space` віддає азимут і висоту кожної планети від місця народження як шляхи великих кіл.

**Сенс.** `/v1/acg/by-category` бере сферу життя й повертає лінії, які нею керують, відранжовані за вагою та (якщо передати точку) за близькістю до неї, з текстом інтерпретації. Текст кураторський, з бази знань, а не з мовної моделі: той самий запит завтра дасть ті самі слова.

## Ендпоінти

| Ендпоінт | Метод | Кредити | Призначення |
|---|---|---|---|
| `/v1/acg/categories` | GET | 0 | Таксономія з 19 сфер життя: які лінії за що відповідають, вага 1-3, полярність |
| `/v1/acg` | POST | Tier 3 | Лінії A*C*G для всіх тіл (аліас `/v1/astrocartography`) |
| `/v1/acg/by-category` | POST | Tier 3 | Лінії однієї сфери життя, ранжовані, з інтерпретацією |
| `/v1/acg/line-report` | POST | Tier 2 | Одна лінія повністю: геометрія, всі сфери, текст |
| `/v1/acg-zones` | POST | Tier 3 | Які лінії проходять біля заданої точки та на якій відстані |
| `/v1/parans` | POST | Tier 3 | Перетини ліній двох планет із координатами |
| `/v1/local-space` | POST | Tier 3 | Азимут, висота й шлях великого кола для кожної планети |
| `/v1/local-space/influence-zone` | POST | Tier 3 | Полігон конуса впливу навколо одного азимута |
| `/v1/relocation` | POST | Tier 3 | Релокаційна карта: ті самі планети, перераховані доми й кути |
| `/v1/geodetic` | POST | Tier 1 | Геодезичні кути з самих координат, без часу народження |
| `/v1/solar-acg` | POST | Tier 4 | Астрокартографія соляра заданого року |

## 19 сфер життя

`career` · `success` · `power` · `money` · `wealth` · `love` · `relationship` · `home` · `stability` · `retreat` · `health` · `vitality` · `communication` · `creativity` · `learning` · `spirituality` · `transformation` · `travel` · `adventure`.

Кожна сфера називає свої лінії планета-кут із вагою від 1 до 3 і полярністю. **Складні лінії повертаються поруч зі сприятливими**: інструмент, що показує лише хороше, спотворює техніку. Потрібні лише одні? Фільтруйте через `polarity`.

## Приклад: ранжувати міста під кар'єру

```bash
curl -X POST https://api.astroway.info/v1/acg/by-category \
  -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,
        "category": "career", "point": { "lat": 51.5074, "lng": -0.1278 },
        "radiusDeg": 8, "includeCoordinates": false, "language": "en" }'
# → lines[] із weight, polarity, distanceDeg, strength та interpretation
```

Виконайте той самий виклик по одній точці на місто-кандидат і відсортуйте за `strength`: це вага лінії, помножена на близькість. `includeCoordinates: false` прибирає геометрію, коли потрібен лише рейтинг.

## Мови

`language` приймає будь-який з активних кодів. Кураторська база знань покриває всі 40 сполучень планета-кут одинадцятьма мовами (uk, en, de, es, fr, hi, it, ko, pl, pt і далі); коли перекладу немає, відповідь відкочується на en, а потім на uk, і реально віддана мова повертається в полі `lang` кожної інтерпретації.

<Aside type="note">
Таксономія покриває десять традиційних тіл. Хірон, Ліліт і вузли є в геометрії `/v1/acg`, але свідомо лишені поза зіставленням зі сферами життя: техніка у визначенні Джима Льюїса не надає їм кутового керування.
</Aside>

Технічні сторінки з прикладами: [Астрокартографія](/astrology-api/astrocartography/) · [Інтерпретації](/astrology-api/astrocartography-interpretations/) · [Парани](/astrology-api/parans/) · [Локальний простір](/astrology-api/local-space/) · [Релокаційна карта](/astrology-api/relocated-chart/) · [Геодезична карта](/astrology-api/geodetic-chart/) · [Астрокартографія соляра](/astrology-api/solar-return-astrocartography/)