Lịch Mặt Trăng

Tính toán thông tin pha trăng, các giai đoạn Mặt Trăng Trống (Void of Course), quá độ cung và các góc chiếu mặt trăng sắp tới.

Chi tiết Ngày

Lấy thông tin mặt trăng chi tiết cho một ngày cụ thể:

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

Phạm vi Ngày

Lấy tổng quan lịch mặt trăng cho một phạm vi ngày (tối đa 31 ngày):

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

Tham số

Endpoint Ngày

Tham số	Kiểu	Bắt buộc	Mô tả
dateTime	string	Có	Ngày và giờ theo định dạng YYYY-MM-DDTHH:mm
location	object	Có	Vị trí với vĩ độ, kinh độ, múi giờ
aspects	array	Không	Các góc chiếu cần xem xét cho tính toán VOC

Endpoint Phạm vi

Tham số	Kiểu	Bắt buộc	Mô tả
startDate	string	Có	Ngày bắt đầu theo định dạng YYYY-MM-DD
endDate	string	Có	Ngày kết thúc theo định dạng YYYY-MM-DD (tối đa 31 ngày)
location	object	Có	Vị trí với vĩ độ, kinh độ, múi giờ
aspects	array	Không	Các góc chiếu cần xem xét cho tính toán VOC

Các Góc chiếu Có sẵn

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

Phản hồi Ngày

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

Phản hồi Phạm vi

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

Mặt Trăng Trống (Void of Course)

Mặt Trăng Trống (VOC) là giai đoạn khi Mặt Trăng không tạo thêm góc chiếu chính nào với các hành tinh trước khi vào cung mới. Giai đoạn này theo truyền thống được coi là không thuận lợi để bắt đầu các dự án mới.

Cách Tính VOC

1. Xác định vị trí và cung hiện tại của Mặt Trăng
2. Tính toán thời điểm chính xác khi Mặt Trăng vào cung tiếp theo
3. Tìm tất cả các góc chiếu giữa Mặt Trăng và các hành tinh chính cho đến khi đổi cung
4. Góc chiếu cuối cùng đánh dấu sự bắt đầu của giai đoạn VOC
5. Giai đoạn VOC kết thúc khi Mặt Trăng vào cung mới

Các Trường Dữ liệu VOC

Trường	Mô tả
isVoid	Liệu Mặt Trăng hiện tại có đang Trống không
start	Khi giai đoạn VOC bắt đầu (thời gian góc chiếu cuối cùng)
end	Khi VOC kết thúc (Mặt Trăng vào cung mới)
durationMinutes	Độ dài giai đoạn VOC tính bằng phút
lastAspect	Chi tiết về góc chiếu cuối cùng được tạo ra
nextSign	Cung mà Mặt Trăng sẽ vào tiếp theo

Trường hợp Sử dụng

• Chiêm tinh học Bầu cử: Tránh bắt đầu các hoạt động quan trọng trong Mặt Trăng Trống
• Lập kế hoạch theo Pha Trăng: Theo dõi thời điểm tối ưu cho các hoạt động dựa trên các pha mặt trăng
• Lịch Chiêm tinh học: Hiển thị quá độ cung và pha mặt trăng
• Thời điểm Nghi lễ: Lên kế hoạch các hoạt động phù hợp với chu kỳ mặt trăng