POST/api/astro/astrocartography/local-space/1 kredi

Yerel uzay çizgileri

Doğum yerinden her gezegene doğru olan pusula yönü, harita boyunca uzatılmış hâlde. ACG çizgilerinden farklı bir relokasyon tekniğidir. Yerel uzay, bir gezegenin Dünya üzerinde nerede bir köşe noktasında olduğunu sormaz; doğum yerinDEN bakıldığında gezegenin gökyüzünde hangi yönde durduğunu sorar ve bu yönü dışarıya doğru bir büyük çember olarak çizer. Bir gezegenin çizgisi boyunca yolculuk etmenin, o gezegenin temalarını beraberinde getirdiği kabul edilir. Azimut gerçek kuzeyden başlayıp doğuya doğru artarak ölçülür; bu yüzden doğrudan pusula yönü olarak okunabilir. Gösterim için on altı yönlü pusuladaki adı da eklenir. Her cisim ayrıca büyük çemberi üzerinde sabit yay uzaklıklarıyla dizilmiş, çizime hazır bir nokta listesiyle gelir. Yükseklik filtre olarak kullanılmaz, yalnızca döndürülür. Ufkun altındaki bir gezegenin de bir yönü vardır ve çizgisinin çizilip çizilmeyeceği konusunda uygulayıcılar farklı karar verebilir; bu yüzden sayı ve bir above_horizon bayrağı verilir, seçim size bırakılır. Buradaki diğer üç endpoint'in aksine bu endpoint gerçekten doğum yerine bağlıdır; bu yüzden latitude ve longitude zorunludur.

https://api.occultapi.com/api/astro/astrocartography/local-space/

İ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.
latitude	number (double)	zorunlu	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)	zorunlu	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
timezone_as_float	number (double)	zorunlu	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
bodies	array	isteğe bağlı
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.
node	string	isteğe bağlı	`north_node` için hangi Ay düğümünün kullanılacağı: true (varsayılan) veya mean. `truemean`

Örnek istek

Bu örnek henüz doğrulanmadı

Aşağıdaki alan adları ve türleri API tanımından alındı ve doğru. Ancak bu gövde, son çalıştırdığımızda başarılı yanıt vermedi; tahmin edemediğimiz bir değer gerekiyor olabilir. Bunu hazır bir komut olarak değil, bir başlangıç noktası olarak kullanın.

curl -X POST https://api.occultapi.com/api/astro/astrocartography/local-space/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date_time":"2026-09-01 06:00:00","latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5,"node":"true"}'

Yanıt

Bu endpoint için henüz doğrulanmış bir örnek yanıt yok. Yukarıdaki istek yapısı API tanımından üretilir ve doğrudur. Yanıt örneklerini ancak gerçek bir çağrıyla doğruladıktan sonra yayımlıyoruz.

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.