POST/api/astro/moon-illumination/1 kredi

Ay'ın aydınlık oranı ve evresi

Ay'ın ne kadarının aydınlık olduğu, gerçek bir oran olarak. Güneş ile Ay arasındaki uzanımdan hesaplanır: lit = (1 - cos(elongation)) / 2. Bu değer yeni ayda 0, iki dördünde de 0.5, dolunayda 1'dir. Hem oran hem yüzde olarak döndürülür; yanında uzanım, evre açısı, Ay'ın büyüyüp büyümediği ve geleneksel evre adı da gelir. Bu endpoint, `get_illumination` adlı motor anahtarı aydınlanma döndürmediği için var. O anahtar GÖRÜNÜR KADİR döndürür — Güneş için yaklaşık -26.7, Ay için evreye göre -6 ile -12 arası. Bir oran negatif olamaz, -26 da olamaz; bu alanı "aydınlık yüzdesi" göstergesine bağlayan her uygulama anlamsız değerler gösterir. Bu değer burada da döndürülür, ama hak ettiği adla: apparent_magnitude; değer ne kadar küçükse cisim o kadar parlaktır.

https://api.occultapi.com/api/astro/moon-illumination/

İsteği deneyin

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.
altitude	number (double)	isteğe bağlı	GÖZLEMCİNİN metre cinsinden rakımı; bir cismin yüksekliği değildir.
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. min -89.9 · max 89.9
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. min -180 · max 180
planet_names	array	isteğe bağlı	Yok sayılır. Bu endpoint her zaman Güneş'i ve Ay'ı okur.
time_zone	number (double)	isteğe bağlı	UTC farkı. Bunu ya da timezone_as_float alanını kullanın; ikisi aynı işi görür. min -12 · max 14
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/moon-illumination/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date_time":"2026-09-09T12:00:00+00:00","latitude":26.9124,"longitude":75.7873,"timezone_as_float":0}'

Yanıt

{
  "data": {
    "illuminated_fraction": 0.034082,
    "illuminated_percent": 3.4082,
    "elongation_degrees": 21.277,
    "phase_angle_degrees": 338.723,
    "waxing": false,
    "phase_name": "New moon",
    "apparent_magnitude": {
      "moon": -6.123776,
      "sun": -26.726421
    },
    "longitudes": {
      "sun": 166.834,
      "moon": 145.557
    },
    "notes": {
      "apparent_magnitude": "The engine key named get_illumination returns apparent magnitude, not illumination. Smaller is brighter; it is negative for both of these bodies. Use illuminated_fraction for how much of the disc is lit."
    }
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

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.