Astrologie tropicale ou siderale pour developpeurs : ce que votre API doit supporter

Si vous construisez une app d'astrologie, vous allez rencontrer cette question :

Why does one chart say Aries, while another chart says Pisces for the same person?

La plupart du temps, rien n'est casse. Les deux themes utilisent des systemes zodiacaux differents.

L'astrologie tropicale et l'astrologie siderale utilisent les memes douze noms de signes : Aries, Taurus, Gemini, Cancer, etc. La difference est le point de depart du zodiaque.

Le tropical commence au point vernal de mars. Le sideral utilise une reference liee aux etoiles. Cela peut changer le signe affiche pour le Soleil, la Lune, l'Ascendant, les planetes et les maisons.

Pour un developpeur, la regle est simple : ne cachez pas ce parametre. Si votre app peut retourner des themes tropicaux et sideraux, l'utilisateur doit savoir lequel il regarde.

Version courte

L'astrologie tropicale est le defaut de la plupart des apps occidentales modernes.

L'astrologie siderale est le defaut de la plupart des apps vediques, Jyotish et kundli.

Point de depart utile :

Si vous construisez	Utilisez generalement
Western birth chart calculator	Tropical
Western daily horoscope app	Tropical
Western synastry or compatibility app	Tropical
Vedic chart or kundli app	Sidereal
Nakshatra, dasha, Panchang, or gochar features	Sidereal
App that supports both Western and Vedic astrology	Let the user choose

Il ne s'agit pas de dire qu'un systeme est correct et l'autre faux. Ils appartiennent a des traditions differentes.

Ce que signifie l'astrologie tropicale

L'astrologie tropicale est liee aux saisons.

Dans ce systeme, Aries commence a l'equinoxe de mars, quand le Soleil croise l'equateur celeste et que le jour et la nuit sont presque egaux.

A partir de ce point, le zodiaque est divise en douze signes de 30 degres :

Aries      0 to 30
Taurus    30 to 60
Gemini    60 to 90
Cancer    90 to 120
...
Pisces    330 to 360

Tropical Aries ne cherche donc pas a etre la constellation physique exacte d'Aries. C'est le premier signe d'un zodiaque saisonnier.

C'est ainsi que l'astrologie occidentale est pratiquee le plus souvent aujourd'hui. Aux Etats-Unis ou en Europe, une personne qui cherche "my birth chart", "my rising sign" ou "my moon sign" attend en general un theme occidental tropical, sauf mention contraire.

Si vous construisez une API d'astrologie occidentale, tropical doit donc souvent etre le defaut.

Usages du tropical

Le tropical est courant pour :

themes natals occidentaux
horoscopes de signe solaire
astrologie psychologique
compatibilite moderne
transits occidentaux
retours solaires et techniques de timing occidentales

Le langage ressemble souvent a ceci :

Your Sun is in Leo.
Your Moon is in Scorpio.
Your Ascendant is Virgo.
Venus is transiting your seventh house.

Le theme peut inclure maisons, aspects, dignites et transits, mais le zodiaque derriere ces placements est generalement tropical.

Ce que signifie l'astrologie siderale

L'astrologie siderale utilise un zodiaque fonde sur les etoiles.

L'idee importante est que les zodiaques tropical et sideral ne sont plus alignes. L'orientation de la Terre se decale tres lentement, un mouvement appele precession.

A cause de ce decalage, une meme position planetaire peut tomber dans deux signes differents selon le systeme.

Exemple moderne approximatif :

Tropical Sun: 5 Aries
Sidereal Sun: about 11 Pisces

Le Soleil n'a pas bouge. Les donnees de naissance n'ont pas change. Le theme est mesure avec un autre zodiaque.

Usages du sideral

Le sideral est surtout utilise en astrologie vedique, ou Jyotish.

Si votre app inclut ces fonctions, vous etes probablement cote sideral :

Kundli charts
Rashi charts
Nakshatras
Dashas
Panchang
Gochar transits
Vedic compatibility
Muhurat or electional timing
Lahiri ayanamsha

Des astrologues occidentaux sideraux existent aussi, mais c'est un public plus specifique. Pour la plupart des produits :

Western astrology page -> tropical by default
Vedic astrology page -> sidereal by default

