Local Space API chiêm tinh
Local space đặt ra một câu hỏi khác so với astrocartography: không phải là một hành tinh ở đâu trên Trái Đất là góc, mà là nó đứng ở hướng la bàn nào từ nơi sinh. Endpoint trả về một phương vị và một độ cao cho mỗi thiên thể, cùng với đường tròn lớn mà hướng đó vẽ trên toàn cầu.
Local Space API chiêm tinh
Endpoint xây dựng bản đồ sinh, chuyển đổi mỗi hành tinh từ tọa độ hoàng đạo vào khung đường chân trời của vị trí sinh, và trả về phương vị của nó theo độ theo chiều kim đồng hồ từ true north cùng với độ cao trên hoặc dưới đường chân trời. Sau đó, nó chiếu mỗi phương vị như một đường tròn lớn từ nơi sinh và trả về đường kết quả như một chuỗi tọa độ, để một đường được vẽ trên bản đồ thế giới vẫn là phương vị thực chứ không phải là đường thẳng trên phép chiếu phẳng. Mười ba thiên thể được bao gồm, mỗi cái mang một màu sắc ổn định để bản đồ được kết xuất giữ cùng bảng màu với phần còn lại của bộ. Độ cao quan trọng như phương vị ở đây: một hành tinh dưới đường chân trời khi sinh được đọc khác với một cái cao trên bầu trời cùng hướng.
POST/v1/local-space
curl -X POST https://api.astroway.info/v1/local-space \
-H "X-Api-Key: aw_live_..." \
-H "Content-Type: application/json" \
-d '{
"date": "1990-05-15",
"time": "14:30:00",
"timezoneOffset": 3,
"latitude": 50.45,
"longitude": 30.52
}' {
"ok": true,
"data": {
"birthplace": { "latitude": 50.45, "longitude": 30.52 },
"count": 13,
"lines": [
{
"planetId": 0,
"planetName": "Sun",
"azimuth": 219.8018,
"altitude": 53.1309,
"color": "#FFB300",
"points": [{ "lat": 50.45, "lng": 30.52 }, "…"]
}
]
}
} Parameters
| name | type | Required | |
|---|---|---|---|
| date | string (YYYY-MM-DD) | yes | Birth date. |
| time | string (HH:MM:SS) | yes | Local clock time at birth. |
| timezoneOffset | number (hours) | yes | UTC offset in effect at the birth moment. Decimal allowed for half-hour zones. |
| latitude | number | yes | Birth-place latitude, decimal degrees (north positive). Local space is anchored here, so this is not optional. |
| longitude | number | yes | Birth-place longitude, decimal degrees (east positive). |
When to use it
Sử dụng local space khi sản phẩm là về hướng và khoảng cách từ một nhà cố định thay vì vị trí tuyệt đối trên Trái Đất. Hai trường hợp chiếm ưu thế. Thứ nhất là di chuyển ở bất kỳ quy mô nào, từ chọn thành phố nào nằm theo hướng có lợi đến quyết định di chuyển theo hướng nào trong một quốc gia, vì một đường tròn lớn từ nơi sinh đi qua nhiều lãnh thổ sử dụng hơn một vài kinh tuyến astrocartography. Thứ hai là công việc nội thất và công trình, cùng các phương vị được đọc ở quy mô phòng trong một ngôi nhà: endpoint trả về các phương vị, và /local-space/influence-zone đồng hành biến một trong số đó thành một hình nón đa giác bạn có thể vẽ. Nếu bạn đã kết xuất astrocartography, thêm local space là cách rẻ nhất để gấp đôi độ sâu của một tính năng di chuyển, vì nó sử dụng cùng đầu vào sinh và cùng bề mặt bản đồ.
Notes
Vị trí đến từ Swiss Ephemeris (Astrodienst) biên dịch thành WASM. Phương vị được đo theo chiều kim đồng hồ từ true north, không phải north từ tính, vì vậy không cần áp dụng hoặc hiệu chỉnh declination. Đường tròn lớn được trả về như tọa độ mẫu thay vì công thức, điều này giữ cho client không bị ảnh hưởng bởi hình học cầu. Kỹ thuật trong hình thức này được phát triển bởi Michael Erlewine và được tài liệu hóa trong Astrophysical Directions của ông.
Try the Local Space API
Grab a key and make your first call in under a minute.