Zonne- & maanretour

Bereken zonneretour (verjaardagshoroscoop) en maanretourhoroscopen. Retourhoroscopen tonen planetaire posities op het exacte moment dat een planeet terugkeert naar zijn natale positie, en bieden voorspellingsinzicht voor het komende jaar of de komende maand.

---

Zonneretour

Een zonneretourhoroscoop wordt berekend voor het exacte moment dat de Zon terugkeert naar zijn natale graad elk jaar, wat plaatsvindt rond de verjaardag. Het wordt gebruikt om thema's voor het komende jaar te voorspellen.

Vereiste module

Vereist de solar-return:calc module.

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
  }'

Parameters

Parameter	Type	Verplicht	Beschrijving
birthDateTime	string	Ja	Geboortedatum en -tijd in YYYY-MM-DDTHH:mm formaat
birthLocation	object	Ja	Geboortelocatie (zie locatie-object hieronder)
returnYear	number	Nee	Jaar voor de zonneretour (standaard: huidig jaar)
houseSystem	string	Nee	Huizensysteem (standaard: "placidus")
language	string	Nee	Taalcode voor tekstinhoud (standaard: "en")
includeText	boolean	Nee	Interpretatietekst opnemen (standaard: false)
includeReadableEntities	boolean	Nee	Leesbare entiteitstitels opnemen (standaard: false)
points	array	Nee	Hemellichamen om op te nemen in de berekening
orbs	object	Nee	Aangepaste orbwaarden per aspecttype

Locatie-object

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

Response

{
    "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/..."
            }
        }
    }
}

Responsevelden

Veld	Type	Beschrijving
returnYear	number	Het jaar van deze zonneretour
returnDate	string	Exact UTC-moment van de zonneretour
aspects	array	Aspecten binnen de zonneretourhoroscoop
points	object	Planetaire posities in de zonneretourhoroscoop
houses	object	Huiscuspen voor de zonneretourhoroscoop
charts.solarReturn	object	Zonneretourhoroscoop afbeeldings-URL
charts.biWheel	object	Bi-wheel met zonneretour over geboortehoroscoop
charts.natal	object	Geboortehoroscoop afbeeldings-URL

---

Maanretour

Een maanretourhoroscoop wordt berekend voor het exacte moment dat de Maan terugkeert naar zijn natale graad elke maand (ongeveer elke 27,3 dagen). Het wordt gebruikt om thema's voor de komende maand te voorspellen.

Vereiste module

Vereist de lunar-return:calc module.

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
  }'

Parameters

Parameter	Type	Verplicht	Beschrijving
birthDateTime	string	Ja	Geboortedatum en -tijd in YYYY-MM-DDTHH:mm formaat
birthLocation	object	Ja	Geboortelocatie (longitude, latitude, timezone)
returnDate	string	Nee	Startdatum (YYYY-MM-DD) om de volgende maanretour te vinden vanaf (standaard: nu)
houseSystem	string	Nee	Huizensysteem (standaard: "placidus")
language	string	Nee	Taalcode voor tekstinhoud (standaard: "en")
includeText	boolean	Nee	Interpretatietekst opnemen (standaard: false)
includeReadableEntities	boolean	Nee	Leesbare entiteitstitels opnemen (standaard: false)
points	array	Nee	Hemellichamen om op te nemen in de berekening
orbs	object	Nee	Aangepaste orbwaarden per aspecttype

Response

{
    "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/..."
            }
        }
    }
}

Responsevelden

Veld	Type	Beschrijving
returnDate	string	Exact UTC-moment van de maanretour
aspects	array	Aspecten binnen de maanretourhoroscoop
points	object	Planetaire posities in de maanretourhoroscoop
houses	object	Huiscuspen voor de maanretourhoroscoop
charts.lunarReturn	object	Maanretourhoroscoop afbeeldings-URL
charts.biWheel	object	Bi-wheel met maanretour over geboortehoroscoop
charts.natal	object	Geboortehoroscoop afbeeldings-URL

---

Huizensystemen

Beide endpoints ondersteunen dezelfde huizensystemen als geboortehoroscoopberekeningen:

Waarde	Naam
placidus	Placidus (standaard)
koch	Koch
equal	Gelijke Huizen
whole	Heel Teken
campanus	Campanus
regiomontanus	Regiomontanus
porphyry	Porphyrius

Locatie voor retourhoroscopen

Veel astrologen gebruiken de locatie waar de persoon zich fysiek bevindt op het moment van de retour, in plaats van de geboortelocatie. Geef de huidige woon- of reislocatie op in birthLocation als u locatiegebonden retourhoroscopen wilt.