API diễn giải Astrocartography
Đường hình học đơn lẻ không cho người dùng biết mình nên di chuyển đâu. Endpoint này nhận một lĩnh vực cuộc sống, chọn các đường astrocartography thực sự chi phối nó, xếp hạng chúng theo mức độ mạnh và mức độ gần gũi, và trả về văn bản diễn giải cho mỗi đường. Một lần gọi thay thế việc ánh xạ hành tinh-đối-chủ đề mà mọi sản phẩm relocation phải tự tạo.
API diễn giải Astrocartography
Endpoint tính toàn bộ bộ astrocartography cho thời điểm sinh, sau đó lọc qua taxonomy gồm mười chín lĩnh vực cuộc sống dựa trên tài liệu nền tảng của kỹ thuật: Jim Lewis cho ý nghĩa hành tinh-trên-góc, Erin Sullivan cho những gì bốn góc điều khiển, và Martin Davis cho cách xử lý các đường khó. Mỗi lĩnh vực đặt tên các đường thuộc nó với trọng số từ một tới ba, nên Mặt Trời trên Đỉnh Midheaven vượt trội hơn Sao Thủy trên cùng góc cho sự nghiệp. Mỗi ánh xạ còn có polarity, và các đường thách thức được trả về cùng với các đường hỗ trợ thay vì bị lọc, vì công cụ relocation chỉ hiển thị các đường thuận lợi sẽ làm sai lệch kỹ thuật. Khi bạn truyền một điểm, các đường ngoài bán kính bị loại và độ mạnh trả về nhân trọng số chiêm tinh với khoảng cách địa lý, cho phép bạn xếp hạng các thành phố ứng viên thay vì chỉ liệt kê các đường. Văn bản diễn giải được cung cấp từ knowledge base được biên tập, bao phủ tất cả bốn mươi kết hợp hành tinh-góc bằng mười một ngôn ngữ, với fallback được ghi chép khi thiếu bản dịch.
POST/v1/acg/by-category
curl -X POST https://api.astroway.info/v1/acg/by-category \
-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,
"category": "career",
"point": { "lat": 51.5074, "lng": -0.1278 },
"radiusDeg": 8,
"language": "en"
}' {
"ok": true,
"data": {
"category": { "id": "career", "name": "Career" },
"language": "en",
"count": 3,
"lines": [
{
"planet": "Jupiter",
"type": "MC",
"weight": 3,
"polarity": "supportive",
"strength": 2.31,
"distanceDeg": 1.84,
"pointCount": 341,
"segments": [
[[-85, 110.48], [-84.5, 110.48], "…"]
],
"interpretation": {
"title": "Jupiter - MC",
"text": "Expansion of professional opportunity…",
"lang": "en"
}
}
]
}
} 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. |
| latitude | number | yes | Birth-place latitude, decimal degrees. |
| longitude | number | yes | Birth-place longitude, decimal degrees. |
| category | string | yes | One of 19 life areas: career, love, money, health, home, learning, power, travel and more. Fetch the full list from GET /v1/acg/categories. |
| point | { lat, lng } | no | Optional geographic focus. With it, only lines running within radiusDeg of that point are returned and strength folds in proximity. |
| radiusDeg | number | no | Search radius in degrees around point. Default 4, range 0.5 to 20. |
| polarity | string | no | supportive, challenging, or all (default). Challenging lines are returned by default rather than hidden. |
| includeText | boolean | no | Attach the interpretation text for each line. Default true. |
| includeCoordinates | boolean | no | Attach the line geometry as `segments`, an array of `[lat, lng]` polylines. A rising or setting curve is several disjoint segments, so they are kept separate rather than concatenated. Default true; set false for a compact ranking response. |
| language | string | no | Interpretation language. Falls back to English then Ukrainian when a translation is missing, and the served language is reported per line. |
When to use it
Sử dụng khi sản phẩm của bạn trả lời câu hỏi bằng ngôn ngữ thường: mình nên đi đâu để làm việc, trong ba thành phố nào tốt nhất cho mối quan hệ, đường này trên thành phố mình thực sự có nghĩa là gì. Ba dạng bao phủ hầu hết các build. Xếp hạng bằng cách gửi một category và một point cho mỗi thành phố ứng viên rồi sắp xếp theo strength. Giải thích bằng cách gọi /v1/acg/line-report cho một hành tinh và góc duy nhất để lấy toàn bộ text cộng với mọi lĩnh vực cuộc sống khác mà đường đó chạm tới. Khám phá bằng cách GET /v1/acg/categories một lần khi không có credit và xây UI từ taxonomy trả về để category mới xuất hiện mà không cần phát hành client. Vì text được biên tập chứ không sinh ra, phản hồi quyết định, không trích dẫn model, và không tốn thêm chi phí inference: cùng một request sẽ trả về cùng từ ngày mai.
Notes
Taxonomy bao phủ mười thiên thể truyền thống. Chiron, Lilith và các nút mặt trăng xuất hiện trong geometry /v1/acg nhưng được để ngoài mapping cố ý, vì kỹ thuật do Jim Lewis định nghĩa không gán chúng quyền lực góc-lĩnh vực cuộc sống. Trọng số và polarity là phán đoán biên tập được biểu thị dưới dạng dữ liệu, versioned trong repository và có thể audit thay vì ẩn trong prompt. Văn bản diễn giải là tra cứu knowledge-base, không phải lời gọi language-model, vì vậy nó ổn định, có thể tái tạo offline và không có các disclaimer mà diễn giải sinh ra yêu cầu.
Try the Diễn giải Astrocartography API
Grab a key and make your first call in under a minute.