Declinatie Aspecten API
Meeste aspectwerk gebeurt langs de ecliptic in lengtegraad, maar twee lichamen kunnen ook gerelateerd zijn door declinatie - hun afstand noord of zuid van de hemelse evenaar. Deze endpoint werkt in die tweede dimensie, vindt parallellen en contraparallellen, de declinatie-equivalenten van conjunctie en oppositie, en noteert wanneer een lichaam de grenzen overschrijdt.
Declinatie Aspecten API
Van de geboortedatum, tijd, UTC-offset en coördinaten berekent de endpoint elke lichaam's declinatie - hoe ver noord of zuid van de hemelse evenaar het zit, buiten het ecliptic vlak waarop lengtegraad gemeten wordt - en vergelijkt vervolgens die declinaties tussen lichamen. Waar twee lichamen dezelfde declinatie aan dezelfde kant van de evenaar delen, registreert het een parallel, de declinatie-tegenhanger van een conjunctie; waar ze dezelfde declinatie aan tegenovergestelde kanten delen, registreert het een contraparallel, de tegenhanger van een oppositie. Elke contact wordt geretourneerd onder data.parallels met de betrokken lichamen. De endpoint toont ook out-of-bounds context - wanneer een lichaam's declinatie de maximum van de Zon overschrijdt, het buiten de band brengt die de Zon ooit bereikt, een conditie traditioneel gelezen als de planeet zonder zijn gebruikelijke beperking werkt. Dit geeft je een contactlaag die pure lengtegraad volledig mist: twee planeten zonder longitudinaal aspect kunnen nog steeds in een strak parallel vergrendeld zitten.
POST/v1/parallel-aspects
curl -X POST https://api.astroway.info/v1/parallel-aspects \
-H "X-Api-Key: aw_live_..." \
-H "Content-Type: application/json" \
-d '{
"date": "1990-05-15",
"time": "14:30:00",
"timezoneOffset": 3,
"latitude": 50.45,
"longitude": 30.52
}' {
"ok": true,
"data": {
"parallels": [
{
"planet1": "Sun",
"planet2": "Moon",
"type": "contra-parallel",
"orb": 0.49
}
]
}
} Parameters
| name | type | Required | |
|---|---|---|---|
| date | string (YYYY-MM-DD) | yes | Birth date. |
| time | string (HH:MM:SS) | yes | Local clock time at birth. |
| timezoneOffset | number (hours) | yes | UTC offset in effect at the birth moment (e.g. 3 for Kyiv summer time). Decimal allowed for half-hour zones. |
| latitude | number | yes | Birth-place latitude, decimal degrees (north positive). |
| longitude | number | yes | Birth-place longitude, decimal degrees (east positive). |
When to use it
Gebruik deze endpoint wanneer een aspect-engine niet moet stoppen bij de ecliptic - een serieuze chart-analyseur, een synastrie of transit-tool die de declinatielaag wil, of een rapport dat uitlegt waarom twee planeten verbonden voelen ondanks het vormen van geen longitudinaal aspect. Parallellen en contraparallellen zijn precies de contacten die een alleen-lengtegraad rooster laat vallen, dus toevoegen ervan vult een echt gat in in plaats van het geboorte-chart aspect output te dupliceren. De out-of-bounds vlag is zelfstandig nuttig: het markeert planeten die de traditie als onbeperkt werkend beschouwt, wat een schone highlight maakt in een chart-rapport. Stuur dezelfde geboortegegevens die je elders hebt gebruikt en de declinatie-contacten zullen verwijzen naar dezelfde lichamen als je lengtegraad-aspecten, zodat je beide roosters kunt presenteren als twee lezingen van één chart.
Notes
Parallellen en contraparallellen volgen de traditionele declinatie-leer, gelijk-declinatie-contacten behandelend als de equivalenten van conjunctie en oppositie; de out-of-bounds lezing put uit het werk van Kt Boehrer. Declinaties worden berekend door de Swiss Ephemeris (Astrodienst) engine in het tropische raamwerk, op dezelfde lichamen als de op lengtegraad gebaseerde natal endpoints.
Try the Declinatie Aspecten API
Grab a key and make your first call in under a minute.