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

Parans API

Een paran is het punt waar twee astrocartografische lijnen elkaar kruisen: een plek waar twee planeten tegelijkertijd hoekig waren. Deze endpoint geeft elke kruising voor een geboortemoment terug, met de coördinaten van elke, zodat je de kaartpunten kunt markeren waar twee planetaire thema's samensmelten in plaats van naast elkaar te lopen.

Endpoint
POST /v1/parans
Cost
50 credits
Latency
~297 ms
Tier
Tier 3
// 01 / What it computes

Parans API

De endpoint lost het geboortemoment op naar een juliaanse dag, berekent de volledige astrocartografische set (vier hoeklijnen per lichaam), en snijdt vervolgens elke lijn met elke lijn die bij een andere planeet hoort. Elke kruising wordt teruggegeven met beide moederplaneten, beide lijntypes, en de breedtegraad en lengtegraad waar de kruising valt. Omdat MC- en IC-lijnen meridianen zijn en AC- en DC-lijnen breedtegraafafhankelijke krommen zijn, zijn de meeste kruisingen geometrisch in plaats van symmetrisch: een Zon-MC en Maan-ASC paar komt precies op één plek per halfrond samen, niet op een gedeelde band. Een typische kaart geeft ergens over vierhonderd kruisingen wereldwijd, wat is waarom ze als een platte, sorteerbare lijst worden teruggegeven in plaats van voorafgefilterd op enig idee van belang.

// 02 / Live request

POST/v1/parans

curl -X POST https://api.astroway.info/v1/parans \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
  "date": "1990-05-15",
  "time": "14:30:00",
  "timezoneOffset": 3
}'
Response (excerpt)
{
  "ok": true,
  "data": {
    "count": 414,
    "parans": [
      {
        "planet1Id": 0,
        "planet1Name": "Sun",
        "line1Type": "MC",
        "planet2Id": 1,
        "planet2Name": "Moon",
        "line2Type": "ASC",
        "location": { "lat": -45.9153, "lng": 6.5735 }
      }
    ]
  }
}
// 03 / Parameters

Parameters

nametypeRequired
date string (YYYY-MM-DD) yes Birth date.
time string (HH:MM:SS) yes Local clock time at birth.
timezoneOffset number (hours) no UTC offset in effect at the birth moment. Defaults to 0. Decimal allowed for half-hour zones.
// 04 / When to use it

When to use it

Grijp naar parans als astrocartografische lijnen alleen te grof zijn. Lijnen vertellen een gebruiker dat een corridor Jupiter draagt; parans vertellen hen dat op één specifieke plek op die corridor Jupiter Venus ontmoet. Dat onderscheid is waar verhuisadviseurs voor rekenen, en het is de laag die de meeste kaartinstrumenten overslaan. Praktisch: render de lijnen als polylines en de parans als klikbare markeringen, of filter de lijst naar de planeetparen waar je product om geeft en rangschik nabije steden op afstand tot die punten. Het antwoord bevat alleen coördinaten, dus je kunt deze koppelen aan je eigen stad of regio dataset zonder te vechten tegen een prozavorm. Merk op dat deze endpoint geen geboorteplaats nodig heeft, alleen het moment, omdat de kruisingen eigenschappen van de hemel zijn in plaats van van waar de persoon zich toevallig bevond.

// 05 / Notes

Notes

Posities komen van de Swiss Ephemeris (Astrodienst) gecompileerd naar WASM, dezelfde motor als de natal endpoints, dus parans verankeren aan dezelfde planetaire lengtegraden als de lijnen waar ze van afgeleid zijn. Kruisingen worden berekend in de tropische dierenriem uit de volledige lijngeometrie in plaats van uit een breedtegraafbenadering. Klassieke paran doctrine zoals uiteengezet door Bernadette Brady behandelt ook ster-planeet parans, en rapporteert deze als een breedtegraad in plaats van een punt; dat geval heeft zijn eigen endpoint, [ster-planeet parans](/astrology-api/star-parans/). Deze dekt het planeet-planeet geval dat de astrocartografische kaart zelf genereert.

Try the Parans API

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

99.9% SLA · betaalde plannen · 30d status →