Si vous melangez les deux traditions, montrez le choix.

Qu'est-ce qu'un ayanamsha ?

Pour un developpeur debutant, l'ayanamsha est l'ecart entre le zodiaque tropical et un zodiaque sideral.

Version simplifiee :

sidereal position = tropical position - ayanamsha

En production, laissez un moteur astrologique fiable gerer cela. L'offset exact depend de la date et du systeme d'ayanamsha choisi.

Options courantes :

Ayanamsha	Usage frequent
`lahiri`	Defaut courant pour les themes vediques et Jyotish.
`raman`	Utilise par certains astrologues vediques.
`kp`	Utilise en astrologie KP.
`fagan_bradley`	Souvent utilise en astrologie siderale occidentale.
`yukteshwar`	Utilise par certains praticiens sideraux.

"Sidereal" seul ne suffit pas toujours. Une API serieuse doit aussi indiquer l'ayanamsha utilise.

Exemple simple

Imaginons un utilisateur ne avec le Soleil au debut de Aries tropical.

Dans une page de theme occidental :

Sun in Aries
Zodiac: Tropical

Dans une page vedique avec Lahiri :

Sun in Pisces
Zodiac: Sidereal
Ayanamsha: Lahiri

Les deux resultats peuvent venir des memes date, heure et lieu de naissance.

Le probleme commence si l'app affiche seulement :

Sun in Pisces

L'utilisateur n'a alors aucun contexte. S'il attendait un theme occidental, il pensera que le calcul est faux.

Ce que votre API doit supporter

Le systeme zodiacal doit etre un parametre explicite.

Pour un theme tropical :

{
  "zodiac_type": "tropical"
}

Pour un theme sideral :

{
  "zodiac_type": "sidereal",
  "sidereal_ayanamsa": "lahiri"
}

La reponse doit renvoyer ces reglages. Ne forcez pas les developpeurs a deviner.

Exemple utile :

{
  "meta": {
    "zodiac_type": "sidereal",
    "sidereal_ayanamsa": "lahiri",
    "house_system": "whole_sign",
    "time_known": true
  }
}

Cette petite metadonnee evite beaucoup de confusion.

Exemples FreeAstroAPI

Theme natal occidental tropical :

curl -X POST "https://api.freeastroapi.com/api/v1/natal/calculate" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "name": "Alex",
    "year": 1994,
    "month": 8,
    "day": 11,
    "time_known": true,
    "hour": 6,
    "minute": 42,
    "city": "Los Angeles",
    "lat": 34.0522,
    "lng": -118.2437,
    "tz_str": "AUTO",
    "house_system": "placidus",
    "zodiac_type": "tropical"
  }'

Theme sideral avec Lahiri :

curl -X POST "https://api.freeastroapi.com/api/v1/natal/calculate" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "name": "Alex",
    "year": 1994,
    "month": 8,
    "day": 11,
    "time_known": true,
    "hour": 6,
    "minute": 42,
    "city": "Los Angeles",
    "lat": 34.0522,
    "lng": -118.2437,
    "tz_str": "AUTO",
    "house_system": "whole_sign",
    "zodiac_type": "sidereal",
    "sidereal_ayanamsa": "lahiri"
  }'

Si vous rendez des roues en SVG ou PNG, l'image doit utiliser le meme zodiaque que les donnees. Une reponse JSON siderale avec une image tropicale va tromper l'utilisateur.

Voir Western Natal, Western Chart SVG, et Vedic Chart.

Choisir un defaut

Si la page dit "Western astrology", utilisez tropical.

Si elle dit "Vedic astrology", "Jyotish", "kundli", "nakshatra" ou "dasha", utilisez sideral. Pour la plupart des apps vediques, lahiri est le defaut le plus sur.

Pour une plateforme generale, affichez un choix clair :

Zodiac system: Tropical | Sidereal

Si l'utilisateur choisit Sidereal, affichez aussi :

Ayanamsha: Lahiri

Gardez l'explication courte dans l'UI. Les utilisateurs ont besoin de savoir quelle tradition le theme suit, pas d'un cours d'astronomie.

Texte d'interface utile

Mauvais label :

Mode: Standard

Meilleur label :

Zodiac system: Tropical

Avec une indication courte :

Zodiac system: Tropical
Used by most modern Western astrology charts.

