AstroWay/api v2.173.1 · ko
모든 시스템 정상 작동 중
// astrology api · POST /v1/local-space

로컬 스페이스 점성술 API

로컬 스페이스는 천문지리학과 다른 질문을 합니다: 지구상에서 행성이 각이 있었던 위치가 아니라, 출생지에서 본 행성의 나침반 방향입니다. 엔드포인트는 모든 천체의 방위각과 고도를 반환하며, 해당 방향이 지구 표면에서 그리는 대원 경로도 함께 제공합니다.

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

로컬 스페이스 점성술 API

이 엔드포인트는 출생 점성도를 구축하고, 각 행성을 황도 좌표에서 출생지의 지평면 좌표로 변환하여, 참 북쪽으로부터 시계 방향으로 측정된 방위각(도)과 지평선 위 또는 아래의 고도를 함께 반환합니다. 그런 다음 각 방위각을 출생지에서 시작하는 대원으로 투영하고, 결과 경로를 일련의 좌표로 반환하여, 세계 지도에 그린 선이 평면 투영에서의 직선이 아닌 실제 방향을 유지하도록 합니다. 열세 개의 천체가 다루어지며, 각각 안정적인 색상을 가지므로 렌더링된 지도는 제품군의 다른 부분과 동일한 팔레트를 유지합니다. 여기서 고도는 방위각만큼 중요합니다: 출생 시 지평선 아래에 있는 행성은 같은 방향으로 하늘 높은 곳에 있는 행성과 다르게 해석됩니다.

// 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

제품이 지구상의 절대 위치보다는 고정된 집에서의 방향과 거리에 관한 경우 로컬 스페이스를 사용하세요. 두 가지 주요 사례가 있습니다. 첫 번째는 모든 규모의 이주로, 유리한 방향에 있는 도시 선택부터 한 국가 내 이동 방향 결정에 이르기까지입니다. 이는 출생지에서 시작하는 대원이 소수의 천문지리학 자오선보다 훨씬 더 많은 사용 가능한 영역을 통과하기 때문입니다. 두 번째는 건물 내부에서 실내 규모로 동일한 방위각을 읽는 내부 및 현장 작업입니다: 엔드포인트는 방향을 반환하고, /local-space/influence-zone 동반 기능은 이 중 하나를 그릴 수 있는 원뿔 다각형으로 변환합니다. 이미 천문지리학을 렌더링하고 있다면, 로컬 스페이스를 추가하는 것은 동일한 출생 입력과 지도 표면을 사용하므로 이주 기능의 깊이를 두 배로 늘리는 가장 저렴한 방법입니다.

// 05 / Notes

Notes

위치는 WASM로 컴파일된 Swiss Ephemeris(Astrodienst)에서 가져옵니다. 방위각은 자북이 아니라 진북을 기준으로 시계 방향으로 측정되므로, 자북 편차 보정은 적용되거나 필요하지 않습니다. 대원 경로는 공식이 아닌 샘플링된 좌표로 반환되어, 클라이언트가 구면 기하학을 처리할 필요가 없습니다. 이 형태의 기술은 Michael Erlewine에 의해 개발되었으며 그의 Astrophysical Directions에 문서화되어 있습니다.

Try the 로컬 스페이스 API

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

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