Lokale Ruimte astrologie API
Lokale ruimte stelt een andere vraag dan astrocartografie: niet waar op aarde een planeet hoekig stond, maar in welke kompasrichting deze vanaf de geboorteplaats stond. Het endpoint geeft een azimut en een hoogte voor elke hemellichaam, plus de grootcirkelpad dat die richting over de aarde traceert.
Lokale Ruimte astrologie API
Het endpoint bouwt het geboortehoroscoop, converteert elke planeet van ecliptische coördinaten naar het horizonraamwerk van de geboorteplaats, en geeft zijn azimut in graden met de klok mee vanaf het ware noorden samen met zijn hoogte boven of onder de horizon. Het projecteert vervolgens elk azimut als een grootcirkel uit de geboorteplaats en geeft het resulterende pad terug als een reeks coördinaten, zodat een lijn op een wereldkaart een ware richting behoudt in plaats van een rechte lijn op een vlakke projectie. Dertien hemellichamen worden gedekt, elk met een stabiele kleur zodat een gerenderde kaart dezelfde kleurenpalet behoudt als de rest van de suite. Hoogte is hier net zo belangrijk als azimut: een planeet onder de horizon bij de geboorte leest anders dan een hoog aan de hemel in dezelfde richting.
POST/v1/local-space
curl -X POST https://api.astroway.info/v1/local-space \
-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": {
"birthplace": { "latitude": 50.45, "longitude": 30.52 },
"count": 13,
"lines": [
{
"planetId": 0,
"planetName": "Sun",
"azimuth": 219.8018,
"altitude": 53.1309,
"color": "#FFB300",
"points": [{ "lat": 50.45, "lng": 30.52 }, "…"]
}
]
}
}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. Decimal allowed for half-hour zones. |
| latitude | number | yes | Birth-place latitude, decimal degrees (north positive). Local space is anchored here, so this is not optional. |
| longitude | number | yes | Birth-place longitude, decimal degrees (east positive). |
When to use it
Gebruik lokale ruimte wanneer het product gaat over richting en afstand vanaf een vaste thuisbasis in plaats van absolute positie op de aarde. Twee gevallen domineren. Het eerste is verhuizing op elke schaal, van het kiezen van welke stad langs een gunstige richting ligt tot het beslissen welke kant op je binnen één land verhuist, omdat een grootcirkel vanaf de geboorteplaats veel meer bruikbaar gebied doorkruist dan een handvol astrocartografie meridianen. Het tweede is interieur en werkplek, waarbij dezelfde azimuten op kamerschaal binnen een woning worden gelezen: het endpoint geeft de richtingen terug, en de /local-space/influence-zone companion zet er een van om in een kegelvormige polygoon die je kunt tekenen. Als je al astrocartografie renderd, is lokale ruimte de goedkoopste manier om de diepte van een verhuisfunctie te verdubbelen, omdat het dezelfde geboorteinvoer en dezelfde kaartoppervlakte gebruikt.
Notes
Posities komen van de Swiss Ephemeris (Astrodienst) gecompileerd naar WASM. Azimut wordt gemeten met de klok vanaf het ware noorden, niet het magnetische noorden, dus geen declinatiecorrectie wordt toegepast of nodig. Het grootcirkelpad wordt teruggegeven als bemonsterde coördinaten in plaats van als formule, wat de cliënt vrijhoudt van sferische geometrie. De techniek in deze vorm is ontwikkeld door Michael Erlewine en wordt gedocumenteerd in zijn Astrophysical Directions.
Try the Lokale Ruimte API
Grab a key and make your first call in under a minute.