Doğum Haritaları

Gezegen konumları, ev köşeleri ve açılarla eksiksiz doğum haritaları hesaplayın.

Temel Hesaplama

curl -X POST "https://api.astroapi.cloud/api/calc/natal" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "datetime": "1990-06-15T14:30:00",
    "latitude": 51.5074,
    "longitude": -0.1278,
    "timezone": "Europe/London"
  }'

Parametreler

Parametre	Tür	Zorunlu	Açıklama
datetime	string	Evet	ISO 8601 tarih/saat
latitude	number	Evet	Enlem (-90 ile 90 arası)
longitude	number	Evet	Boylam (-180 ile 180 arası)
timezone	string	Evet	IANA saat dilimi tanımlayıcısı
houseSystem	string	Hayır	Ev sistemi (varsayılan: "placidus")

Ev Sistemleri

• placidus - Placidus (varsayılan)
• koch - Koch
• equal - Eşit Ev
• whole - Bütün Burç
• campanus - Campanus
• regiomontanus - Regiomontanus
• porphyry - Porphyry

Yanıt

{
  "data": {
    "type": "natal-chart",
    "attributes": {
      "planets": {
        "sun": { "longitude": 84.5, "latitude": 0, "sign": "gemini", "house": 10 },
        "moon": { "longitude": 245.2, "latitude": -3.1, "sign": "sagittarius", "house": 4 }
      },
      "houses": {
        "1": { "cusp": 180.5, "sign": "libra" },
        "2": { "cusp": 210.3, "sign": "scorpio" }
      },
      "aspects": [
        { "planet1": "sun", "planet2": "moon", "aspect": "opposition", "orb": 0.7 }
      ]
    }
  }
}

Dahil Edilen Gök Cisimleri

Varsayılan olarak aşağıdaki gök cisimleri dahil edilir:

• Güneş, Ay
• Merkür, Venüs, Mars, Jüpiter, Satürn, Uranüs, Neptün, Plüton
• Kuzey Düğüm, Güney Düğüm
• Chiron, Lilith (Kara Ay)
• Baht Noktası

Ay ve Güneş

Ay evresini, aydınlanmasını, doğuş/batış saatlerini ve güneş konum verilerini hesaplayın.

POST /api/calc/moon-sun

curl -X POST "https://api.astroapi.cloud/api/calc/moon-sun" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "dateTime": "2024-06-15T12:00",
    "location": {
      "latitude": 52.37,
      "longitude": 4.89,
      "timezone": "Europe/Amsterdam"
    }
  }'

Parametreler

Parametre	Tür	Zorunlu	Açıklama
dateTime	string	Evet	YYYY-MM-DDTHH:mm biçiminde tarih/saat
location.latitude	number	Evet	Enlem (-90 ile 90 arası)
location.longitude	number	Evet	Boylam (-180 ile 180 arası)
location.timezone	string	Evet	IANA saat dilimi tanımlayıcısı

Gerekli Modül

Bu uç nokta module:moon modülünü gerektirir.

Yanıt

{
  "data": {
    "moon": {
      "phaseName": "Waxing Gibbous",
      "phase": 0.62,
      "illumination": 0.78,
      "age": 9.2,
      "distance": 384400,
      "diameterDegrees": 0.52,
      "rise": "2024-06-15T14:23:00Z",
      "set": "2024-06-16T02:15:00Z"
    },
    "sun": {
      "rise": "2024-06-15T05:18:00Z",
      "set": "2024-06-15T22:03:00Z",
      "transit": "2024-06-15T13:40:00Z",
      "distance": 151820000,
      "diameterDegrees": 0.524,
      "twilight": {
        "civil": {
          "begin": "2024-06-15T04:38:00Z",
          "end": "2024-06-15T22:43:00Z"
        },
        "nautical": {
          "begin": "2024-06-15T03:32:00Z",
          "end": "2024-06-15T23:49:00Z"
        },
        "astronomical": {
          "begin": null,
          "end": null
        }
      }
    }
  }
}

Hesaplama Hassasiyeti

AstroAPI, yüksek hassasiyetli hesaplamalar için Swiss Ephemeris'i kullanır. Tüm konumlar yay saniyesi hassasiyetiyle hesaplanır.

Beta: Alternatif Hesaplama Motoru

Deneysel Özellik

Bu özellik beta aşamasındadır ve doğruluk sorunları olabilir. Üretim ortamlarında dikkatli kullanın.

AstroAPI, resmi Swiss Ephemeris kütüphanesini kullanmak yerine Swiss Ephemeris SE1 veri dosyalarını doğrudan okuyan ve değerlendiren özel bir uygulama kullanan alternatif bir hesaplama motoru (calc2) sunar. Bu motor hız için optimize edilmiştir ve daha hızlı yanıt süreleri sağlayabilir.

Alternatif motoru kullanmak için isteğinize X-Use-Calc2 başlığını ekleyin:

curl -X POST "https://api.astroapi.cloud/api/calc/natal" \
  -H "X-Api-Key: your-api-key" \
  -H "X-Use-Calc2: true" \
  -H "Content-Type: application/json" \
  -d '{
    "datetime": "1990-06-15T14:30:00",
    "latitude": 51.5074,
    "longitude": -0.1278,
    "timezone": "Europe/London"
  }'

Temel Farklar

Özellik	Standart Motor	Calc2 Motoru (Beta)
Uygulama	Swiss Ephemeris	Özel uygulama
Veri Kaynağı	SE1 efemeris dosyaları	SE1 efemeris dosyaları (aynı veri)
Hız	Standart	Potansiyel olarak daha hızlı
Doğruluk	Yay saniyesi hassasiyeti (referans)	Küçük sapmalar olabilir
Durum	Üretime hazır	Beta

Calc2 Ne Zaman Kullanılır

• Önerilen: Mutlak hassasiyet yerine hızın önceliklendirildiği yüksek hacimli uygulamalar
• Önerilmez: Maksimum astronomik doğruluk gerektiren uygulamalar

Bilinen Sınırlamalar

• Özel uygulama, resmi Swiss Ephemeris kütüphanesiyle karşılaştırıldığında biraz farklı sonuçlar üretebilir
• Hâlâ aktif geliştirme ve test aşamasındadır
• Kritik uygulamalar için sonuçlar standart motorla doğrulanmalıdır