API diagram ekuivalen geodetik
Diagram geodetik menghasilkan empat sudut hanya dari geografi. Nol derajat Aries dipatok ke meridian Greenwich, setiap derajat bujur menjadi satu derajat zodiak, dan setiap tempat di Bumi mendapatkan Midheaven dan Ascendant tanpa melibatkan waktu lahir sama sekali.
API diagram ekuivalen geodetik
Dengan latitude dan longitude, endpoint mengembalikan Midheaven, Imum Coeli, Ascendant, dan Descendant geodetik dalam derajat ekliptik, beserta indeks tanda dan derajat dalam tanda untuk MC dan Ascendant. Dua aliran didukung. Sepharial (default) memetakan longitude terestrial langsung ke longitude zodiak, jadi 30.52 derajat timur menjadi 0 derajat 31 menit Taurus. Johndro menerapkan koreksi obliquitas, yang menggeser Ascendant relatif ke nilai Sepharial dan memerlukan tahun atau obliquitas eksplisit dalam derajat. Karena tidak ada data orang yang masuk ke perhitungan, koordinat yang sama selalu menghasilkan sudut yang sama, sehingga endpoint mudah di-cache dan menjadi jangkar alami untuk fitur berbasis tempat, bukan berbasis orang.
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"
}
} Parameters
| name | type | Required | |
|---|---|---|---|
| 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. |
When to use it
Gunakan diagram geodetik dalam pekerjaan biasa, di mana subjeknya negara, kota, atau peristiwa bukan orang. Penggunaan umum: menguji apakah gerhana atau ingress jatuh pada sudut geodetik ibu kota, membuat halaman profil negara yang butuh diagram tapi tidak punya waktu pendirian yang dapat dipertahankan, dan memeriksa silang astrocartography dengan metode yang sepenuhnya independen. Ini juga menyelesaikan masalah praktis di produk konsumen: ketika pengguna tidak punya waktu lahir, kebanyakan endpoint diagram menjadi buruk, tapi diagram geodetik untuk kota mereka tetap terdefinisi penuh dan memberi info spesifik tentang tempat itu. Responsnya kecil dan deterministik, jadi hanya memerlukan satu panggilan tier-one dan aman dihitung untuk seluruh daftar kota sekaligus.
Notes
Sepharial dan Johndro tidak setuju karena desain, bukan karena kesalahan; keduanya dikembalikan bila diminta, bukan satu yang dijadikan kanonik. Teknik ini berasal dari Sepharial pada awal abad dua puluh dan dikembangkan oleh L. Edward Johndro. Karena kerangka geodetik dipatok ke meridian Greenwich, hasilnya stabil seiring waktu dan tidak memerlukan pencarian ephemeris, itulah mengapa ini satu-satunya endpoint dalam keluarga astro-geography yang tidak bergantung pada Swiss Ephemeris.
Try the Diagram Geodetik API
Grab a key and make your first call in under a minute.