/api/astro/western/heliocentric/1 krediGüneş merkezli harita
Güneş sistemi, Dünya'dan değil Güneş'ten bakıldığında. Güneş'in yerini Dünya alır: konumu olan gök cismi Dünya'dır, Güneş ise merkezdir. Bu yüzden güneş merkezli bir Güneş, Ay veya Ay düğümü yoktur; bunlar yer merkezli kavramlardır ve uydurma bir sayıyla döndürülmek yerine `omitted` içinde adlarıyla belirtilir. Burada hiçbir gök cismi retro değildir. Retro hareket, hareket eden bir gezegeni başka bir hareket eden gezegenden izlemenin yarattığı bir yanılsamadır; bu yüzden tüm `retrograde` değerleri false olur. Bu eksik bir özellik değil, doğru yanıttır.
https://api.occultapi.com/api/astro/western/heliocentric/Kimlik doğrulama
Anahtarınızı X-API-Key başlığında gönderin. Anahtar, sunucu tarafında saklanması gereken bir kimlik bilgisidir; tarayıcıda çalışan JavaScript'e veya mobil uygulamaya asla koymayın.
X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/jsonİstek alanları
| Alan | Tür | Zorunlu | Notlar |
|---|---|---|---|
| date_time | string (date-time) | zorunlu | Hesaplamanın yapılacağı an, ISO 8601 biçiminde. Değere HER ZAMAN bir saat farkı ya da sonda Z ekleyin - saat dilimi içermeyen bir değer UTC değil, Asia/Kolkata (UTC+05:30) olarak okunur ve 200 koduyla bir önceki günün sonucunu döndürebilir. '2026-09-01T06:00:00Z' ile '2026-09-01 06:00:00' farklı anlardır ve farklı sonuç verir. |
| ayanamsa | string | isteğe bağlı | TROPICAL (varsayılan) veya LAHIRI, KRISHNAMURTI, RAMAN ya da FAGAN_BRADLEY gibi bir ayanamsa adı; büyük/küçük harfe duyarsızdır. Sideral bir ayanamsa seçildiğinde, ayanamsanın o andaki değeri döndürülen her boylamdan çıkarılır. |
| include_asteroid_lilith | boolean | isteğe bağlı | (1181) Lilith asteroidini, diğer gök cisimlerinden sonra "asteroid_lilith" adıyla ekler. Bu cisim Kara Ay Lilith'ten farklıdır. |
| include_lilith | boolean | isteğe bağlı | Kara Ay Lilith'i (ortalama Ay yerötesi), diğer gök cisimlerinden sonra "lilith" adıyla ekler. |
| keys | array | isteğe bağlı | Döndürülecek hesaplamaların adlarını içeren liste. Bu endpoint'in anahtar tablosuna bakın; tanınmayan bir ad varsa isteğin tamamı reddedilir. Kaç anahtar isterseniz isteyin bir çağrı bir kredi tutar; bu yüzden birkaç ayrı çağrı yapmak yerine ihtiyacınız olan her şeyi tek seferde isteyin. |
| latitude | number (double) | isteğe bağlı | Yerin enlemi, ondalık derece cinsinden. Pozitif değer kuzeyi, negatif değer güneyi gösterir. Örnek: Jaipur için 26.9124, New York için 40.7128. Dakika ve saniye kabul edilmez - önce ondalık dereceye çevirin. |
| longitude | number (double) | isteğe bağlı | Yerin boylamı, ondalık derece cinsinden. Pozitif değer doğuyu, negatif değer batıyı gösterir. Örnek: Jaipur için 75.7873, New York için -74.0060. İşarete dikkat edin: eksi işaretini unutursanız New York Çin'e düşer. |
| orb_factor | number (double) | isteğe bağlı | Tüm açı orb'larını ölçekler. 0.5 orb'ları yarıya indirir, 2 iki katına çıkarır. min 0.1 · max 2 |
| timezone_as_float | number (double) | isteğe bağlı | Yerin UTC farkı, saat cinsinden ondalık sayı olarak. Örnek: Hindistan için 5.5 (UTC+05:30), kışın New York için -5, Nepal için 5.75. Bu değer date_time ile karşılaştırılıp DOĞRULANMAZ - ikisi birbirini tutmazsa yanlış an için başarılı bir yanıt alırsınız; bu yüzden ikisini de aynı kaynaktan alın. Bugünkü farkı değil, o tarihte geçerli olan farkı kullanın: yaz saati uygulayan bir ülkede yaz aylarında doğan biri için yaz saati farkı gerekir. min -12 · max 14 |
Örnek istek
curl -X POST https://api.occultapi.com/api/astro/western/heliocentric/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-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}'Yanıt
{
"_truncated": true,
"_note": "Response shortened for the catalogue.",
"preview": "{\"data\": {\"zodiac\": \"tropical\", \"centre\": \"sun\", \"planets\": [{\"name\": \"earth\", \"longitude\": 322.125097, \"speed\": 0.960932, \"retrograde\": false, \"sign\": \"Aquarius\", \"sign_index\": 11, \"degree_in_sign\": 22.1251, \"formatted\": \"22°07' Aquarius\"}, {\"name\": \"mercury\", \"longitude\": 266.048574, \"speed\": 2.767625, \"retrograde\": false, \"sign\": \"Sagittarius\", \"sign_index\": 9, \"degree_in_sign\": 26.0486, \"formatted\": \"26°02' Sagittarius\"}, {\"name\": \"venus\", \"longitude\": 91.966766, \"speed\": 1.616741, \"retrograde\": false, \"sign\": \"Cancer\", \"sign_index\": 4, \"degree_in_sign\": 1.9668, \"formatted\": \"1°58' Cancer\"}, {\"name\": \"mars\", \"longitude\": 4.703217, \"speed\": 0.621477, \"retrograde\": false, \"sign\": \"Aries\", \"sign_index\": 1, \"degree_in_sign\": 4.7032, \"formatted\": \"4°42' Aries\"}, {\"name\": \"jupiter\", \"longitude\": 115.042891, \"speed\": 0.082106, \"retrograde\": false, \"sign\": \"Cancer\", \"sign_index\": 4, \"degree_in_sign\": 25.0429, \"formatted\": \"25°02' Cancer\"}, {\"name\": \"saturn\", \"longitude\": 292.969663, \"speed\": 0.030364, \"retrograde\": false, \"sign\": \"Capricorn\", \"sign_index\": 10, \"degree_in_sign\": 22.9697, \"formatted\": \"22°58' Capricorn\"}, {\"name\": \"uranus\", \"longitude\": 278.129858, \"speed\": 0.011499, \"retrograde\": false, \"sign\": \"Capricorn\", \"sign_index\": 10, \"degree_in_sign\": 8.1299, \"formatted\": \"8°07' Capricorn\"}, {\"name\": \"neptune\", \"longitude\": 283.428057, \"speed\": 0.005989, \"retrograde\": false, \"sign\": \"Capricorn\", \"sign_index\": 10, \"degree_in_sign\": 13.4281, \"formatted\": \"13°25' Capricorn\"}, {\"name\": \"pluto\", \"longitude\": 227.099255, \"speed\": 0.007081, \"retrograde\": false, \"sign\": \"Scorpio\", \"sign_index\": 8, \"degree_in_sign\": 17.0993, \"formatted\": \"17°05' Scorpio\"}, {\"name\": \"chiron\", \"longitude\": 109.782224, \"speed\": 0.028755, \"retrograde\": false, \"sign\": \"Cancer\", \"sign_index\": 4, \"degree_in_sign\": 19.7822, \"formatted\": \"19°46' Cancer\"}], \"aspects\": [{\"body_1\": \"earth\", \"body_2\": \"saturn\", \"aspect\": \"semisextile\", \"exact_angle\": 30.0, \"orb\": 0.8446, \"allowed_orb\": 2.0, \"separation\": 29.1554}, {\"body_1\": \"mercury\", \"body_2\": \"jupiter\", \"aspect\": \"quincunx\", \"exact_angle\": 150.0, \"orb\": 1.0057, \"allowed_orb\": 3.0, \"separation\": 151.0057}, {\"body_1\": \"jupiter\", \"body_2\": \"saturn\", \"aspect\": \"opposition\", \"exact_angle\": 180.0, \"orb\": 2.0732, \"allowed_orb\": 8.0, \"separation\": 177.9268}, {\"body_1\": \"earth\", \"body_2\": \"chiron\", \"aspect\": \"quincunx\", \"exact_angle\": 150.0, \"orb\": 2.3429, \"allowed_orb\": 3.0, \"separation\": 147.6571}, {\"body_1\": \"pluto\", \"body_2\": \"chiron\", \"aspect\": \"trine\", \"exact_angle\": 120.0, \"orb\": 2.683, \"allowed_orb\": 8.0, \"separation\": 117.317}, {\"body_1\": \"venus\", \"body_2\": \"mars\", \"aspect\": \"square\", \"exact_angle\": 90.0, \"orb\": 2.7365, \"allowed_orb\": 8.0, \"separation\": 87.2635}, {\"body_1\": \"earth\", \"body_2\": \"jupiter\", \"aspect\": \"quincunx\", \"exact_angle\": 150.0, \"orb\": 2.9178, \"allowed_orb\": 3.0, \"separation\": 152.9178}, {\"body_1\": \"saturn\", \"body_2\": \"chiron\", \"aspect\": \"opposition\", \"exact_angle\": 180.0, \"orb\": 3.1874, \"allowed_orb\": 8.0, \"separation\": 176.8126}, {\"body_1\": \"mars\", \"body_2\": \"uranus\", \"aspect\": \"square\", \"exact_angle\": 90.0, \"orb\": 3.4266, \"allowed_orb\": 8.0, \"separation\": 86.5734}, {\"body_1\": \"neptune\", \"body_2\": \"pluto\", \"aspect\": \"sextile\", \"exact_angle\": 60.0, \"orb\": 3.6712, \"allowed_orb\": 6.0, \"separation\": 56.3288}, {\"body_1\": \"earth\", \"body_2\": \"mercury\", \"aspect\": \"sextile\", \"exact_angle\": 60.0, \"orb\": 3.9235, \"allowed_orb\": 6.0, \"separation\": 56.0765}, {\"body_1\": \"earth\", \"body_2\": \"pluto\", \"aspect\": \"square\", \"exact_angle\": 90.0, \"orb\": 5.0258, \"allowed_orb\": 8.0, \"separation\": 95.0258}, {\"body_1\": \"jupiter\", \"body_2\": \"chiron\", \"aspect\": \"conjunction\", \"exact_angle\": 0.0, \"orb\": 5.2607, \"allowed_orb\": 8.0, \"separation\": 5.2607}, {\"body_1\": \"uranus\", \"body_2\": \"neptune\", \"aspect\": \"conjunction\", \"exact_angle\": 0.0, \"orb\": 5.2982, \"allowed_orb\": 8.0, \"separation\": 5.2982}, {\"body_1\": \"saturn\", \"body_2\": \"pluto\", \"aspect\": \"sextile\", \"exact_angle\": 60.0, \"orb\": 5.8704, \"allowed_orb\": 6.0, \"separati"
}Yukarıdaki isteğin birebir aynısıyla yapılan gerçek bir çağrıdan alındı. Sonuçlar data altında yer alır.
Hatalar
Kredi ve kullanım hataları { "error": "…", "message": "<code>", "is_error": true } döndürür. Kullanıcıya error değerini gösterin, kodunuzda ise message değerine göre karar verin. Ayrıntılar için hata referansına bakın.