Calendario Lunare

Calcola informazioni sulla fase lunare, periodi di Luna Vuota di Corso, transiti nei segni e prossimi aspetti lunari.

Dettaglio Giornaliero

Ottieni informazioni dettagliate sulla Luna per un giorno specifico:

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

Intervallo di Date

Ottieni una panoramica del calendario lunare per un intervallo di date (massimo 31 giorni):

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

Parametri

Endpoint Giornaliero

Parametro	Tipo	Obbligatorio	Descrizione
dateTime	string	Sì	Data e ora nel formato YYYY-MM-DDTHH:mm
location	object	Sì	Posizione con latitudine, longitudine, fuso orario
aspects	array	No	Aspetti da considerare per il calcolo VOC

Endpoint Intervallo

Parametro	Tipo	Obbligatorio	Descrizione
startDate	string	Sì	Data di inizio nel formato YYYY-MM-DD
endDate	string	Sì	Data di fine nel formato YYYY-MM-DD (massimo 31 giorni)
location	object	Sì	Posizione con latitudine, longitudine, fuso orario
aspects	array	No	Aspetti da considerare per il calcolo VOC

Aspetti Disponibili

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

Risposta Giornaliera

{
  "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
      }
    ]
  }
}

Risposta per Intervallo

{
  "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"
      }
    ]
  }
}

Luna Vuota di Corso

La Luna Vuota di Corso (VOC) è il periodo in cui la Luna non forma più aspetti maggiori con i pianeti prima di entrare in un nuovo segno. Tradizionalmente questo periodo è considerato sfavorevole per iniziare nuove attività.

Come Viene Calcolata la VOC

1. Vengono determinate la posizione attuale della Luna e il suo segno
2. Viene calcolato il momento esatto in cui la Luna entra nel segno successivo
3. Vengono trovati tutti gli aspetti tra la Luna e i pianeti principali fino al cambio di segno
4. L'ultimo aspetto segna l'inizio del periodo VOC
5. Il periodo VOC termina quando la Luna entra nel nuovo segno

Campi dei Dati VOC

Campo	Descrizione
isVoid	Se la Luna è attualmente Vuota di Corso
start	Quando è iniziato il periodo VOC (orario dell'ultimo aspetto)
end	Quando termina la VOC (la Luna entra nel nuovo segno)
durationMinutes	Durata del periodo VOC in minuti
lastAspect	Dettagli dell'ultimo aspetto formato
nextSign	Il segno in cui entrerà la Luna

Casi d'Uso

• Astrologia Elettiva: Evita di iniziare attività importanti durante la Luna VOC
• Pianificazione per Fasi Lunari: Traccia i momenti ottimali per le attività in base alle fasi lunari
• Calendari Astrologici: Mostra i transiti nei segni e le fasi lunari
• Tempistica Rituale: Pianifica le attività in sintonia con i cicli lunari