AstroWay/api v2.201.7 · id
semua sistem normal
// astrology api · POST /v1/heliocentric

API Diagram Heliocentric

Pindahkan pengamat ke Matahari. Alih-alih biasanya langka berpusat di Bumi, ini mengembalikan tata surya seperti yang dilihat dari Matahari - Bumi menjadi benda, Bulan dan Ascendant menghilang, dan setiap planet diberikan dalam lintang heliosentris. Lewati momen, dapatkan diagram heliosentris. Presisi Swiss Ephemeris, JSON keluar.

Endpoint
POST /v1/heliocentric
Cost
20 credits
Latency
~63 ms
Tier
Tier 2
// 01 / What it computes

API Diagram Heliocentric

Endpoint heliosentris menyelesaikan tanggal, waktu, dan offset UTC yang disediakan menjadi hari Julian, kemudian meminta mesin Swiss Ephemeris untuk posisi planet yang dirujuk ke pusat Matahari daripada Bumi. Dalam kerangka ini Bumi muncul sebagai benda mengorbit dengan lintangnya sendiri, sementara Bulan - yang mengorbit Bumi, bukan Matahari - dan Ascendant geosentris dan Midheaven tidak memiliki arti dan dihilangkan. Respon mengembalikan lintang heliosentris planet dan grid aspek lengkap yang dihitung di antara mereka, dengan bendera menerapkan dan memisahkan serta orb tepat. Karena gerakan heliosentris adalah stabil dan bebas dari loop retrograde dan paralaks yang diperkenalkan oleh orbit Bumi sendiri, jarak planet membaca sangat berbeda dari diagram geosentris - posisi mencerminkan geometri orbital sejati di sekitar Matahari.

// 02 / Live request

POST/v1/heliocentric

curl -X POST https://api.astroway.info/v1/heliocentric \
  -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": {
    "input": {},
    "planets": [
      {
        "name": "Earth",
        "longitude": 234.2
      },
      {
        "name": "Mars",
        "longitude": 9.1
      }
    ],
    "aspects": [
      {
        "planet1": "Earth",
        "planet2": "Jupiter",
        "type": "trine",
        "orb": 0.9
      }
    ]
  }
}
// 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

Gunakan diagram heliosentris dalam konteks penelitian, keuangan, dan duniawi di mana pandangan berpusat pada Matahari adalah standar analitis - model timing pasar yang melacak sudut planet heliosentris, studi duniawi tentang siklus planet, atau analisis apa pun yang ingin geometri orbital tanpa distorsi retrograde geosentris. Ini juga berguna sebagai overlay kontras untuk diagram konvensional, karena planet yang tampak retrograde dari Bumi hany Bergerak maju di sekitar Matahari di sini. Karena tidak ada Bulan, tidak ada Ascendant, dan tidak ada rumah dalam arti geosentris, perlakukan output sebagai dataset lintang-planet-dan-aspek daripada diagram natal pribadi - ini menjawab pertanyaan tentang siklus dan konfigurasi, bukan tentang tanda naik individu.

// 05 / Notes

Notes

Ini adalah kerangka berpusat pada Matahari: Bumi dikembalikan sebagai benda, dan Bulan, Ascendant geosentris, dan Midheaven tidak ada secara konstruksi. Gerakan retrograde menghilang karena itu adalah artifak dari melihat dari Bumi yang bergerak. Output paling baik dibaca sebagai lintang heliosentris ditambah grid aspek mereka untuk pekerjaan siklus dan duniawi, bukan sebagai diagram pribadi. Lintang tropis dan Swiss Ephemeris sepanjang waktu.

Try the Diagram Heliocentric API

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

99.9% SLA · paket berbayar · 30d status →