AstroWay/api v2.177.1 · id
semua sistem normal
// astrology api · POST /v1/local-space

Local space API astrologi

Local space menanyakan pertanyaan yang berbeda dari astrocartography: bukan di mana di Bumi sebuah planet berada di posisi angular, tetapi di arah kompas mana ia berdiri dari tempat lahir. Endpoint mengembalikan azimut dan ketinggian untuk setiap benda, ditambah lintasan lingkaran besar yang arahnya menelusup globe.

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

Local space API astrologi

Endpoint membangun chart natal, mengonversi setiap planet dari koordinat ekliptik ke kerangka horizon lokasi kelahiran, dan mengembalikan azimutnya dalam derajat searah jarum jam dari utara sejati bersamaan dengan ketinggiannya di atas atau di bawah horizon. Kemudian, endpoint memproyeksikan setiap azimut sebagai lingkaran besar ke luar dari tempat kelahiran dan mengembalikan lintasan hasilnya sebagai serangkaian koordinat, sehingga garis yang digambar pada peta dunia tetap menjadi bearing yang benar daripada garis lurus pada proyeksi datar. Tiga belas benda dibahas, masing-masing dengan warna yang stabil sehingga peta yang dirender mempertahankan palet yang sama dengan suite lainnya. Ketinggian dianggap sama pentingnya dengan azimut di sini: planet di bawah horizon saat lahir memiliki interpretasi yang berbeda dengan planet yang tinggi di langit pada arah yang sama.

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

Gunakan local space ketika produk berkaitan dengan arah dan jarak dari rumah tetap daripada posisi absolut di globe. Dua kasus mendominasi. Pertama adalah relokasi pada skala apa pun, dari memilih kota mana yang terletak sepanjang bearing yang menguntungkan hingga memutuskan cara bergerak dalam satu negara, karena lingkaran besar dari tempat kelahiran menyeberangi wilayah yang jauh lebih banyak daripada beberapa meridian astrocartography. Kedua adalah pekerjaan interior dan situs, di mana azimut yang sama dibaca pada skala ruang di dalam hunian: endpoint mengembalikan bearing, dan /local-space/influence-zone pendamping mengubah salah satunya menjadi poligon kerucut yang dapat digambar. Jika Anda sudah merender astrocartography, menambahkan local space adalah cara termurah untuk menggandakan kedalaman fitur relokasi, karena menggunakan input kelahiran yang sama dan permukaan peta yang sama.

// 05 / Notes

Notes

Posisi berasal dari Swiss Ephemeris (Astrodienst) yang dikompilasi ke WASM. Azimut diukur searah jarum jam dari utara sejati, bukan utara magnetik, sehingga tidak ada koreksi deklinasi yang diterapkan atau diperlukan. Lintasan lingkaran besar dikembalikan sebagai koordinat yang diambil sampelnya daripada sebagai rumus, yang menjaga klien bebas dari geometri bola. Teknik dalam bentuk ini dikembangkan oleh Michael Erlewine dan didokumentasikan dalam bukunya Astrophysical Directions.

Try the Local Space API

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

99.9% SLA · paket berbayar · 30d status →