POST/api/astro/astrocartography/lines/1 kredi

Astrokartografi çizgileri

Bir doğum anına ait tüm astrokartografi çizgileri, haritaya doğrudan çizilebilecek koordinatlar olarak. Relokasyon astrolojisi harita sorusu değil, coğrafi bir soru sorar: bir gezegenin gökyüzünde nerede olduğunu değil, doğum anında Dünya'nın hangi noktalarında yükselmekte, batmakta, doruk noktasında ya da nadirde olduğunu. Her gezegen için bu dört eğri bir dünya haritasına çizildiğinde ACG haritası ortaya çıkar. On iki cismin her biri için dört çizgi alırsınız. MC ve IC çizgileri meridyendir; bu yüzden her biri tek bir boylamdan ibarettir. AC ve DC çizgileri ise eğridir ve doğrudan bir polyline'a verebileceğiniz enlem/boylam noktaları listesi olarak döner — varsayılan olarak her beş derece enlemde bir nokta; aralığı latitude_step ile değiştirebilirsiniz. Eğriler, cismin sirkumpolar hâle geldiği yerde biter ve bu eksik veri değil, gerçek bir durumdur: belirli bir enlemin üzerinde cisim ufku hiç geçmez, dolayısıyla orada çizilecek bir yükselme çizgisi yoktur. Kesim enlemi dik açıklığa bağlı olduğundan gezegenden gezegene değişir. latitude ve longitude yalnızca bu endpoint'te isteğe bağlıdır. ACG çizgisini doğum ANI belirler — formüller yalnızca sağ açıklık, dik açıklık ve yıldız zamanını kullanır — bu yüzden doğum yerini zorunlu tutmak, sonucu değiştirmediği hâlde değiştiriyormuş izlenimi verirdi. Belirli bir yerin yakınındaki çizgiler için /api/astro/astrocartography/relocate/ endpoint'ini kullanın.

https://api.occultapi.com/api/astro/astrocartography/lines/

İ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.
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ı	Varsayılan: on ikisinin tümü. Yanıtı küçük tutmak için listeyi daraltın.
close_curves	boolean	isteğe bağlı	Her AC/DC eğrisini bittiği yere kadar uzatan noktalar ekler: bu, cismin artık doğup batmadığı enlemdir ve AC ile DC eğrileri burada cismin MC veya IC çizgisi üzerinde birleşir. Çizim için açın; kapalı (varsayılan) olduğunda yalnızca eşit aralıklı düz örnekler döner.
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.
latitude_step	number (double)	isteğe bağlı	AC/DC eğrileri üzerindeki noktalar arasındaki enlem farkı, derece cinsinden. min 1 · max 15
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.
node	string	isteğe bağlı	`north_node` için hangi Ay düğümünün kullanılacağı: true (varsayılan) veya mean. `truemean`
projection	string	isteğe bağlı	mundo (varsayılan): enlem dahil gerçek konumlar. zodiac: ekliptiğe izdüşürülmüş konumlar; relokasyon haritasıyla 1:1 örtüşür. `mundozodiac`

Ö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/lines/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date_time":"2026-09-01 06:00:00","timezone_as_float":5.5,"latitude":26.9124,"longitude":75.7873,"node":"true","projection":"mundo"}'

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.