AstroWay/api v2.296.1 · id
semua sistem normal
// astrology api · POST /v1/geodetic

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.

Endpoint
POST /v1/geodetic
Cost
10 credits
Latency
~121 ms
Tier
Tier 1
// 01 / What it computes

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.

// 02 / Live request

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"
}'
Response (excerpt)
{
  "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"
  }
}
// 03 / Parameters

Parameters

nametypeRequired
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.
// 04 / When to use it

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.

// 05 / Notes

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.

99.9% SLA · paket berbayar · 30d status →