Doğum Haritaları

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

Temel Hesaplama

cURL

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",
    "location": {
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": "Europe/London"
    }
  }'

JavaScript

const response = await fetch("https://api.astroapi.cloud/api/calc/natal", {
    method: "POST",
    headers: {
        "X-Api-Key": "your-api-key",
        "Content-Type": "application/json"
    },
    body: JSON.stringify({
        dateTime: "1990-06-15T14:30",
        location: {
            latitude: 51.5074,
            longitude: -0.1278,
            timezone: "Europe/London"
        }
    })
});

const data = await response.json();
console.log(JSON.stringify(data, null, 2));

Python

import requests

response = requests.post(
    "https://api.astroapi.cloud/api/calc/natal",
    headers={
        "X-Api-Key": "your-api-key",
        "Content-Type": "application/json"
    },
    json={
        "dateTime": "1990-06-15T14:30",
        "location": {
            "latitude": 51.5074,
            "longitude": -0.1278,
            "timezone": "Europe/London"
        }
    }
)

print(response.json())

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ı
houseSystem	string	Hayır	Ev sistemi (varsayılan: "placidus")
moonCenter	string	Hayır	Ay referans merkezi: topocentric (varsayılan, doğum konumu için paralaks düzeltmeli) veya geocentric (Dünya'nın merkezi). Yalnızca Ay'ı etkiler. Bkz. Hesaplama Hassasiyeti
points	array	Hayır	Hesaplanacak gök cisimleri (aşağıdaki Kullanılabilir Noktalar bölümüne bakın)
orbs	object	Hayır	Açı türüne göre özel orb değerleri (örneğin { "conjunction": 8, "opposition": 6 })
language	string	Hayır	Metin içeriği için dil kodu (varsayılan: "en")
includeText	boolean	Hayır	Yorum metnini dahil et (varsayılan: false)
includeReadableEntities	boolean	Hayır	Okunabilir varlık başlıklarını dahil et (varsayılan: false)

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": {
    "dateTime": "1990-06-15T12:30:00.000Z",
    "points": {
      "sun": {
        "pointId": "sun",
        "longitude": 84.5,
        "sign": "gemini",
        "signTitle": "Gemini",
        "degreesInSign": 24.5,
        "degreesInSignDms": [24, 30, 0],
        "houseNumber": 10,
        "houseId": "house-10",
        "retrograde": false,
        "pointTitle": "Sun",
        "houseTitle": "10th House"
      },
      "moon": {
        "pointId": "moon",
        "longitude": 245.2,
        "sign": "sagittarius",
        "signTitle": "Sagittarius",
        "degreesInSign": 5.2,
        "degreesInSignDms": [5, 12, 0],
        "houseNumber": 4,
        "houseId": "house-4",
        "retrograde": false,
        "pointTitle": "Moon",
        "houseTitle": "4th House"
      }
    },
    "houses": {
      "cusps": [
        { "longitude": 180.5, "longitudeDms": { "degrees": 180, "minutes": 30, "seconds": 0 }, "sign": "libra" },
        { "longitude": 210.3, "longitudeDms": { "degrees": 210, "minutes": 18, "seconds": 0 }, "sign": "scorpio" }
      ],
      "ascmc": [
        { "longitude": 180.5, "longitudeDms": { "degrees": 180, "minutes": 30, "seconds": 0 }, "sign": "libra" },
        { "longitude": 270.2, "longitudeDms": { "degrees": 270, "minutes": 12, "seconds": 0 }, "sign": "capricorn" }
      ]
    },
    "aspects": [
      {
        "pointA": "sun",
        "pointB": "moon",
        "aspect": "opposition",
        "angle": 160.7,
        "orb": 0.7,
        "applying": false,
        "pointATitle": "Sun",
        "pointBTitle": "Moon",
        "aspectTitle": "Opposition"
      }
    ],
    "chart": {
      "url": "https://api.astroapi.cloud/api/chart2/natal.svg?..."
    }
  }
}

Ev Köşeleri

Her köşe nesnesi longitude (ekliptik derece), longitudeDms (derece/dakika/saniye) ve sign (burç işareti kimliği) içerir. İlk köşe (cusps[0]) Yükselen'dir. ascmc dizisi Yükselen, MC, ARMC ve Vertex'i içerir.

Kullanılabilir Noktalar

Hangi gök cisimlerinin hesaplanacağını seçmek için points parametresini kullanın. Belirtilmezse varsayılan set kullanılır.

Varsayılan Noktalar

sun, moon, mercury, venus, mars, jupiter, saturn, uranus, neptune, pluto, meanNode, trueNode, meanApogee, osculatingApog

Tüm Kullanılabilir Noktalar

Point ID	Açıklama
sun	Güneş
moon	Ay
mercury	Merkür
venus	Venüs
mars	Mars
jupiter	Jüpiter
saturn	Satürn
uranus	Uranüs
neptune	Neptün
pluto	Plüton
meanNode	Ortalama Kuzey Düğüm
trueNode	Gerçek Kuzey Düğüm
meanApogee	Ortalama Kara Ay Lilith
osculatingApog	Gerçek Kara Ay Lilith
chiron	Kiron
pholus	Pholus
ceres	Ceres
pallas	Pallas
juno	Juno
vesta	Vesta
interpolatedLunarApogee	İnterpolasyonlu Ay Apojesi
interpolatedLunarPerigee	İnterpolasyonlu Ay Perijesi (Priapus)
earth	Dünya

Örnek: Yalnızca Güneş ve Mars 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",
    "location": {
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": "Europe/London"
    },
    "points": ["sun", "mars"]
  }'

Yanıt, points nesnesinde sun ve mars'ı, angles nesnesinde ise dört açının tümünü içerecektir:

{
  "data": {
    "points": {
      "sun": { "pointId": "sun", "longitude": 84.5, "sign": "gemini", ... },
      "mars": { "pointId": "mars", "longitude": 12.3, "sign": "aries", ... }
    },
    "angles": {
      "ascendant": {
        "pointId": "ascendant",
        "longitude": 180.5,
        "degreesInSign": 0.5,
        "degreesInSignDms": [0, 30, 0],
        "sign": "libra"
      },
      "descendant": { "pointId": "descendant", "longitude": 0.5, "sign": "aries", ... },
      "midheaven": { "pointId": "midheaven", "longitude": 270.2, "sign": "capricorn", ... },
      "imumCoeli": { "pointId": "imumCoeli", "longitude": 90.2, "sign": "cancer", ... }
    },
    "houses": { ... },
    "aspects": [ ... ]
  }
}

Açılar

Dört açının tümü (ascendant, descendant, midheaven, imumCoeli) points parametresinden bağımsız olarak her zaman angles nesnesinde yer alır. Açılar efemeris yerine ev hesaplamalarından türetildiği için daha basit bir yapıya sahiptir (hız veya retrograd verisi içermez). houses yanıtındaki ascmc dizisi de her zaman ham açı boylamlarını içerir.

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, mili-yay saniyesinin altında gezegen konumları için doğrudan NASA'nın JPL DE442 efemerisini okur. Tüm ayrıntılar için Hesaplama Hassasiyeti sayfasına bakın.