Hesaplama motoru
Bu API'nin döndürdüğü her sayı bir arama tablosundan ya da bir modelden değil, efemeristen gelir. Burada altta ne olduğunu ve neyi hesaplamayı reddettiğimizi anlatıyoruz.
Efemeris
Konumlar NASA JPL gezegen efemerisinden gelir; uzay araçlarının navigasyonunda kullanılan veri setinin aynısı. Bu, MS 500–2999 yıllarını kapsayan 105 MB'lık tablolanmış konum verisi ve 735 sabit yıldız demektir.
Bunun önemi şu: alternatifi, gazete köşesi için yeterince yakın ama bir harita için yetersiz kalan hesaplardır. Ortalama hareket formülleri yüzyıllar içinde derecelerce sapar. Bu fark 1890 ya da 2090 doğumlu birinin haritasında ortaya çıkar; varga haritasında ise sonuç biraz farklı değil, tamamen başka olur. D60'ta yarım derece, bir gezegeni bir sonraki bölüme taşır.
Sidereal, ama hangi sidereal?
Vedik astroloji sidereal'dır: konumlar, hareket eden ekinokstan değil, gökyüzündeki sabit bir başlangıç noktasından ölçülür. İkisi arasındaki fark ayanamsadır; bugün yaklaşık 24° civarındadır ve üzerinde uzlaşılmış tek bir değeri yoktur.
Bu yüzden bir parametredir. 48 ayanamsa kabul edilir: Lahiri, Raman, Krishnamurti, Fagan-Bradley, Yukteshwar, Suryasiddhanta ve diğerleri. Varsayılan Lahiri'dir; doğru olan o olduğu için değil, Hindistan hükümetinin standardı olduğu için.
{
"date_time": "1990-08-15T10:30:00+05:30",
"latitude": 26.9124,
"longitude": 75.7873,
"timezone_as_float": 5.5,
"ayanamsa": "KRISHNAMURTI"
}Ayanamsa konusunda anlaşamayan iki astrolog da bu API'yi kullanıp beklediği haritayı alabilir. Tek bir ayanamsayı koda gömen bir API, henüz çözülmemiş bir tartışmada sessizce taraf tutmuş olur.
Neleri kapsar
Hesapladıklarına göre gruplanmış 299 endpoint:
Hız
Medyan sunucu süresi 62 ms; endpoint'lerin %76 kadarı 100 ms'nin altında. Bu ölçüm, yayımlanan tüm örneklerin yerel bir çalıştırmasıyla yapıldı. Efemeris belleğe eşlenmiş durumdadır; bu yüzden bir haritanın maliyeti disk erişimi değil, hesabın kendisidir.
Bir çağrı daha yavaşsa, bunun nedeni işin gerçekten daha büyük olmasıdır: transit araması bir tarih aralığını tarar, PDF raporu ise yaklaşık yirmi beş endpoint'i tek bir belgede birleştirir ve tek çağrı olarak ücretlendirilir.
Belirlenimcilik
Aynı girdi her zaman aynı çıktıyı verir. Süreçte örnekleme de model de yoktur; bugün çıkarılan bir harita ile gelecek yıl çıkarılan aynı harita bayt bayt aynıdır. Yanıtları önbelleğe alınabilir kılan da budur, 1.783 test fonksiyonunun aralık yerine kesin değerleri doğrulayabilmesini sağlayan da.
Bu, bir uyuşmazlığın kontrol edilebileceği anlamına da gelir. Bizim Ay'ımız ile sizin yazılımınızın Ay'ı farklıysa ikisinden biri yanlıştır; ikisi de “aşağı yukarı doğru” değildir. Hangisinin yanlış olduğunu ayanamsa ya da saat dilimi gösterir.
Neleri hesaplamayız
Motor neredeyse her şey için bir sayı üretebilir. Ama bu sayıların bazıları, okuyanın sandığı anlama gelmez; bu tür endpoint'ler yoktur.
- Lal Kitab'daki ata borçları. Sekiz borcun adları kaynaklar arasında tutarlıdır, ama her birini doğuran koşullar tutarlı değildir: yalnızca pitra rin için yayımlanmış kurallar bile aynı haritada farklı sonuçlar verir. Birinin ataları hakkında, tesadüfen hangi kitabı okuduğumuza bağlı bir hüküm yayımlamayız.
- Kuralını türetemediğimiz alanlar. Bir rakibin döndürdüğü ama bizim bir kaynaktan doğrulayamadığımız bir değer varsa, o alan yanıtta yer almaz ve yanıt nedenini belirtir. Çağıranın kontrol etme imkânı olmayan, akla yatkın bir tahmin döndürmeyiz.
- Tıbbi, hukuki ya da finansal tavsiye olarak sunulan her şey. Çare metinleri geleneksel atıflardır ve öyle etiketlenir.
İki ekolün gerçekten ayrıştığı ve ikisinin de savunulabilir olduğu durumlarda yanıt hangisini uyguladığını belirtir. Böylece sonucu olduğu gibi kabul etmek yerine kontrol edebilirsiniz.
Deneyin
curl -X POST https://api.occultapi.com/api/astro/planet-positions/ \
-H 'X-API-Key: yt_live_your_key_here' \
-H 'Content-Type: application/json' \
-d '{
"date_time": "1990-08-15T10:30:00+05:30",
"latitude": 26.9124,
"longitude": 75.7873,
"timezone_as_float": 5.5,
"ayanamsa": "LAHIRI"
}'Ya da hiç kod yazmadan playground üzerinde çalıştırın.