AstroWay/api v2.173.1 · vi
tất cả hệ thống hoạt động bình thường
// astrology api · POST /v1/local-space

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.

Endpoint
POST /v1/local-space
Cost
50 credits
Latency
~216 ms
Tier
Tier 3
// 01 / What it computes

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.

// 02 / Live request

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
}'
Response (excerpt)
{
  "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 }, "…"]
      }
    ]
  }
}
// 03 / Parameters

Parameters

nametypeRequired
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).
// 04 / When to use it

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 đồ.

// 05 / Notes

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.

99,9% SLA · gói trả phí · 30 ngày trạng thái →