Deklinasyonlar
Bir doğum haritası ekliptik üzerine yapılan bir izdüşümdür ve bu izdüşüm bir ekseni atar. Deklinasyon, aynı gök cisimleri gök ekvatorundan ölçüldüğünde geriye kalan şeydir — basılı bir efemeristeki ikinci tablo ve hiçbir açı ızgarasında yer almayan koordinat.
Bu eksende iki şey yaşar ve hiçbiri bir burç haritasında görünmez:
- Paraleller ve kontrparaleller. Aynı deklinasyondaki iki gök cismi bir paralel oluşturur; bu bir kavuşum gibi davranır. Ekvatora aynı uzaklıkta ama karşıt taraflarda olmak bir kontrparaleldir ve bir karşıtlık gibi davranır. Her ikisi de boylamda hiçbir açı oluşturmayan cisimler arasında ortaya çıkabilir.
- Sınır dışı (out of bounds). Güneş'in kendi azami deklinasyonunu aşan bir gök cismi. Ay, büyük bir Ay duraklaması civarında ayda birkaç gün böyledir; Merkür, Venüs, Mars ve Plüton ise aralıklarla. Gerçek ve çokça tartışılan bir durumdur, ve neredeyse hiçbir tüketici yazılımı bunu bildirmez.
Gerekli Modül
Her iki uç nokta da declination:calc modülünü gerektirir. Tüm planlara dahildir ve ayrı olarak satılmaz.
Bir an için deklinasyonlar
curl -X POST "https://api.astroapi.cloud/api/calc/declination" \
-H "X-Api-Key: your-api-key" \
-H "Content-Type: application/json" \
-d '{
"dateTime": "1990-06-15T14:30",
"location": {
"latitude": 52.37,
"longitude": 4.89,
"timezone": "Europe/Amsterdam"
},
"orb": 1
}'Parametreler
| Parametre | Tür | Zorunlu | Açıklama |
|---|---|---|---|
dateTime | string | Evet | YYYY-MM-DDTHH:mm, location konumundaki yerel saat |
location | object | Evet | latitude, longitude ve bir IANA timezone |
points | array | Hayır | Hesaplanacak noktalar. Varsayılan olarak on gök cismi, her iki düğüm ve her iki Lilith |
orb | number | Hayır | Paralel ve kontrparaleller için orb, 0–3 derece. Varsayılan 1 |
moonCenter | string | Hayır | topocentric (varsayılan) veya geocentric |
Buradaki orb oradaki orb değildir
Bir deklinasyon orbu, boylam orbundan çok daha dardır. Bir derece hem gelenek hem de varsayılan değerdir; iki derecenin ötesinde neredeyse her şey bir şeye paraleldir.
Yanıt
{
"data": {
"dateTime": "1990-06-15T12:30:00.000Z",
"points": {
"sun": {
"pointId": "sun",
"declination": 23.32,
"declinationDms": [23, 19, 12],
"rightAscension": 84.1,
"latitude": 0,
"speedDeclination": 0.04,
"outOfBounds": false,
"hemisphere": "north"
},
"moon": {
"pointId": "moon",
"declination": -18.44,
"declinationDms": [18, 26, 24],
"rightAscension": 312.7,
"latitude": -4.61,
"speedDeclination": -3.1,
"outOfBounds": false,
"hemisphere": "south"
}
},
"aspects": [
{
"pointA": "venus",
"pointB": "mars",
"aspect": "parallel",
"orb": 0.31,
"applying": true,
"declinationA": 21.08,
"declinationB": 21.39
}
],
"extremes": {
"northernmost": "sun",
"southernmost": "moon",
"outOfBoundsCount": 0
},
"obliquity": 23.4405
}
}declinationDms, [derece, dakika, saniye] biçiminde mutlak değerdir; taraf bilgisi hemisphere alanında ve declination işaretindedir. speedDeclination günlük derece cinsindendir ve negatif olması güneye doğru anlamına gelir — bir paralelin yaklaşan mı yoksa ayrılan mı olduğunu bu gösterir; boylam açıları için applying alanının yanıtladığı aynı soru.
Sınır dışı sınırı
obliquity, istenen tarihteki ekliptiğin gerçek eğikliğidir — Güneş'in kendi azami deklinasyonu ve dolayısıyla outOfBounds değerinin karşısında değerlendirildiği sınır. Bir istemcinin kendi sınırını uydurmadan bandı çizebilmesi için döndürülür.
Geleneksel değer 23°26'dır. Gerçek değer ise hareket eder: nütasyon onu dokuz yay saniyesine kadar kaydırır ve bu, sınırdaki bir durumu şu ya da bu yöne karar bağlamaya yeter. Döndürülen obliquity ile karşılaştırmak ile sabit bir 23.4367 ile karşılaştırmak, tam çizgi üzerindeki bir gök cismi için farklı sonuçlar verir.
Güneş asla sınır dışı olmaz
Tanım gereği — koşul "Güneş'in ötesinde" olmaktır. Tam sınırdaki bir gök cismi sınır dışı değildir; sınırın ötesinde olmalıdır.
Bir dönem boyunca deklinasyon
Diğer yarısı ve bunun bir doğum haritası alanı yerine kendi uç noktası olmasının nedeni: bir deklinasyon grafiği zaman içindeki bir seridir ve bir gök cisminin sınır dışı sınırını geçtiği tarihler, bir astroloğun gerçekten not aldığı şeydir.
curl -X POST "https://api.astroapi.cloud/api/calc/declination/series" \
-H "X-Api-Key: your-api-key" \
-H "Content-Type: application/json" \
-d '{
"startDate": "2025-01-01",
"endDate": "2025-12-31",
"stepDays": 2,
"points": ["sun", "moon", "mercury", "venus", "mars", "pluto"]
}'Parametreler
| Parametre | Tür | Zorunlu | Açıklama |
|---|---|---|---|
startDate | string | Evet | YYYY-MM-DD veya ISO 8601 |
endDate | string | Evet | YYYY-MM-DD veya ISO 8601 |
stepDays | number | Hayır | Seri noktaları arasındaki gün sayısı, 0,25–30. Varsayılan 1 |
points | array | Hayır | Çizilecek noktalar. Varsayılanlar yukarıdaki gibidir |
Yanıt
{
"data": {
"startDate": "2025-01-01T00:00:00.000Z",
"endDate": "2025-12-31T23:59:00.000Z",
"stepDays": 2,
"points": ["sun", "moon", "mercury", "venus", "mars", "pluto"],
"series": {
"moon": [
["2025-01-01T00:00:00.000Z", -14.02],
["2025-01-03T00:00:00.000Z", 8.71]
]
},
"crossings": [
{
"pointId": "moon",
"date": "2025-03-06T07:41:12.000Z",
"direction": "out",
"declination": 23.4392
},
{
"pointId": "moon",
"date": "2025-03-10T02:18:55.000Z",
"direction": "in",
"declination": 23.4392
}
]
}
}Geçişler stepDays aralığıyla örneklenmez
Ay'ın sınırın ötesine yaptığı bir çıkış birkaç gün sürer. Haftalık adımla çizilen bir seri onun üzerinden atlayıp geçerdi — bu nedenle geçişler, serinin döndürüldüğü ızgaradan daha ince bir ızgarada aranır ve her biri ardından efemerise karşı saniyesine kadar iyileştirilir.
Pratik sonuç: geniş bir stepDays size eğrinin biçimini kaybettirir, asla bir geçiş tarihini değil. Grafiğin ihtiyaç duyduğu çözünürlüğü isteyin, fazlasını değil.
Seri sınırı
Bir seri 400 nokta ile sınırlıdır. Günlük adımla bir yıl 365 nokta eder; günlük adımla bir on yıl 3653 eder ve adımı genişletme tavsiyesiyle birlikte bir 400 olarak geri döner:
{
"error": "That range at a 1-day step is 3654 points; the limit is 400. Widen stepDays or shorten the range."
}Her iki durumda da bu tek bir istektir. Aynı tabloyu 400 ayrı çağrıdan kurmak aylık kotanızdan 400 istek harcar; seri uç noktası bunları tek geçişte hesaplar ve tek istek sayılır.
Doğum haritasında deklinasyon
2026-09-10 API sürümünden itibaren bir doğum haritası yanıtındaki her nokta declination ve outOfBounds da taşır; böylece bir çark, sınır dışı bir gök cismini ikinci bir çağrı olmadan işaretleyebilir:
curl -X POST "https://api.astroapi.cloud/api/calc/natal" \
-H "X-Api-Key: your-api-key" \
-H "X-Api-Version: 2026-09-10" \
-H "Content-Type: application/json" \
-d '{ "dateTime": "1990-06-15T14:30", "location": { "latitude": 52.37, "longitude": 4.89, "timezone": "Europe/Amsterdam" } }'Daha eski bir sürümdeki bir çağıran, her zaman aldığı yanıt biçimini korur. Bir sürümü sabitlemenin nasıl yapılacağı için API Sürümleme sayfasına bakın.
Doğum haritası yanıtı yalnızca bu iki alanı taşır. Paraleller, kontrparaleller, sağ açıklık, deklinasyon hızı ve seri, hepsi yukarıdaki uç noktalarda bulunur.
Bu ne değildir
Burada 3B görünüm yok, ve bu bilinçli bir tercih. Deklinasyonun doğru görüntüsü bir eksene karşı çizilen bir çizgidir; bir gök küresi onu daha güzel yapar ama daha anlaşılır yapmaz.