API لجوانب الانحدار
معظم عمل الجوانب يتم على طول الإكليبتية في الطول، لكن جسمين يمكنهما أيضًا أن يرتبطا بالdeclination - مسافتهما شمالًا أو جنوبًا من خط الاستواء السماوي. هذه الـendpoint تعمل في البُعد الثاني، وتجد الـparallels والـcontraparallels، وهي نظائر الانحدار للـconjunction والـopposition، وتلاحظ عندما يخرج جسم عن الـout-of-bounds.
API لجوانب الانحدار
من تاريخ الميلاد، الوقت، فرق UTC offset، والإحداثيات تحسب الـendpoint انحدار كل جسم - كم هو شمالًا أو جنوبًا من خط الاستواء السماوي، بعيدًا عن مستوى الإكليبتية الذي يُقاس عليه الطول - ثم تقارن هذه الانحدارات بين الأجسام. عندما يشارك جسمان نفس الانحدار على نفس جانب الخط يُسجل الـparallel، وهو نظير الانحدار للـconjunction؛ وعندما يشاركان نفس الانحدار على جانبي الخط المتقابل يُسجل الـcontraparallel، نظير الـopposition. كل اتصال يُرجع تحت data.parallels مع الأجسام المعنية. كما تُظهر الـendpoint سياق الـout-of-bounds - عندما يتجاوز انحدار جسم أقصى قيمة للـSun، متجاوزًا النطاق الذي يصل إليه الـSun أبداً، وهو حالة تُقرأ تقليديًا كأن الكوكب يعمل بدون قيوده المعتادة. هذا يمنحك طبقة اتصال لا تُظهرها الـpure longitude مطلقًا: كوكبان بدون جانب طولي يمكنهما أن يكونا محبوسين في الـtight parallel.
POST/v1/parallel-aspects
curl -X POST https://api.astroway.info/v1/parallel-aspects \
-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
}'{
"ok": true,
"data": {
"parallels": [
{
"planet1": "Sun",
"planet2": "Moon",
"type": "contra-parallel",
"orb": 0.49
}
]
}
}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). |
When to use it
استخدم هذه الـendpoint عندما لا يجب على محرك الجوانب أن يتوقف عند الإكليبتية - محلل مخطط جدي، أداة توافق أو عبور تريد طبقة الانحدار، أو تقرير يوضح لماذا يشعر كوكبان بالارتباط رغم عدم وجود جانب طولي. الـparallels والـcontraparallels هي بالضبط الاتصالات التي تُهملها شبكة الطول فقط، لذا إضافتها تملأ فجوة حقيقية بدلاً من تكرار مخرجات جوانب المخطط الولادي. علم الـout-of-bounds مفيد بشكل مستقل: يعلّم الكواكب التي تُعاملها التقليد كأنها تعمل بلا قيود، مما يُبرز نقطة واضحة في تقرير المخطط. أرسل نفس بيانات الميلاد التي استخدمتها في أماكن أخرى وستشير اتصالات الانحدار إلى نفس الأجسام كما جوانب الطول، مما يتيح لك عرض الشبكتين كقراءة واحدة للمخطط.
Notes
الـparallels والـcontraparallels تتبع العقيدة التقليدية للانحدار، معاملة اتصالات الانحدار المتساوية كأنالوجات للـconjunction والـopposition؛ قراءة الـout-of-bounds تستند إلى عمل Kt Boehrer. يتم حساب الانحدارات بواسطة Swiss Ephemeris (Astrodienst) محرك في الإطار الاستوائي، على نفس الأجسام كما نقاط النهاية الولادية القائمة على الطول.
Try the جوانب الانحدار API
Grab a key and make your first call in under a minute.