Swiss Ephemeris API

İsviç Efeheris - astronomik hesaplamaların de-fakto standardı: Astrodienst (astro.com), Solar Fire, Kerykeion ve çoğu ciddi yazılımı kullanır. NASA JPL’den DE431 efeheridlerini okur ve süssekündel doğruluk sağlar. AstroWay API, ona doğrudan HTTP erişimi sağlar - C kütüphanesi olmadan, .se1 dosyaları olmadan, bellek yönetimi olmadan. Bir POST isteği, JSON yanıtı.

İsviç Efeheris API neden?

Self-host İsviç Efeheris demek: C kütüphanesini toplamak (veya WASM binağını), birkaç yüz megabayt .se1 dosyalarını depolamak, bunlarla güncel tutmak ve evin kuyruğunu, açıları, fazları gerçekleştirmek. API aracılığıyla tüm bu işler - yabancı bir sorun:

• Sıfır altyapı: Hiç binary, efeherid dosyaları veya soğuk başlangıç gecikmeleri. Hesaplamalar, Astrodienst’ten self-host C kütüphanesi gibi aynı motor üzerinde yapılır.
• Süsekündel doğruluk: < 0.1″ Astrodienst’ten etalon swetest CGI karşılaştırıldığında, 873 dondurulmuş snapshot testleri ile doğrulanmıştır.
• Tam tarih aralığı: DE431, 13201 BCE – 17191 CE tarih aralığını kapsar, böylece tarihi ve uzak gelecekteki haritaların hesaplanması için doğruluk kaybedilmez.
• Pozisyonlar dahil: Efeheridler üzerinde aynı anda evlerin kuyruğu (15 sistem), açılar, karanlık, geçişler, gelişmeler - bu, self-host olduğunda kendin yazmak zorunda kalırdın.

İpucu

Doğruluk motoru, üç bağımsız kaynaktan (swetest CGI, Kerykeion, Prokerala) + NASA 5-Millennium Eclipse Katalogu karşılaştırıldığında üçüncül olarak doğrulanmıştır. Detaylar ve rakamlar - Hesaplamaların doğruluğu sayfasında.

İsviç Efeheris’de Ne Hesaplanır

Endpoint	Kredi	Ne döndürür
/v1/chart	20	Tam harita: gezegenler + evler + açılar
/v1/gezegenler	10	Geoçentrik gezegen pozisyonları (boylam, enlem, hız, retrograd)
/v1/evler	10	Evlerin kuyruğu - 15 sistem (Placidus, Koch, Whole Sign, Equal…)
/v1/geçişler	50	Geçişler için harita üzerinde bir tarih için
/v1/gelişmeler	50	İkinci gelişmeler (gündüz = yıl)
/v1/karanlık	100	Güneş ve Ay’ın karanlık
/v1/moon-fazası	10	Ay’ın faza, aydınlatma, sonraki kuartiller
/v1/dönen yıldızlar	20	Gezegenler ile sabit yıldızlar arasındaki konjeksiyonlar

Bu, 760 platformunun eklentisi olan 760 eklentilerinin tam listesidir - tam liste için API rehberi.

Örnek

cURL

curl -X POST https://api.astroway.info/v1/planets \
  -H "X-Api-Key: aw_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "date": "1990-07-14",
    "time": "14:30:00",
    "timezoneOffset": 3,
    "latitude": 50.4501,
    "longitude": 30.5234
  }'

Node.js

const r = await fetch('https://api.astroway.info/v1/planets', {
  method: 'POST',
  headers: {
    'X-Api-Key': process.env.ASTROWAY_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    date: '1990-07-14',
    time: '14:30:00',
    timezoneOffset: 3,
    latitude: 50.4501,
    longitude: 30.5234,
  }),
});
const { data } = await r.json();
const sun = data.planets.find((p) => p.name === 'Sun');
console.log(`Sun: ${sun.longitude.toFixed(4)}° retrograde: ${sun.isRetrograde}`);

Python

import os, requests

r = requests.post(
    'https://api.astroway.info/v1/planets',
    headers={'X-Api-Key': os.environ['ASTROWAY_API_KEY'], 'Content-Type': 'application/json'},
    json={
        'date': '1990-07-14',
        'time': '14:30:00',
        'timezoneOffset': 3,
        'latitude': 50.4501,
        'longitude': 30.5234,
    },
)
data = r.json()['data']
sun = next(p for p in data['planets'] if p['name'] == 'Sun')
print(f"Sun: {sun['longitude']:.4f}° retrograde: {sun['isRetrograde']}")

Kim Kullanır

• Astronomik uygulamalar geliştiricileri: Süsekündel pozisyonlar, self-host C kütüphanesi olmadan
• AI-özneleri: Doğru efeheridler, LLM (MCP sunucusu aracılığıyla) için bir temel olarak
• Araştırmacılar: Tarih aralığı DE431’de büyük hesaplamalar
• Self-host’tan geçiş: Yerel swisseph’den HTTP’ye geçiş, doğruluk kaybedilmez

Fiyat

Gezegen pozisyonları (/v1/gezegenler) - 10 kredi, tam harita (/v1/chart) - 20. Free taksit (760+ eklentileri, 10 000 kredi/ay) - yaklaşık 1000 gezegen pozisyonu ayda ücretsiz, kart olmadan.

Hesaplamaların doğruluğu → Triangülasyon, NASA-geçerlilik, snapshot testleri

Hızlı başlangıç İlk istek için 5 dakika

Taksitler Bedeneksizden Enterprise'e