Ay Takvimi

Ay evresi bilgilerini, Boşlukta Ay dönemlerini, burç geçişlerini ve yaklaşan ay açılarını hesaplayın.

Gün Detayı

Belirli bir gün için ayrıntılı ay bilgisi alın:

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

Tarih Aralığı

Bir tarih aralığı için ay takvimi özetini alın (maksimum 31 gün):

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

Parametreler

Gün Uç Noktası

Parametre	Tür	Zorunlu	Açıklama
dateTime	string	Evet	YYYY-MM-DDTHH:mm biçiminde tarih ve saat
location	object	Evet	Enlem, boylam, saat dilimi ile konum
aspects	array	Hayır	VOC hesaplaması için dikkate alınacak açılar

Aralık Uç Noktası

Parametre	Tür	Zorunlu	Açıklama
startDate	string	Evet	YYYY-MM-DD biçiminde başlangıç tarihi
endDate	string	Evet	YYYY-MM-DD biçiminde bitiş tarihi (maksimum 31 gün)
location	object	Evet	Enlem, boylam, saat dilimi ile konum
aspects	array	Hayır	VOC hesaplaması için dikkate alınacak açılar

Mevcut Açılar

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

Gün Yanıtı

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

Aralık Yanıtı

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

Boşlukta Ay

Boşlukta Ay (VOC), Ay'ın yeni bir burca girmeden önce gezegenlerle daha fazla önemli açı yapmadığı dönemdir. Bu dönem geleneksel olarak yeni girişimler başlatmak için uygunsuz kabul edilir.

VOC Nasıl Hesaplanır

1. Ay'ın mevcut konumu ve burcu belirlenir
2. Ay'ın bir sonraki burca gireceği tam zaman hesaplanır
3. Burç değişimine kadar Ay ile büyük gezegenler arasındaki tüm açılar bulunur
4. Son açı VOC döneminin başlangıcını işaret eder
5. Ay yeni burca girdiğinde VOC dönemi sona erer

VOC Veri Alanları

Alan	Açıklama
isVoid	Ay'ın şu anda boşlukta olup olmadığı
start	VOC döneminin başlangıcı (son açı zamanı)
end	VOC'un sonu (Ay yeni burca girer)
durationMinutes	VOC döneminin dakika cinsinden uzunluğu
lastAspect	Yapılan son açının ayrıntıları
nextSign	Ay'ın gireceği bir sonraki burç

Kullanım Alanları

• Elektif Astroloji: Önemli faaliyetlere Boşlukta Ay döneminde başlamaktan kaçının
• Ay Evresi Planlaması: Ay evrelerine göre faaliyetler için en uygun zamanları takip edin
• Astrolojik Takvimler: Ay burç geçişlerini ve evrelerini görüntüleyin
• Ritüel Zamanlama: Ay döngüleriyle uyumlu faaliyetler planlayın