Lá số Tử vi

Tính toán lá số tử vi hoàn chỉnh với vị trí hành tinh, điểm cung và các góc chiếu.

Tính toán Cơ bản

curl -X POST "https://api.astroapi.cloud/api/calc/natal" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "datetime": "1990-06-15T14:30:00",
    "latitude": 51.5074,
    "longitude": -0.1278,
    "timezone": "Europe/London"
  }'

Tham số

Tham số	Kiểu	Bắt buộc	Mô tả
datetime	string	Có	Ngày giờ theo ISO 8601
latitude	number	Có	Vĩ độ (-90 đến 90)
longitude	number	Có	Kinh độ (-180 đến 180)
timezone	string	Có	Mã định danh múi giờ IANA
houseSystem	string	Không	Hệ thống cung nhà (mặc định: "placidus")

Hệ thống Cung nhà

• placidus - Placidus (mặc định)
• koch - Koch
• equal - Cung Bằng nhau
• whole - Toàn Dấu hiệu
• campanus - Campanus
• regiomontanus - Regiomontanus
• porphyry - Porphyry

Phản hồi

{
  "data": {
    "type": "natal-chart",
    "attributes": {
      "planets": {
        "sun": { "longitude": 84.5, "latitude": 0, "sign": "gemini", "house": 10 },
        "moon": { "longitude": 245.2, "latitude": -3.1, "sign": "sagittarius", "house": 4 }
      },
      "houses": {
        "1": { "cusp": 180.5, "sign": "libra" },
        "2": { "cusp": 210.3, "sign": "scorpio" }
      },
      "aspects": [
        { "planet1": "sun", "planet2": "moon", "aspect": "opposition", "orb": 0.7 }
      ]
    }
  }
}

Các Thiên thể Được bao gồm

Theo mặc định, các thiên thể sau được bao gồm:

• Mặt Trời, Mặt Trăng
• Sao Thủy, Sao Kim, Sao Hỏa, Sao Mộc, Sao Thổ, Sao Thiên Vương, Sao Hải Vương, Sao Diêm Vương
• Bắc Giao điểm, Nam Giao điểm
• Chiron, Lilith (Mặt Trăng Đen)
• Phần May mắn

Mặt Trăng & Mặt Trời

Tính toán pha trăng, độ chiếu sáng, thời gian mọc/lặn và dữ liệu vị trí mặt trời.

POST /api/calc/moon-sun

curl -X POST "https://api.astroapi.cloud/api/calc/moon-sun" \
  -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"
    }
  }'

Tham số

Tham số	Kiểu	Bắt buộc	Mô tả
dateTime	string	Có	Ngày/giờ theo định dạng YYYY-MM-DDTHH:mm
location.latitude	number	Có	Vĩ độ (-90 đến 90)
location.longitude	number	Có	Kinh độ (-180 đến 180)
location.timezone	string	Có	Mã định danh múi giờ IANA

Module Bắt buộc

Endpoint này yêu cầu module module:moon.

Phản hồi

{
  "data": {
    "moon": {
      "phaseName": "Waxing Gibbous",
      "phase": 0.62,
      "illumination": 0.78,
      "age": 9.2,
      "distance": 384400,
      "diameterDegrees": 0.52,
      "rise": "2024-06-15T14:23:00Z",
      "set": "2024-06-16T02:15:00Z"
    },
    "sun": {
      "rise": "2024-06-15T05:18:00Z",
      "set": "2024-06-15T22:03:00Z",
      "transit": "2024-06-15T13:40:00Z",
      "distance": 151820000,
      "diameterDegrees": 0.524,
      "twilight": {
        "civil": {
          "begin": "2024-06-15T04:38:00Z",
          "end": "2024-06-15T22:43:00Z"
        },
        "nautical": {
          "begin": "2024-06-15T03:32:00Z",
          "end": "2024-06-15T23:49:00Z"
        },
        "astronomical": {
          "begin": null,
          "end": null
        }
      }
    }
  }
}

Độ chính xác Tính toán

AstroAPI sử dụng Swiss Ephemeris để tính toán có độ chính xác cao. Tất cả các vị trí được tính toán với độ chính xác đến giây cung.

Beta: Động cơ Tính toán Thay thế

Tính năng Thử nghiệm

Tính năng này đang trong giai đoạn beta và có thể có vấn đề về độ chính xác. Hãy thận trọng khi sử dụng trong môi trường sản xuất.

AstroAPI cung cấp một động cơ tính toán thay thế (calc2) sử dụng triển khai tùy chỉnh để đọc và đánh giá các tệp dữ liệu Swiss Ephemeris SE1 trực tiếp, thay vì sử dụng thư viện Swiss Ephemeris chính thức. Động cơ này được tối ưu hóa cho tốc độ và có thể cung cấp thời gian phản hồi nhanh hơn.

Để sử dụng động cơ thay thế, thêm header X-Use-Calc2 vào yêu cầu của bạn:

curl -X POST "https://api.astroapi.cloud/api/calc/natal" \
  -H "X-Api-Key: your-api-key" \
  -H "X-Use-Calc2: true" \
  -H "Content-Type: application/json" \
  -d '{
    "datetime": "1990-06-15T14:30:00",
    "latitude": 51.5074,
    "longitude": -0.1278,
    "timezone": "Europe/London"
  }'

Sự khác biệt Chính

Khía cạnh	Động cơ Chuẩn	Động cơ Calc2 (Beta)
Triển khai	Swiss Ephemeris	Triển khai tùy chỉnh
Nguồn Dữ liệu	Tệp ephemeris SE1	Tệp ephemeris SE1 (cùng dữ liệu)
Tốc độ	Chuẩn	Có thể nhanh hơn
Độ chính xác	Độ chính xác giây cung (tham chiếu)	Có thể có sai lệch nhỏ
Trạng thái	Sẵn sàng sản xuất	Beta

Khi nào Sử dụng Calc2

• Khuyến nghị cho: Ứng dụng khối lượng cao nơi tốc độ được ưu tiên hơn độ chính xác tuyệt đối
• Không khuyến nghị cho: Ứng dụng yêu cầu độ chính xác thiên văn tối đa

Hạn chế Đã biết

• Triển khai tùy chỉnh có thể tạo ra kết quả hơi khác so với thư viện Swiss Ephemeris chính thức
• Vẫn đang được phát triển và kiểm tra tích cực
• Kết quả nên được xác nhận so với động cơ chuẩn cho các ứng dụng quan trọng