La geometrie du theme

Les aspects sont des distances angulaires precises entre planetes, observees depuis la Terre.

Pour un developpeur qui construit une application d'astrologie, ces angles comptent parce qu'ils decrivent les relations du theme : la maniere dont differentes energies planetaires interagissent.

Comment FreeAstroAPI calcule les aspects

Le moteur calcule la longitude geocentrique de chaque planete, de 0° a 360°, puis mesure la difference absolue entre deux corps.

Mais l'angle seul ne suffit pas. On applique aussi un orbe. L'orbe est la marge qui permet de considerer un aspect comme actif.

Par exemple, un Square exact fait 90°. Si le Soleil est a 88° et la Lune a 180°, l'ecart est de 92°. Avec un orbe de 5°, l'aspect reste un Square valide.

Structure des donnees

Quand vous appelez /api/v1/natal/calculate, le tableau aspects retourne des objets de ce type :

{
  "p1": "Sun",
  "p2": "Moon",
  "type": "Square",
  "orb": 5.5,
  "deg": 92.1,
  "is_major": true
}

Champs principaux

• p1 et p2 : les deux corps concernes.
• type : le nom de l'aspect.
• deg : l'angle exact entre les planetes, en degres.
• orb : la marge de l'aspect. Plus elle est basse, plus l'aspect est serre.
• is_major : booleen indiquant si l'aspect est majeur.

Aide-memoire des aspects majeurs

Visualiser les aspects

Sur une roue astrologique, les aspects sont souvent traces comme des lignes reliant les planetes au centre du cercle.

• Lignes bleues : aspects dits doux, comme Trine et Sextile.
• Lignes rouges : aspects dits durs, comme Square et Opposition.

// Example: Determining line color based on aspect type
const getLineColor = (aspectType: string) => {
  switch (aspectType) {
    case 'Trine':
    case 'Sextile':
      return '#4F46E5'; // Indigo/Blue
    case 'Square':
    case 'Opposition':
      return '#EF4444'; // Red
    case 'Conjunction':
      return '#F59E0B'; // Amber
    default:
      return '#9CA3AF'; // Grey
  }
};

Conclusion

Les aspects donnent de la profondeur aux applications astrologiques. Ils vont au-dela des simples placements en signes et decrivent une partie de la dynamique d'un theme. En utilisant le tableau aspects deja calcule par FreeAstroAPI, vous evitez les calculs geometriques et vous pouvez vous concentrer sur l'interface.