Ay Dönüşü API'si
Seçilen tarih veya sonrasında Ay'ın doğduğu boylamına geri döndüğü bir sonraki anı bulun - yaklaşık her 27.3 günde bir - ve bunun için seçtiğiniz bir konumda harita çıkarın. Doğum verilerini ve başlangıç tarihini geçirin, Ay dönüşü haritasını alın. Swiss Ephemeris hassasiyeti, JSON çıktısı.
Ay Dönüşü API'si
Ay dönüşü uç noktası, sağlanan doğum verilerinden doğum Ay'ının tam boylamını okur, ardından verilen başlangıç tarihinden itibaren ilerleyerek geçen Ay'ın aynı boylama geri döndüğü ilk anı arar. Ay yaklaşık 27.3 günde bir bir yıldızsal döngüyü tamamladığı için bu dönüş yaklaşık olarak aylık gerçekleşir. Uç nokta, eşleşen anı bir Jülyen gününe dönüştürür, Swiss Ephemeris motorundan jeosantrik konumları ve hızları çeker ve bunun için tam bir harita çıkarır - dönüş gezegenleriyle işaretler ve ev yerleşimleri, ev kerteleri, ve uygulanan ve ayrılan bayraklarla ve tam orbs ile tam aspect ızgarası. Varsayılan olarak harita doğum yeri için çıkarılır, ancak dönüşü yeniden konumlandırmak için farklı bir enlem ve boylam sağlayabilirsiniz, bu aynı dönüş anını korurken açıları ve evleri yeniden şekillendirir. Sonuç, önümüzdeki ay ayı için duygusal ve ritmik tema haritası olarak okunur.
POST/v1/lunar-return
curl -X POST https://api.astroway.info/v1/lunar-return \
-H "X-Api-Key: aw_live_..." \
-H "Content-Type: application/json" \
-d '{
"date": "1990-05-15",
"time": "14:30:00",
"timezoneOffset": 3,
"latitude": 50.45,
"longitude": 30.52,
"afterDate": "2026-06-15"
}'{
"ok": true,
"data": {
"input": {},
"planets": [
{
"name": "Moon",
"longitude": 282.7,
"sign": "Capricorn",
"house": 6
}
],
"houses": {
"ascendant": 201.5,
"mc": 110.3,
"cusps": [
"…"
]
},
"aspects": [
"…"
]
}
}Parameters
| name | type | Required | |
|---|---|---|---|
| date | string (YYYY-MM-DD) | yes | Birth date. |
| time | string (HH:MM:SS) | yes | Local clock time at birth. |
| timezoneOffset | number (hours) | yes | UTC offset in effect at the birth moment (e.g. 3 for Kyiv summer time). Decimal allowed for half-hour zones. |
| latitude | number | yes | Birth-place latitude, decimal degrees (north positive). |
| longitude | number | yes | Birth-place longitude, decimal degrees (east positive). |
| afterDate | string (YYYY-MM-DD) | yes | Required start date (YYYY-MM-DD); the endpoint finds the first lunar return on or after it. |
| afterTime | string (HH:MM:SS) | no | Optional clock time of the start point (HH:MM:SS). |
| afterTzOffset | number (hours) | no | Optional UTC offset for the start point, in hours. |
| locationLat | number | no | Optional latitude in decimal degrees to relocate the return chart, north positive. |
| locationLng | number | no | Optional longitude in decimal degrees to relocate the return chart, east positive. |
When to use it
Kısa döngülü, yaklaşık aylık tahminler için Ay dönüşünü kullanın - bir 'bir sonraki ay' özelliği, duygusal-ritim takipçisi, veya yıllık güneş dönüşünün daha detaylı bir eşlikçisi. Güneş dönüşü bir yılı çerçevelediği yerde, Ay dönüşü önümüzdeki dört haftayı çerçeveleyerek tekrarlayan aylık raporlar ve alışkanlık veya ruh hali döngüleri için çok uygundur. Başlangıç tarihini bir sonraki dönüşün istediğiniz nokta olarak geçirin - genellikle bugün, veya son dönüşün tarihi - ve uç nokta ilerleyerek yaklaşan birine ulaşır. İsteğe bağlı konum geçişi, kişinin o ay aslında bulunduğu yer doğum yerine göre dönüşü çıkarmanızı sağlar, bu açı hassasiyetli evler için önemlidir. Aylık haritaların ardışık dizisini oluşturmak için ardışık çağrıları birleştirin.
Notes
Uç nokta, verilen tarih veya sonrasındaki tek bir dönüşü, bir dizi değil döndürür - bir dizi oluşturmak için başlangıç tarihini ilerleterek tekrar çağırın. ~27.3 günlük rakam yıldızsal aydır, bu nedenle dönüşler takvime karşı kayar. Konum sağlanmazsa harita doğum yerinde çıkarılır; bir geçiş sadece açıları ve evleri yeniden konumlandırır. Tropik zodyak ve Swiss Ephemeris boyunca.
Try the Ay Dönüşü API
Grab a key and make your first call in under a minute.