Maankalender

Bereken maanfase-informatie, Void of Course-perioden, tekenransits en aankomende maanaspecten.

Dagdetail

Haal gedetailleerde maaninformatie op voor een specifieke dag:

curl -X POST "https://api.astroapi.cloud/api/calc/moon-calendar/day" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "dateTime": "2024-06-15T12:00",
    "location": {
      "latitude": 52.37,
      "longitude": 4.89,
      "timezone": "Europe/Amsterdam"
    },
    "aspects": ["conjunction", "sextile", "square", "trine", "opposition"]
  }'

Datumbereik

Haal een maankalenderoverzicht op voor een datumbereik (max 31 dagen):

curl -X POST "https://api.astroapi.cloud/api/calc/moon-calendar/range" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "startDate": "2024-06-01",
    "endDate": "2024-06-30",
    "location": {
      "latitude": 52.37,
      "longitude": 4.89,
      "timezone": "Europe/Amsterdam"
    },
    "aspects": ["conjunction", "sextile", "square", "trine", "opposition"]
  }'

Parameters

Dag-endpoint

Parameter	Type	Verplicht	Beschrijving
dateTime	string	Ja	Datum en tijd in YYYY-MM-DDTHH:mm formaat
location	object	Ja	Locatie met latitude, longitude, timezone
aspects	array	Nee	Aspecten om mee te nemen voor VOC-berekening

Bereik-endpoint

Parameter	Type	Verplicht	Beschrijving
startDate	string	Ja	Startdatum in YYYY-MM-DD formaat
endDate	string	Ja	Einddatum in YYYY-MM-DD formaat (max 31 dagen)
location	object	Ja	Locatie met latitude, longitude, timezone
aspects	array	Nee	Aspecten om mee te nemen voor VOC-berekening

Beschikbare aspecten

• conjunction - 0 graden
• sextile - 60 graden
• square - 90 graden
• trine - 120 graden
• opposition - 180 graden

Dagresponse

{
  "data": {
    "date": "2024-06-15",
    "moon": {
      "sign": "leo",
      "signEntry": "2024-06-15T08:23:00Z",
      "signExit": "2024-06-17T14:45:00Z",
      "phase": {
        "name": "Waxing Gibbous",
        "illumination": 0.72,
        "age": 9.3
      }
    },
    "voidOfCourse": {
      "isVoid": true,
      "start": "2024-06-15T18:45:00Z",
      "end": "2024-06-17T14:45:00Z",
      "durationMinutes": 2640,
      "lastAspect": {
        "planet": "mars",
        "aspect": "trine",
        "exactTime": "2024-06-15T18:45:00Z"
      },
      "nextSign": "virgo"
    },
    "upcomingAspects": [
      {
        "planet": "venus",
        "aspect": "sextile",
        "exactTime": "2024-06-15T14:30:00Z",
        "applying": true
      },
      {
        "planet": "mars",
        "aspect": "trine",
        "exactTime": "2024-06-15T18:45:00Z",
        "applying": true
      }
    ]
  }
}

Bereikresponse

{
  "data": {
    "startDate": "2024-06-01",
    "endDate": "2024-06-30",
    "phases": [
      {
        "type": "new_moon",
        "date": "2024-06-06T12:37:00Z",
        "sign": "gemini"
      },
      {
        "type": "first_quarter",
        "date": "2024-06-14T05:18:00Z",
        "sign": "virgo"
      },
      {
        "type": "full_moon",
        "date": "2024-06-22T01:08:00Z",
        "sign": "capricorn"
      },
      {
        "type": "last_quarter",
        "date": "2024-06-28T21:53:00Z",
        "sign": "aries"
      }
    ],
    "signTransits": [
      {
        "sign": "gemini",
        "entry": "2024-06-01T03:15:00Z",
        "exit": "2024-06-03T08:45:00Z"
      },
      {
        "sign": "cancer",
        "entry": "2024-06-03T08:45:00Z",
        "exit": "2024-06-05T15:20:00Z"
      }
    ],
    "voidPeriods": [
      {
        "start": "2024-06-02T15:30:00Z",
        "end": "2024-06-03T08:45:00Z",
        "durationMinutes": 1035,
        "lastAspect": {
          "planet": "saturn",
          "aspect": "square"
        },
        "fromSign": "gemini",
        "toSign": "cancer"
      }
    ]
  }
}

Void of Course Maan

De Void of Course (VOC) Maan is de periode waarin de Maan geen belangrijke aspecten meer maakt met planeten voordat deze een nieuw teken binnengaat. Deze periode wordt traditioneel als ongunstig beschouwd voor het starten van nieuwe ondernemingen.

Hoe VOC wordt berekend

1. De huidige positie en het teken van de Maan worden bepaald
2. Het exacte moment waarop de Maan het volgende teken binnengaat wordt berekend
3. Alle aspecten tussen de Maan en grote planeten worden gevonden tot de tekenwissel
4. Het laatste aspect markeert het begin van de VOC-periode
5. De VOC-periode eindigt wanneer de Maan het nieuwe teken binnengaat

VOC-gegevensvelden

Veld	Beschrijving
isVoid	Of de Maan momenteel void of course is
start	Wanneer de VOC-periode begon (tijdstip laatste aspect)
end	Wanneer VOC eindigt (Maan gaat nieuw teken binnen)
durationMinutes	Duur van de VOC-periode in minuten
lastAspect	Details van het laatst gemaakte aspect
nextSign	Het teken waar de Maan als volgende in komt

Toepassingen

• Verkiezingsastrologie: Vermijd het starten van belangrijke activiteiten tijdens VOC Maan
• Maanfaseplanning: Volg optimale tijdstippen voor activiteiten op basis van maanfasen
• Astrologische kalenders: Toon maantekentransits en -fasen
• Rituele timing: Plan activiteiten afgestemd op maancycli