Pour le sideral :

Zodiac system: Sidereal
Used by Vedic/Jyotish charts and some Western sidereal charts.

Ne pas cacher le type de zodiaque dans le cache

Ne cachez pas un theme seulement par :

birth date + birth time + city

Un theme tropical et un theme sideral peuvent utiliser les memes donnees de naissance et retourner des signes differents.

La cle de cache doit inclure les reglages :

birth_datetime_utc
+ latitude
+ longitude
+ timezone
+ house_system
+ zodiac_type
+ sidereal_ayanamsa
+ engine_version

Vous evitez ainsi d'afficher des donnees tropicales sur une page siderale, ou l'inverse.

Les apps IA ont besoin du meme contexte

Si vous utilisez un LLM pour ecrire des interpretations, ne le laissez pas deviner le systeme zodiacal.

Envoyez les reglages avec le theme :

{
  "instruction": "Interpret only the supplied chart data. Do not recalculate signs.",
  "calculation_settings": {
    "zodiac_type": "sidereal",
    "sidereal_ayanamsa": "lahiri",
    "house_system": "whole_sign"
  },
  "placements": {
    "sun": "Pisces 11",
    "moon": "Cancer 28",
    "ascendant": "Leo 3"
  }
}

C'est important parce que beaucoup de textes astrologiques en ligne sont tropicaux et occidentaux. Si le theme est vedique sideral, le prompt doit le dire.

Erreurs frequentes

Erreur 1 : traiter sidereal comme une simple option d'affichage

Le sideral change les longitudes zodiacales et donc les signes et interpretations.

Erreur 2 : cacher l'ayanamsha

Pour les utilisateurs avances, l'ayanamsha compte. Si vous supportez le sideral, montrez-le dans la reponse et dans l'UI quand c'est utile.

Erreur 3 : melanger texte tropical et donnees siderales

Un texte ecrit pour l'astrologie occidentale tropicale ne s'applique pas toujours tel quel a des placements vediques sideraux.

Erreur 4 : comparer des signes sans verifier le zodiaque

Une requete "Moon in Cancer" doit aussi savoir s'il s'agit de Cancer tropical ou sideral.

Erreur 5 : ne pas expliquer pourquoi les signes changent

Si vous proposez un toggle, les utilisateurs verront les signes changer. Une phrase courte pres du toggle reduit les questions support.

FAQ

Le sideral est-il plus exact que le tropical ?

Pas dans un sens produit simple. Ce sont deux systemes utilises par des traditions differentes. L'app doit calculer celui que l'utilisateur demande et le nommer clairement.

Pourquoi mon signe solaire a-t-il change ?

Le theme est probablement passe de tropical a sideral, ou l'inverse. Les donnees de naissance n'ont pas change. Le systeme zodiacal a change.

L'astrologie vedique est-elle toujours siderale ?

La plupart des apps vediques et Jyotish utilisent le sideral, souvent avec Lahiri ayanamsha. Pour nakshatras, dashas, Panchang ou kundli, le sideral doit etre le defaut.

L'astrologie occidentale est-elle toujours tropicale ?

La plupart de l'astrologie occidentale moderne est tropicale, mais l'astrologie occidentale siderale existe aussi. Pour un calculateur general de theme occidental, tropical est le defaut attendu.

Faut-il laisser le choix aux utilisateurs ?

Oui si votre produit sert a la fois les publics occidentaux et vediques. Si le produit est uniquement occidental, vous pouvez utiliser tropical et l'indiquer. S'il est uniquement vedique, utilisez sideral et affichez l'ayanamsha.

A retenir

Tropical vs sideral n'est pas un detail technique mineur. Cela change les signes vus par l'utilisateur.

Pour une app claire :

utilisez tropical pour la plupart des fonctions occidentales
utilisez sideral pour les fonctions vediques et Jyotish
affichez le systeme zodiacal dans l'UI
incluez zodiac_type dans les requetes et reponses
incluez sidereal_ayanamsa pour les themes sideraux
gardez images, rapports, caches et prompts IA alignes sur le meme reglage

Les utilisateurs obtiennent ainsi des themes qui correspondent a la tradition attendue, et les developpeurs ont assez de metadonnees pour construire un produit fiable.