API геодезичної карти
Геодезична карта виводить чотири кути з самої лише географії. Нуль градусів Овна закріплено за Ґрінвіцьким меридіаном, кожен градус довготи стає градусом зодіаку, і будь-яке місце на Землі отримує Середину неба та Асцендент без жодної участі часу народження.
API геодезичної карти
За широтою й довготою ендпоінт повертає геодезичні Середину неба, Глибину неба, Асцендент і Десцендент в екліптичних градусах разом з індексом знака та градусом усередині знака для MC та Асцендента. Підтримано дві школи. Sepharial, за замовчуванням, переводить земну довготу прямо в зодіакальну, тож 30,52 градуса східної довготи це 0 градусів 31 хвилина Тельця. Johndro застосовує поправку на нахил екліптики, що зсуває Асцендент відносно значення Sepharial і потребує або року, або явного нахилу в градусах. Оскільки в розрахунок не входить нічого про людину, ті самі координати завжди повертають ті самі кути, тож ендпоінт дешево кешувати, і він є природним якорем для функції, зав'язаної на місце, а не на особу.
POST/v1/geodetic
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"
}'{
"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"
}
}Параметри
| name | type | Обов’язк. | |
|---|---|---|---|
| latitude | number | так | Place latitude, decimal degrees (north positive). |
| longitude | number | так | Place longitude, decimal degrees (east positive). This is what drives the geodetic MC. |
| method | string | ні | sepharial (default) maps longitude directly onto the zodiac; johndro applies an obliquity correction. |
| year | number | ні | Year used for the obliquity value in the johndro method. Ignored by sepharial. |
| obliquity | number | ні | Explicit obliquity in degrees, overriding the year-derived value. |
Коли використовувати
Беріть геодезичну карту в мунданній роботі, де суб'єктом є країна, місто чи подія, а не людина. Типові застосування: перевірка, чи падає затемнення або інгресія на геодезичні кути столиці; сторінка-профіль країни, якій потрібна карта, але немає захищуваного часу заснування; перехресна звірка астрокартографії цілком незалежним методом. Він також розв'язує практичну проблему споживчих продуктів: коли в користувача немає часу народження, більшість карткових ендпоінтів деградують, а геодезична карта його теперішнього міста лишається повністю визначеною й далі каже щось конкретне про це місце. Відповідь мала й детермінована, тож коштує один виклик першого тарифу і її безпечно рахувати для цілого списку міст за один прохід.
Нотатки
Sepharial і Johndro розходяться за задумом, а не через помилку; обидва доступні на запит, і жоден не подається як канонічний. Техніка походить від Sepharial початку двадцятого століття й була розширена Л. Едвардом Джондро. Оскільки геодезична рамка закріплена за Ґрінвіцьким меридіаном, результати стабільні в часі й не потребують звернення до ефемерид, тому це єдиний ендпоінт у сімействі астрогеографії, який не залежить від Swiss Ephemeris.
Спробуйте Геодезична карта API
Отримайте ключ і зробіть перший виклик за хвилину.