AstroWay/api v2.204.0 · ko
모든 시스템 정상 작동 중
// astrology api · POST /v1/astrocartography

천문지도학 API

천문지도학은 단일 출생 순간을 전 지구에 투영합니다: 행성이 하늘에서 어디에 있었는지 묻는 대신, 각 행성이 지구상에서 어떤 각도로 있었는지를 묻습니다. 엔드포인트는 세계 지도에 그려볼 선형 기하학을 반환하며, 어떤 경도가 어떤 행성 에너지를 활성화하는지 보여줍니다.

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

천문지도학 API

출생 날짜, 시계 시간, UTC 오프셋, 출생 좌표로부터 엔드포인트는 해당 순간의 정확한 하늘을 고정한 다음, 네 개의 각 중 하나에 행성이 서 있었던 모든 자오선과 곡선을 찾기 위해 지구를 훑습니다. 열 개의 행성과 노드 각각에 대해 네 가지 선 계열을 추적합니다: 천정선(Ascendant)에 천체가 있었던 상승선, 하강선(Descendant)에 있었던 하강선, 중천선(Midheaven)에 있었던 중천선, 그리고 천저선(Imum Coeli)에 있었던 천저선입니다. MC와 IC 선은 깨끗한 자오선으로 실행되며, AC와 DC 선은 위도에 따라 곡선으로 굽습니다. 왜냐하면 한 위도에서 정동에서 떠오른 천체는 다른 위도에서는 훨씬 북쪽이나 남쪽에서 떠오르기 때문입니다. 모든 것은 직렬화 가능한 선형 기하학으로 data.lines 아래에 반환되며, 이는 매핑 라이브러리에 직접 공급할 준비가 되어 있습니다. 이것은 Jim Lewis가 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

위치가 변수이고 차트가 지도 전체에서 어떻게 재표현되는지 알고 싶을 때 이 엔드포인트를 사용하세요 - 재배치 조언, 여행 및 거주지 도구, 또는 개인의 차트를 지구에 겹치는 모든 기능에 사용합니다. 이것은 상호작용 지도의 자연스러운 백엔드입니다: 출생 순간에 대해 한 번 선을 요청하고, 이를 폴라인으로 렌더링하며, 사용자가 대륙을 훑어 어떤 행성이 어떤 통로를 지배하는지 읽을 수 있게 합니다. 출력이 서술이 아닌 순수한 기하학이므로, 이것은 당신 자신의 프론트엔드 스타일링, 클러스터링 및 클릭해 해석하는 레이어와 깨끗하게 조합됩니다. 홈 차트 구조와 재배치 선을 나란히 원할 때는 출생 차트 호출과 함께 사용하세요; 두 호출은 동일한 출생 해상도를 공유하므로 지도 뒤의 행성 위치는 정확히 일치합니다.

// 05 / Notes

Notes

위치는 Swiss Ephemeris(Astrodienst)에서 왔으며, 출생 엔드포인트 뒤의 동일한 엔진이므로 선은 동일한 행성 경도에 고정됩니다. 각도는 열대 황도대에서 계산됩니다. 응답은 기하학만을 전달합니다 - 세계 지도의 그리기, 투영 및 스타일링은 클라이언트에 맡겨집니다.

Try the 천문지도학 API

Grab a key and make your first call in under a minute.

99.9% SLA · 유료 플랜 · 30일 상태 →