AstroWay/api v2.201.6 · fr
tous les systèmes sont opérationnels
// astrology api · POST /v1/heliocentric

API de la carte héliocentrique

Déplace l’observateur vers le Soleil. Au lieu du ciel habituel centré sur la Terre, ça renvoie le système solaire vu du Soleil – la Terre devient un corps, la Lune et l’Ascendant disparaissent, et chaque planète est donnée en longitude héliocentrique. Donne un instant, reçois la carte héliocentrique. Précision Swiss Ephemeris, sortie JSON.

Endpoint
POST /v1/heliocentric
Cost
20 credits
Latency
~63 ms
Tier
Tier 2
// 01 / What it computes

API de la carte héliocentrique

Le point d’accès héliocentrique résout la date, l’heure et le décalage UTC fournis en jour julien, puis interroge le moteur Swiss Ephemeris pour obtenir les positions planétaires référencées au centre du Soleil plutôt qu’à la Terre. Dans ce cadre, la Terre apparaît comme un corps en orbite avec sa propre longitude, tandis que la Lune – qui orbite la Terre, pas le Soleil – ainsi que l’Ascendant et le Milieu du Ciel géocentriques n’ont aucun sens et sont omis. La réponse renvoie les longitudes héliocentriques des planètes et la grille complète des aspects calculée entre elles, avec les drapeaux d’application et de séparation et les orbes exactes. Comme le mouvement héliocentrique est stable et exempt des boucles rétrogrades et du parallaxe introduits par l’orbite terrestre, l’espacement planétaire se lit très différemment d’une carte géocentrique – les positions reflètent la vraie géométrie orbitale autour du Soleil.

// 02 / Live request

POST/v1/heliocentric

curl -X POST https://api.astroway.info/v1/heliocentric \
  -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
}'
Response (excerpt)
{
  "ok": true,
  "data": {
    "input": {},
    "planets": [
      {
        "name": "Earth",
        "longitude": 234.2
      },
      {
        "name": "Mars",
        "longitude": 9.1
      }
    ],
    "aspects": [
      {
        "planet1": "Earth",
        "planet2": "Jupiter",
        "type": "trine",
        "orb": 0.9
      }
    ]
  }
}
// 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) 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).
// 04 / When to use it

When to use it

Utilise la carte héliocentrique dans la recherche, la finance et les contextes mondains où la vue centrée sur le Soleil est la norme analytique – modèles de timing de marché qui suivent les angles planétaires héliocentriques, études mondaines des cycles planétaires, ou toute analyse qui veut la géométrie orbitale sans les distorsions de la rétrogradation géocentrique. C’est aussi utile comme superposition contrastée à une carte conventionnelle, puisque une planète qui semble rétrograde depuis la Terre avance simplement autour du Soleil ici. Comme il n’y a pas de Lune, pas d’Ascendant et pas de maisons au sens géocentrique, considère la sortie comme un jeu de données de longitudes planétaires et d’aspects plutôt qu’une carte natale personnelle – elle répond aux questions sur les cycles et les configurations, pas au signe ascendant d’un individu.

// 05 / Notes

Notes

C’est un cadre centré sur le Soleil : la Terre est renvoyée comme un corps, et la Lune, l’Ascendant géocentrique et le Milieu du Ciel sont absents par construction. Le mouvement rétrograde disparaît car c’est un artefact de la vue depuis une Terre en mouvement. La sortie se lit mieux comme des longitudes héliocentriques plus leur grille d’aspects pour le travail de cycles et mondain, pas comme une carte personnelle. Longitudes tropicales et Swiss Ephemeris partout.

Try the Carte héliocentrique API

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

99,9% SLA · forfaits payants · 30 j statut →