API di carta equivalente geodetica

Data una latitudine e una longitudine, l'endpoint restituisce il Medium Coeli geodetico, Imum Coeli, Ascendente e Discendente in gradi eclittici, insieme all'indice del segno e al grado all'interno del segno per il MC e l'Ascendente. Sono supportate due scuole. Sepharial, la predefinita, mappa la longitudine terrestre direttamente sulla longitudine zodiacale, quindi 30.52 gradi est è 0 gradi 31 minuti del Toro. Johndro applica una correzione di obliquità, che sposta l'Ascendente rispetto al valore di Sepharial e richiede either un anno o un'obliquità esplicita in gradi. Poiché nulla di una persona entra nel calcolo, le stesse coordinate restituiscono sempre gli stessi angoli, il che rende l'endpoint economico da memorizzare nella cache e l'ancora naturale per una funzione basata sul luogo piuttosto che sulla persona.

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"
  }
}

Ricorri alla carta geodetica nel lavoro mondano, dove il soggetto è un paese, una città o un evento piuttosto che una persona. Gli usi tipici sono verificare se un'eclissi o un ingresso cade sugli angoli geodetici di una capitale, costruire una pagina di profilo di un paese che ha bisogno di una carta ma non ha un tempo di fondazione difendibile, e controllare incrociatamente l'astrocartografia con un metodo completamente indipendente. Risolve anche un problema pratico nei prodotti per consumatori: quando un utente non ha un'ora di nascita, la maggior parte degli endpoint delle carte si degrava gravemente, ma una carta geodetica per la sua città attuale è ancora pienamente definita e dice ancora qualcosa di specifico sul luogo. La risposta è piccola e deterministica, quindi costa una singola chiamata di primo livello ed è sicura da calcolare per un'intera lista di città in un'unica passata.

Sepharial e Johndro discordano per design, non per errore; entrambi vengono restituiti su richiesta anziché uno presentato come canonico. La tecnica ha origine con Sepharial all'inizio del XX secolo ed è stata estesa da L. Edward Johndro. Poiché il sistema geodetico è fissato al meridiano di Greenwich, i risultati sono stabili nel tempo e non richiedono alcuna ricerca di ephemeris, per cui questo è l'unico endpoint della famiglia astro-geografica che non dipende dall'Ephemeris Svizzera.