واجهة برمجة تطبيقات العودة القمرية
ابحث عن اللحظة التالية التي يعود فيها القمر إلى خط الطول الميلادي الخاص به في أو بعد تاريخ محدد - كل حوالي 27.3 يومًا - وحساب المخطط له في موقع تختاره. مرر بيانات الميلاد وتاريخ البدء، واحصل على مخطط العودة القمرية. بدقة Swiss Ephemeris، مخرجات JSON.
واجهة برمجة تطبيقات العودة القمرية
نقطة نهاية العودة القمرية تقرأ خط الطول الميلادي الدقيق للقمن من بيانات الميلاد المزودة، ثم تبحث من تاريخ البدء المحدد عن اللحظة الأولى التي يعود فيها القمر المتحرك إلى نفس خط الطول. بما أن القمر يكمل دورة سديرية في حوالي 27.3 يومًا، فإن هذه العودة تحدث كل شهر تقريبًا. تحول نقطة النهاية اللحظة المطابقة إلى يوم يولياني، وتستخرج المواقع والسرعات الجيوسمرتية من محرك Swiss Ephemeris، وتصنع مخططًا كاملاً لها - كواكب العودة مع الأبراج ومواضع البيوت، حواف البيوت، والشبكة الكاملة للجوانب مع علامات التطبيق والانفصال والمدارات الدقيقة. بشكل افتراضي، يتم حساب المخطط في مكان الميلاد، ولكن يمكنك توفير خطوط عرض و طول مختلفة لإعادة الموقع، مما يعيد تشكيل الزوايا والبيوت مع الحفاظ على نفس لحظة العودة. النتيجة تقرأ كخريطة موضوعية عاطفية وإيقاعية للشهر القمري القادم.
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
استخدم العودة القمرية للتنبؤ بدورات قصيرة، شهرية تقريبًا - ميزة 'الشهر القمري القادم'، أو متتبع الإيقاع العاطفي، أو مرافق أكثر دقة للعودة الشمسية السنوية. حيث تضع العودة الشمسية إطارًا للسنة بأكملها، تضع العودة القمرية إطارًا للأربع أسابيع القادمة، مما يجعلها مناسبة للتقارير الشهرية المتكررة ودورات العادات أو المزاج. مرر تاريخ البدء كنقطة تريد العودة التالية بعد - غالبًا اليوم، أو تاريخ آخر عودة - وتتحرك نقطة النهاية إلى الأمام نحو القادمة. تجاوز الموقع الاختياري يسمح لك بحساب العودة في المكان الذي يكون فيه الشخص فعليًا ذلك الشهر بدلاً من مكان ميلاده، وهو أمر مهم للبيوت الحساسة للزاوية. قم بالسلسلة من الاستدعاءات المتتالية لبناء سلسلة متحركة من المخططات الشهرية.
Notes
تُرجع نقطة النهاية العودة التالية الواحدة في أو بعد التاريخ المحدد، وليس سلسلة - استدعِ بشكل متكرر، متقدمًا تاريخ البدء، لبناء سلسلة. الرقم ~27.3 يومًا هو الشهر السديري، لذا تنحرف العودة مقابل التقويم. لم يتم توفير موقع، يتم حساب المخطط في مكان الميلاد؛ التجاوز يعيد الموقع للزوايا والبيوت فقط. برج الاستواء و Swiss Ephemeris طوال الوقت.
Try the العودة القمرية API
Grab a key and make your first call in under a minute.