# API геодезичної карти

Геодезична карта виводить чотири кути з самої лише географії. Нуль градусів Овна закріплено за Ґрінвіцьким меридіаном, кожен градус довготи стає градусом зодіаку, і будь-яке місце на Землі отримує Середину неба та Асцендент без жодної участі часу народження.

## Ендпоінт

`POST /v1/geodetic`

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

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

За широтою й довготою ендпоінт повертає геодезичні Середину неба, Глибину неба, Асцендент і Десцендент в екліптичних градусах разом з індексом знака та градусом усередині знака для MC та Асцендента. Підтримано дві школи. Sepharial, за замовчуванням, переводить земну довготу прямо в зодіакальну, тож 30,52 градуса східної довготи це 0 градусів 31 хвилина Тельця. Johndro застосовує поправку на нахил екліптики, що зсуває Асцендент відносно значення Sepharial і потребує або року, або явного нахилу в градусах. Оскільки в розрахунок не входить нічого про людину, ті самі координати завжди повертають ті самі кути, тож ендпоінт дешево кешувати, і він є природним якорем для функції, зав'язаної на місце, а не на особу.

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

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

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

| Parameter | Type | Required | Description |
|---|---|---|---|
| `latitude` | number | yes | Place latitude, decimal degrees (north positive). |
| `longitude` | number | yes | Place longitude, decimal degrees (east positive). This is what drives the geodetic MC. |
| `method` | string | no | sepharial (default) maps longitude directly onto the zodiac; johndro applies an obliquity correction. |
| `year` | number | no | Year used for the obliquity value in the johndro method. Ignored by sepharial. |
| `obliquity` | number | no | Explicit obliquity in degrees, overriding the year-derived value. |

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

```bash
curl -X POST https://api.astroway.info/v1/geodetic \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
  "latitude": 50.45,
  "longitude": 30.52,
  "method": "sepharial"
}'
```

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

```json
{
  "ok": true,
  "data": {
    "mc": 30.52,
    "ic": 210.52,
    "asc": 317.7269,
    "dsc": 137.7269,
    "mcSign": 1,
    "mcDegree": 0.52,
    "ascSign": 10,
    "ascDegree": 17.7269,
    "method": "sepharial"
  }
}
```

## Нотатки

Sepharial і Johndro розходяться за задумом, а не через помилку; обидва доступні на запит, і жоден не подається як канонічний. Техніка походить від Sepharial початку двадцятого століття й була розширена Л. Едвардом Джондро. Оскільки геодезична рамка закріплена за Ґрінвіцьким меридіаном, результати стабільні в часі й не потребують звернення до ефемерид, тому це єдиний ендпоінт у сімействі астрогеографії, який не залежить від Swiss Ephemeris.

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

- https://api.astroway.info/astrology-api/astrocartography/
- https://api.astroway.info/astrology-api/relocated-chart/
- https://api.astroway.info/astrology-api/local-space/

---

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