Retours Solaires & Lunaires

Calculez les thèmes de retour solaire (thème d'anniversaire) et de retour lunaire. Les thèmes de retour montrent les positions planétaires au moment exact où une planète revient à sa position natale, fournissant un aperçu prévisionnel pour l'année ou le mois à venir.

---

Retour Solaire

Un thème de retour solaire est calculé pour le moment exact où le Soleil revient à son degré natal chaque année, ce qui se produit près de l'anniversaire. Il est utilisé pour prévoir les thèmes de l'année à venir.

Module Requis

Nécessite le module solar-return:calc.

curl -X POST "https://api.astroapi.cloud/api/calc/solar-return" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "birthDateTime": "1990-06-15T14:30",
    "birthLocation": {
      "longitude": -0.1278,
      "latitude": 51.5074,
      "timezone": "Europe/London"
    },
    "returnYear": 2024,
    "houseSystem": "placidus",
    "language": "en",
    "includeText": true,
    "includeReadableEntities": true
  }'

Paramètres

Paramètre	Type	Requis	Description
birthDateTime	string	Oui	Date et heure de naissance au format YYYY-MM-DDTHH:mm
birthLocation	object	Oui	Lieu de naissance (voir Objet de Localisation ci-dessous)
returnYear	number	Non	Année du retour solaire (défaut : année en cours)
houseSystem	string	Non	Système de maisons (défaut : "placidus")
language	string	Non	Code de langue pour le contenu textuel (défaut : "en")
includeText	boolean	Non	Inclure le texte d'interprétation (défaut : false)
includeReadableEntities	boolean	Non	Inclure les titres d'entités lisibles par l'humain (défaut : false)
points	array	Non	Points célestes à inclure dans le calcul
orbs	object	Non	Valeurs d'orbe personnalisées par type d'aspect

Objet de Localisation

{
    "longitude": -0.1278,
    "latitude": 51.5074,
    "timezone": "Europe/London"
}

Réponse

{
    "data": {
        "returnYear": 2024,
        "returnDate": "2024-06-15T08:42:17Z",
        "aspects": [
            {
                "point1": "sun",
                "point2": "moon",
                "aspect": "trine",
                "orb": 1.8,
                "applying": false
            }
        ],
        "points": {
            "sun": {
                "longitude": 84.71,
                "latitude": 0.0,
                "sign": "gemini",
                "house": 10,
                "retrograde": false
            },
            "moon": {
                "longitude": 324.15,
                "latitude": -2.3,
                "sign": "aquarius",
                "house": 6,
                "retrograde": false
            }
        },
        "houses": {
            "1": { "cusp": 195.4, "sign": "libra" },
            "10": { "cusp": 84.5, "sign": "gemini" }
        },
        "charts": {
            "solarReturn": {
                "title": "Solar Return Chart",
                "url": "https://api.astroapi.cloud/api/chart/..."
            },
            "biWheel": {
                "title": "Solar Return / Natal Bi-wheel",
                "url": "https://api.astroapi.cloud/api/chart/..."
            },
            "natal": {
                "title": "Natal Chart",
                "url": "https://api.astroapi.cloud/api/chart/..."
            }
        }
    }
}

Champs de Réponse

Champ	Type	Description
returnYear	number	L'année de ce retour solaire
returnDate	string	Moment UTC exact du retour solaire
aspects	array	Aspects dans le thème de retour solaire
points	object	Positions planétaires dans le thème de retour solaire
houses	object	Cuspides de maisons pour le thème de retour solaire
charts.solarReturn	object	URL d'image du thème de retour solaire
charts.biWheel	object	Bi-roue montrant le retour solaire superposé au thème natal
charts.natal	object	URL d'image du thème natal

---

Retour Lunaire

Un thème de retour lunaire est calculé pour le moment exact où la Lune revient à son degré natal chaque mois (approximativement tous les 27,3 jours). Il est utilisé pour prévoir les thèmes du mois à venir.

Module Requis

Nécessite le module lunar-return:calc.

curl -X POST "https://api.astroapi.cloud/api/calc/lunar-return" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "birthDateTime": "1990-06-15T14:30",
    "birthLocation": {
      "longitude": -0.1278,
      "latitude": 51.5074,
      "timezone": "Europe/London"
    },
    "returnDate": "2024-06-01",
    "houseSystem": "placidus",
    "language": "en",
    "includeText": true,
    "includeReadableEntities": true
  }'

Paramètres

Paramètre	Type	Requis	Description
birthDateTime	string	Oui	Date et heure de naissance au format YYYY-MM-DDTHH:mm
birthLocation	object	Oui	Lieu de naissance (longitude, latitude, fuseau horaire)
returnDate	string	Non	Date de début (YYYY-MM-DD) à partir de laquelle trouver le prochain retour lunaire (défaut : maintenant)
houseSystem	string	Non	Système de maisons (défaut : "placidus")
language	string	Non	Code de langue pour le contenu textuel (défaut : "en")
includeText	boolean	Non	Inclure le texte d'interprétation (défaut : false)
includeReadableEntities	boolean	Non	Inclure les titres d'entités lisibles par l'humain (défaut : false)
points	array	Non	Points célestes à inclure dans le calcul
orbs	object	Non	Valeurs d'orbe personnalisées par type d'aspect

Réponse

{
    "data": {
        "returnDate": "2024-06-12T03:18:44Z",
        "aspects": [
            {
                "point1": "moon",
                "point2": "venus",
                "aspect": "sextile",
                "orb": 0.9,
                "applying": true
            }
        ],
        "points": {
            "moon": {
                "longitude": 245.2,
                "latitude": -3.1,
                "sign": "sagittarius",
                "house": 4,
                "retrograde": false
            }
        },
        "houses": {
            "1": { "cusp": 130.8, "sign": "leo" },
            "4": { "cusp": 240.5, "sign": "sagittarius" }
        },
        "charts": {
            "lunarReturn": {
                "title": "Lunar Return Chart",
                "url": "https://api.astroapi.cloud/api/chart/..."
            },
            "biWheel": {
                "title": "Lunar Return / Natal Bi-wheel",
                "url": "https://api.astroapi.cloud/api/chart/..."
            },
            "natal": {
                "title": "Natal Chart",
                "url": "https://api.astroapi.cloud/api/chart/..."
            }
        }
    }
}

Champs de Réponse

Champ	Type	Description
returnDate	string	Moment UTC exact du retour lunaire
aspects	array	Aspects dans le thème de retour lunaire
points	object	Positions planétaires dans le thème de retour lunaire
houses	object	Cuspides de maisons pour le thème de retour lunaire
charts.lunarReturn	object	URL d'image du thème de retour lunaire
charts.biWheel	object	Bi-roue montrant le retour lunaire superposé au thème natal
charts.natal	object	URL d'image du thème natal

---

Systèmes de Maisons

Les deux endpoints prennent en charge les mêmes systèmes de maisons que les calculs de thèmes natals :

Valeur	Nom
placidus	Placidus (défaut)
koch	Koch
equal	Maison Égale
whole	Signe Entier
campanus	Campanus
regiomontanus	Regiomontanus
porphyry	Porphyre

Localisation pour les Thèmes de Retour

De nombreux astrologues utilisent le lieu où la personne se trouve physiquement au moment du retour, plutôt que le lieu de naissance. Passez la résidence actuelle ou le lieu de voyage dans birthLocation si vous souhaitez des thèmes de retour relatifs à la localisation.