Hiển thị Lá số

Tạo hình ảnh lá số SVG và PNG đẹp mắt.

Lá số SVG

Tạo lá số tử vi SVG bằng các tham số truy vấn:

curl -X GET "https://api.astroapi.cloud/api/chart/image.svg?width=800&height=800&dateTime=1990-06-15T14:30&location.longitude=-0.1278&location.latitude=51.5074&location.timezone=Europe/London" \
  -H "X-Api-Key: your-api-key"

Lá số PNG

Chuyển đổi sang định dạng PNG:

curl -X GET "https://api.astroapi.cloud/api/chart/image.png?width=800&height=800&dateTime=1990-06-15T14:30&location.longitude=-0.1278&location.latitude=51.5074&location.timezone=Europe/London" \
  -H "X-Api-Key: your-api-key" \
  --output chart.png

Các Loại Lá số

Endpoint	Mô tả
/api/chart/image.svg	Lá số tử vi dạng SVG
/api/chart/image.png	Lá số tử vi dạng PNG
/api/chart/image.svg với tham số transit.*	Lá số hai vòng quá độ
/api/chart/composite.svg	Lá số kết hợp (trung điểm)
/api/chart/composite.png	Lá số kết hợp dạng PNG

Lá số Hai vòng Quá độ

Thêm các tham số quá độ để hiển thị lá số hai vòng với vòng tử vi (trong) và vòng quá độ (ngoài):

curl -X GET "https://api.astroapi.cloud/api/chart/image.svg?width=800&height=800&dateTime=1990-06-15T14:30&location.longitude=-0.1278&location.latitude=51.5074&location.timezone=Europe/London&transit.dateTime=2024-01-15T12:00&transit.timezone=Europe/London" \
  -H "X-Api-Key: your-api-key"

Tham số Quá độ

Tham số	Bắt buộc	Mô tả
transit.dateTime	Có	Ngày/giờ quá độ (YYYY-MM-DDTHH:mm)
transit.timezone	Có	Múi giờ quá độ
transit.longitude	Không	Kinh độ vị trí quá độ (mặc định là tử vi)
transit.latitude	Không	Vĩ độ vị trí quá độ (mặc định là tử vi)

Lá số Kết hợp

Tạo lá số kết hợp cho thấy các trung điểm giữa hai lá số tử vi:

curl -X GET "https://api.astroapi.cloud/api/chart/composite.svg?width=800&height=800&person1.dateTime=1990-06-15T14:30&person1.timezone=Europe/London&person1.longitude=-0.1278&person1.latitude=51.5074&person2.dateTime=1988-03-22T09:15&person2.timezone=Europe/Paris&person2.longitude=2.3522&person2.latitude=48.8566" \
  -H "X-Api-Key: your-api-key"

Tham số Truy vấn

Tham số Lá số Tử vi

Tham số	Bắt buộc	Mô tả
width	Có	Chiều rộng lá số tính bằng pixel
height	Có	Chiều cao lá số tính bằng pixel
dateTime	Có	Ngày/giờ sinh (YYYY-MM-DDTHH:mm)
location.longitude	Có	Kinh độ nơi sinh
location.latitude	Có	Vĩ độ nơi sinh
location.timezone	Có	Múi giờ nơi sinh (định dạng IANA)

Tham số Lá số Kết hợp

Tham số	Bắt buộc	Mô tả
width	Có	Chiều rộng lá số tính bằng pixel
height	Có	Chiều cao lá số tính bằng pixel
person1.dateTime	Có	Ngày/giờ sinh của người 1
person1.timezone	Có	Múi giờ của người 1
person1.longitude	Có	Kinh độ của người 1
person1.latitude	Có	Vĩ độ của người 1
person2.dateTime	Có	Ngày/giờ sinh của người 2
person2.timezone	Có	Múi giờ của người 2
person2.longitude	Có	Kinh độ của người 2
person2.latitude	Có	Vĩ độ của người 2

Header Phản hồi

Các endpoint lá số trả về các loại nội dung phù hợp:

• SVG: image/svg+xml
• PNG: image/png

Nhúng Lá số

Sử dụng SVG được trả về trực tiếp trong HTML:

<div class="chart-container">
  <!-- Nội dung SVG từ API -->
</div>

Hoặc sử dụng làm nguồn hình ảnh với URL dữ liệu:

