POST/api/astro/astrocartography/relocate/1 kredi

Bir yerin yakınındaki çizgiler

Belirli bir yerin yakınından hangi gezegen çizgilerinin geçtiği ve her birinin ne kadar yakın olduğu. Bir relokasyon özelliğinin asıl sorduğu soru budur — Berlin'de benim için neler oluyor? Bunu tam çizgi kümesinden yanıtlamak, sirkumpolar testini ve boylam karşılaştırmasını kendinizin yeniden yazması demektir; bu endpoint bu işi sizin yerinize yapar ve yalnızca seçtiğiniz orb içindeki çizgileri döndürür. Her sonuçta çizginin sizin enleminizdeki boylamı, işaretli bir fark (pozitif değer, yerin çizginin doğusunda olduğunu gösterir), derece cinsinden mutlak orb ve kilometre cinsinden yaklaşık uzaklık bulunur. Sonuçlar en yakından en uzağa doğru sıralanır. Uzaklık, enlem paraleli boyunca doğu-batı yönünde ölçülür. Astrokartografideki yerleşik yöntem budur ve değeri, başka araçların kullandığı bilinen ‘bir çizgiye 700 mil mesafe’ orb'uyla karşılaştırılabilir kılar. Bu, eğriye olan dik büyük çember uzaklığı değildir; yüksek enlemlerde dik eğimli bir yükselme çizgisinde ikisi birbirinden ayrılır. Bu yüzden asıl değer orb_degrees'tir; kilometre değeri ondan türetilen, kolaylık amaçlı bir değerdir.

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

İ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`
orb_degrees	number (double)	isteğe bağlı	Bir çizgiye ne kadar uzaklığın hâlâ çizgi üzerinde sayılacağı. min 0.1 · max 30
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/relocate/ \
  -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","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.