Local Space API d'astrologie
Local Space pose une question différente de l'astrocartographie : pas où sur Terre une planète était angulaire, mais dans quelle direction de la boussole elle se trouvait par rapport au lieu de naissance. L'endpoint renvoie un azimuth et une altitude pour chaque corps, plus le tracé en grand-cercle que cette direction suit à travers le globe.
Local Space API d'astrologie
Le endpoint construit la carte natale, convertit chaque planète des coordonnées écliptiques vers le cadre de l'horizon du lieu de naissance, et renvoie son azimuth en degrés dans le sens des aiguilles d'une montre depuis le vrai nord avec son altitude au-dessus ou en dessous de l'horizon. Il projette ensuite chaque azimuth en grand-cercle depuis le lieu de naissance et renvoie le chemin résultant sous forme de série de coordonnées, ainsi une ligne dessinée sur une carte du monde reste un vrai cap plutôt qu'une ligne droite sur une projection plane. Treize corps sont inclus, chacun avec une couleur stable afin que la carte rendue garde la même palette que le reste de la suite. L'altitude compte autant que l'azimuth ici : une planète sous l'horizon à la naissance se lit différemment d'une planète haute dans le ciel dans la même direction.
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
Utilise Local Space quand le produit porte sur la direction et la distance depuis un domicile fixe plutôt que sur la position absolue sur le globe. Deux cas dominent. Le premier, c’est la relocalisation à n’importe quelle échelle, de choisir quelle ville se trouve le long d’un cap favorable à décider de la direction à prendre dans un pays, parce qu’un grand-cercle depuis le lieu de naissance traverse beaucoup plus de territoire exploitable qu’une poignée de méridiens d'astrocartographie. Le second, c’est les travaux intérieurs et de site, où les mêmes azimuths sont lus à l’échelle d’une pièce à l’intérieur d’un logement : l'endpoint renvoie les caps, et le compagnon /local-space/influence-zone transforme l’un d’eux en un polygone en cône que tu peux dessiner. Si tu renders déjà de l'astrocartographie, ajouter Local Space est la façon la moins chère de doubler la profondeur d’une fonction de relocalisation, puisque ça utilise les mêmes entrées de naissance et la même surface de carte.
Notes
Les positions proviennent du Swiss Ephemeris (Astrodienst) compilé en WASM. L'azimuth est mesuré dans le sens des aiguilles d’une montre depuis le vrai nord, pas le nord magnétique, donc aucune correction de déclinaison n’est appliquée ni nécessaire. Le chemin en grand-cercle est renvoyé sous forme de coordonnées échantillonnées plutôt que sous forme de formule, ce qui garde le client libre de la géométrie sphérique. La technique sous cette forme a été développée par Michael Erlewine et est documentée dans ses Astrophysical Directions.
Try the Local Space API
Grab a key and make your first call in under a minute.