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

API bản đồ địa lý tương đương

Một bản đồ địa lý chỉ suy ra bốn góc từ địa lý đơn thuần. Điểm không độ của Bạch Dương được cố định tại kinh tuyến Greenwich, mỗi độ kinh độ trở thành một độ hoàng đạo, và bất kỳ địa điểm nào trên Trái Đất đều có một Trung Thiên và một Mọc mà không cần thời gian sinh.

Endpoint
POST /v1/geodetic
Cost
10 credits
Latency
~121 ms
Tier
Tier 1
// 01 / What it computes

API bản đồ địa lý tương đương

Cho một vĩ độ và kinh độ, điểm cuối trả về Trung Thiên Địa lý, Đáy Trời, Mọc và Lưỡi Hài trong độ hoàng đạo, cùng với chỉ số cung và độ trong cung cho MC và Mọc. Hai trường phái được hỗ trợ. Sepharial, mặc định, ánh xạ kinh độ địa thẳng lên kinh độ hoàng đạo, do đó 30.52 độ đông là 0 độ 31 phút Kim Ngưu. Johndro áp dụng hiệu chỉnh độ nghiêng, làm thay đổi Mọc so với giá trị Sepharial và yêu cầu một năm hoặc độ nghiêng rõ ràng. Vì không có thông tin cá nhân nào tham gia tính toán, cùng một tọa độ luôn trả về cùng các góc, điều này làm cho điểm cuối dễ lưu vào cache và điểm neo tự nhiên cho tính năng dựa trên địa điểm thay vì cá nhân.

// 02 / Live request

POST/v1/geodetic

curl -X POST https://api.astroway.info/v1/geodetic \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
  "latitude": 50.45,
  "longitude": 30.52,
  "method": "sepharial"
}'
Response (excerpt)
{
  "ok": true,
  "data": {
    "mc": 30.52,
    "ic": 210.52,
    "asc": 317.7269,
    "dsc": 137.7269,
    "mcSign": 1,
    "mcDegree": 0.52,
    "ascSign": 10,
    "ascDegree": 17.7269,
    "method": "sepharial"
  }
}
// 03 / Parameters

Parameters

nametypeRequired
latitude number yes Place latitude, decimal degrees (north positive).
longitude number yes Place longitude, decimal degrees (east positive). This is what drives the geodetic MC.
method string no sepharial (default) maps longitude directly onto the zodiac; johndro applies an obliquity correction.
year number no Year used for the obliquity value in the johndro method. Ignored by sepharial.
obliquity number no Explicit obliquity in degrees, overriding the year-derived value.
// 04 / When to use it

When to use it

Sử dụng bản đồ địa lý trong công việc thế tục, nơi chủ thể là một quốc gia, một thành phố, hoặc một sự kiện thay vì một người. Các ứng dụng điển hình là kiểm tra nhật thực hoặc điểm nhập có rơi vào các góc địa lý của một thủ đô, xây dựng trang hồ sơ quốc gia cần bản đồ nhưng không có thời gian thành lập có thể bảo vệ được, và kiểm tra chéo bản đồ chiêm tinh địa lý với một phương pháp hoàn toàn độc lập. Nó cũng giải quyết một vấn đề thực tế trong sản phẩm tiêu dùng: khi người dùng không có thời gian sinh, hầu hết các điểm cuối bản đồ hoạt động kém, nhưng bản đồ địa lý cho thành phố hiện tại của họ vẫn được định nghĩa đầy đủ và vẫn nói điều cụ thể về địa điểm. Phản hồi nhỏ và xác định, do đó nó chỉ tốn một cuộc gọi cấp một và an toàn để tính toán cho cả danh sách các thành phố trong một lần.

// 05 / Notes

Notes

Sepharial và Johndro bất đồng theo thiết kế, không phải do lỗi; cả hai đều được trả về khi được yêu cầu thay vì một cái được trình bày như là chính thống. Kỹ thuật này bắt nguồn từ Sepharial đầu thế kỷ hai mươi và được mở rộng bởi L. Edward Johndro. Vì khung địa lý được cố định tại kinh tuyến Greenwich, kết quả ổn định theo thời gian và không cần tra cứu lịch thiên văn, đó là lý do đây là điểm cuối duy nhất trong gia đình chiêm tinh địa lý không phụ thuộc vào Swiss Ephemeris.

Try the Bản đồ Địa lý 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 →