AstroWay/api v2.173.1 · nl
alle systemen normaal
// astrology api · POST /v1/geodetic

Geodetische equivalent kaart API

Een geodetische kaart leidt de vier hoeken af uit de geografie alleen. Nul graden Ram is vastgepind aan de meridiaan van Greenwich, elke graad lengtegraad wordt een graad van de dierenriem, en elke plek op Aarde verkrijgt een Middenhemel en een Ascendant zonder dat een geboortetijd betrokken is.

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

Geodetische equivalent kaart API

Gegeven een breedtegraad en lengtegraad retourneert de endpoint de geodetische Middenhemel, Imum Coeli, Ascendant en Descendant in ecliptische graden, samen met het tekenindex en de graad binnen het teken voor de MC en de Ascendant. Er worden twee scholen ondersteund. Sepharial, de standaard, kaartstelt aardse lengtegraad rechtstreeks af op dierenriemlengtegraad, dus 30,52 graden oost is 0 graden 31 minuten van Stier. Johndro past een obliquiteitscorrectie toe, wat de Ascendant verschuift ten opzichte van de Sepharial-waarde en vereist een jaar of een expliciete obliquiteit in graden. Omdat niets van een persoon in de berekening wordt betrokken, geven dezelfde coördinaten altijd dezelfde hoeken terug, wat de endpoint goedkoop om te cachen maakt en de natuurlijke anker voor een op plaats gebaseerde in plaats van op persoon gebaseerde functie.

// 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

Grijp naar de geodetische kaart in wereldlijke werk, waar het onderwerp een land, een stad of een gebeurtenis is in plaats van een persoon. Typische toepassingen zijn het testen of een zonsverduistering of een ingebruikname valt op de geodetische hoeken van een hoofdstad, het bouwen van een landprofielpagina die een kaart nodig heeft maar geen verdedigbare oprichtingstijd heeft, en het controleren van astrocartografie met een volledig onafhankelijke methode. Het lost ook een praktisch probleem op in consumentenproducten: wanneer een gebruiker geen geboortetijd heeft, degraderen de meeste kaartendpoints ernstig, maar een geodetische kaart voor hun huidige stad is nog steeds volledig gedefinieerd en zegt nog steeds iets specifieks over de plaats. Het antwoord is klein en deterministisch, dus het kost één tier-one aanroep en is veilig om te berekenen voor een hele lijst steden in één keer.

// 05 / Notes

Notes

Sepharial en Johndro verschillen opzettelijk van mening, niet door een fout; beide worden op verzoek geretourneerd in plaats van dat er één als canoniek wordt gepresenteerd. De techniek is afkomstig van Sepharial in het begin van de twintigste eeuw en is uitgebreid door L. Edward Johndro. Omdat het geodetische raamwerk is vastgezet aan de meridiaan van Greenwich, zijn de resultaten stabiel in de tijd en vereisen geen ephemeris-opzoekopdracht, wat de reden is dat dit de enige endpoint in de astro-geografie familie is die niet afhankelijk is van Swiss Ephemeris.

Try the Geodetische Kaart API

Grab a key and make your first call in under a minute.

99.9% SLA · betaalde plannen · 30d status →