API pentru hărți echivalente geodezice
O hartă geodezică derivă cele patru unghiuri exclusiv din geografie. Zero grade Berbec este fixat la meridianul Greenwich, fiecare grad de longitudine devine un grad din zodiac, iar orice loc de pe Pământ dobândește un Mediu Ceresc și un Ascendent fără ca ora nașterii să fie implicată deloc.
API pentru hărți echivalente geodezice
Dată o latitudine și o longitudine, endpoint-ul returnează Mediu Cerescul geodezic, Imum Coeli, Ascendentul și Descendentul în grade ecliptice, împreună cu indexul semnului și gradul din semn pentru MC și Ascendent. Sunt suportate două școli. Sepharial, opțiunea implicită, mapează longitudinea terestră direct pe longitudinea zodiacală, astfel încât 30.52 grade est sunt 0 grade 31 minute Taur. Johndro aplică o corecție de oblicitate, care deplasează Ascendentul față de valoarea Sepharial și necesită fie un an, fie o oblicitate explicită în grade. Deoarece nimic despre o persoană nu intră în calcul, aceleași coordonate returnează mereu aceleași unghiuri, ceea ce face ca endpoint-ul să ieftin de cache și să fie ancorarea naturală pentru o funcționalitate bazată pe locație, nu pe persoană.
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
Folosește harta geodezică în lucrările mundane, unde subiectul este o țară, un oraș sau un eveniment, nu o persoană. Utilizările tipice includ testarea dacă o eclipsă sau o intrare cade pe unghiurile geodezice ale unei capitale, construirea unei pagini de profil pentru o țară care are nevoie de o hartă dar nu are un timp de fondare apărabil, și verificarea încrucișată a astrocartografiei cu o metodă complet independentă. Rezolvă și o problemă practică în produsele pentru consumatori: când un utilizator nu are ora nașterii, majoritatea endpoint-urilor de hărți se degradează grav, dar o hartă geodezică pentru orașul lor actual este încă complet definită și spune ceva specific despre loc. Răspunsul este mic și determinist, așa că costă un singur apel de prim nivel și este sigur de calculat pentru o listă întreagă de orașe într-o singură trecere.
Notes
Sepharial și Johndro nu sunt de acord din design, nu din eroare; ambele sunt returnate la cerere, nu una prezentată ca fiind canonică. Tehnica provine de la Sepharial la începutul secolului XX și a fost extinsă de L. Edward Johndro. Deoarece cadrul geodezic este fixat la meridianul Greenwich, rezultatele sunt stabile în timp și nu necesită căutări în efeemeride, motiv pentru care acesta este singurul endpoint din familia astro-geografică care nu depinde de Swiss Ephemeris.
Try the Hartă Geodezică API
Grab a key and make your first call in under a minute.