<img src="data:image/svg+xml;base64,..." alt="Natal Chart" />

Chart2 - Thế hệ Lá số Tiếp theo

AstroAPI cung cấp công cụ hiển thị lá số thế hệ tiếp theo với hỗ trợ giao diện và hoạt ảnh.

Các Endpoint

Endpoint	Mô tả	Module Bắt buộc
/api/chart2/natal.svg	Lá số tử vi (SVG)	module:natal-calc
/api/chart2/natal.png	Lá số tử vi (PNG)	module:natal-calc
/api/chart2/transit.svg	Lá số hai vòng quá độ (SVG)	module:transit-calc
/api/chart2/transit.png	Lá số hai vòng quá độ (PNG)	module:transit-calc
/api/chart2/synastry.svg	Lá số hợp tinh (SVG)	module:synastry-calc
/api/chart2/synastry.png	Lá số hợp tinh (PNG)	module:synastry-calc
/api/chart2/composite.svg	Lá số kết hợp (SVG)	module:synastry-calc
/api/chart2/composite.png	Lá số kết hợp (PNG)	module:synastry-calc
/api/chart2/animated-transit.svg	Quá độ hoạt ảnh (SVG)	module:transit-calc

Cách Sử dụng Cơ bản

curl -X GET "https://api.astroapi.cloud/api/chart2/natal.svg?width=800&height=800&dateTime=1990-06-15T14:30&location.longitude=4.89&location.latitude=52.37&location.timezone=Europe/Amsterdam&theme=dark" \
  -H "X-Api-Key: your-api-key"

Giao diện Có sẵn

Giao diện	Mô tả
default	Nền trắng cổ điển với các yếu tố có màu sắc
classic	Giao diện chiêm tinh học truyền thống
dark	Giao diện tối hiện đại với màu sắc sống động
minimal	Gọn gàng, ít nhiễu hình ảnh
colorful	Màu sắc hành tinh sống động
nextgen	Hiện đại với đường góc chiếu cong, hiệu ứng phát sáng và gradient
vintage	Phong cách giấy da/bản thảo cũ với tông màu sepia
neon	Cyberpunk với màu neon tươi sáng trên nền đen
pastel	Màu pastel nhẹ nhàng, bình yên
print	Tương phản cao đen/trắng, được tối ưu hóa cho in ấn

Ghi đè Giao diện

Tùy chỉnh các thuộc tính giao diện riêng lẻ qua tham số truy vấn:

Tham số	Mô tả
theme.background	Màu nền (hex)
theme.foreground	Màu tiền cảnh (hex)
theme.strokeOnly	Chế độ chỉ viền (true/false)
theme.symbolScale	Hệ số tỷ lệ ký hiệu
theme.showDegrees	Hiển thị nhãn độ (true/false)
theme.showHouseNumbers	Hiển thị số cung nhà (true/false)
theme.showRuler	Hiển thị thước đo (true/false)
theme.signBackgroundOpacity	Độ mờ nền cung (0-1)

Lá số Hợp tinh & Kết hợp

curl -X GET "https://api.astroapi.cloud/api/chart2/synastry.svg?width=800&height=800&person1.dateTime=1990-06-15T14:30&person1.timezone=Europe/Amsterdam&person1.longitude=4.89&person1.latitude=52.37&person2.dateTime=1992-03-20T09:15&person2.timezone=Europe/London&person2.longitude=-0.12&person2.latitude=51.50" \
  -H "X-Api-Key: your-api-key"

Quá độ Hoạt ảnh

Tạo SVG hoạt ảnh cho thấy sự tiến triển quá độ theo thời gian:

curl -X GET "https://api.astroapi.cloud/api/chart2/animated-transit.svg?width=800&height=800&dateTime=1990-06-15T14:30&location.longitude=4.89&location.latitude=52.37&location.timezone=Europe/Amsterdam&transit.dateTime=2025-01-01T12:00&transit.timezone=Europe/Amsterdam&target.dateTime=2025-12-31T23:59&animation.duration=3000" \
  -H "X-Api-Key: your-api-key"

Tham số	Mô tả
target.dateTime	Ngày kết thúc cho hoạt ảnh
animation.duration	Thời gian hoạt ảnh tính bằng mili giây
animation.easing	Hàm easing (mặc định: easeInOut)
animation.loop	Lặp lại hoạt ảnh (mặc định: false)