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

API Astrocartography

Astrocartography lấy một thời điểm sinh và chiếu nó lên toàn bộ hành tinh: thay vì hỏi các hành tinh ở đâu trên bầu trời, nó hỏi rằng trên Trái Đất mỗi hành tinh ở góc độ nào. Endpoint trả về hình học đường bạn vẽ trên bản đồ thế giới để xem kinh độ nào kích hoạt năng lượng hành tinh nào.

Endpoint
POST /v1/astrocartography
Cost
50 credits
Latency
~76 ms
Tier
Tier 3
// 01 / What it computes

API Astrocartography

Từ ngày sinh, giờ, UTC offset, và tọa độ sinh, endpoint xác định bầu trời chính xác cho thời điểm đó, sau đó quét toàn cầu để tìm mọi kinh độ và đường cong mà một hành tinh đứng trên một trong bốn góc. Đối với mỗi trong mười hành tinh cộng với các nút, nó vẽ bốn loại đường: đường lên nơi cơ thể nằm trên Mọc, đường xuống trên Lặn, đường đỉnh trên Trung Thiên, và đường đáy trên Hạ Thiên. Đường MC và IC chạy như các kinh tuyến sạch; đường AC và DC cong như các đường phụ thuộc vĩ độ, vì một cơ thể mọc thẳng hướng đông ở một vĩ độ sẽ mọc ở phía bắc hoặc nam xa ở vĩ độ khác. Mọi thứ được trả về dưới dạng hình học đường có thể tuần tự hóa dưới data.lines, sẵn sàng đưa trực tiếp vào thư viện bản đồ. Đây là kỹ thuật định vị được Jim Lewis phổ biến với tên Astro*Carto*Graphy.

// 02 / Live request

POST/v1/astrocartography

curl -X POST https://api.astroway.info/v1/astrocartography \
  -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": {
    "lines": [
      {
        "planet": "Venus",
        "type": "MC",
        "longitude": 14.2
      },
      {
        "planet": "Jupiter",
        "type": "AC",
        "points": [
          "…"
        ]
      }
    ]
  }
}
// 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 (e.g. 3 for Kyiv summer time). Decimal allowed for half-hour zones.
latitude number yes Birth-place latitude, decimal degrees (north positive).
longitude number yes Birth-place longitude, decimal degrees (east positive).
// 04 / When to use it

When to use it

Sử dụng endpoint này khi vị trí là biến số và bạn muốn biết biểu đồ biểu đạt lại bản thân như thế nào trên bản đồ - để tư vấn định vị, công cụ du lịch và nơi ở, hoặc bất kỳ tính năng nào phủ biểu đồ của một người lên quả cầu. Nó là backend tự nhiên cho một bản đồ tương tác: yêu cầu đường một lần cho một thời điểm sinh, hiển thị chúng dưới dạng đa tuyến, và để người dùng di chuyển qua các lục địa để đọc hành tinh nào cai quản hành lang nào. Vì đầu ra là hình học thuần túy thay vì văn bản, nó kết hợp sạch với kiểu dáng front-end, cụm, và lớp nhấp để giải thích của riêng bạn. Ghép nó với lệnh biểu đồ sinh khi bạn muốn cả cấu trúc biểu đồ nhà và các đường định vị cạnh nhau; hai cái này chia cùng độ phân giải sinh, vì vậy vị trí hành tinh sau bản đồ đồng ý chính xác.

// 05 / Notes

Notes

Vị trí đến từ Swiss Ephemeris (Astrodienst), cùng động cơ đằng sau các endpoint biểu đồ sinh, vì vậy các đường neo vào cùng kinh độ hành tinh. Góc tính được trong hoàng đạo nhiệt đới. Phản hồi chỉ mang hình học - việc vẽ, chiếu và kiểu dáng bản đồ thế giới để lại cho client của bạn.

Try the Astrocartography 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 →