واجهة برمجة تطبيقات اتجاهات الشمسية
تحرك الشمسية المخطط بأكمله إلى الأمام بمقدار واحد: المسافة التي قطعتها الشمس بالتقدم الثانوي. كل كوكب، كل حافة زاوية وزاويتان تتغيران بنفس القوس، لذلك يصبح الجانب المولود الذي كان على بعد درجتين من الدقة بالضبط دقيقًا بعد حوالي عامين. يعود هذا نقطة النهاية إلى المخطط الموجه والقوس الذي أنتجته.
واجهة برمجة تطبيقات اتجاهات الشمسية
من بيانات الميلاد وتاريخ الهدف، تقوم نقطة النهاية أولاً بتقدم المخطط يومًا مقابل عام، وتقيس مدى تحرك الشمس المتقدمة من موضعها المولود، وتأخذ تلك المسافة كقوس. ثم يضيف القوس إلى كل طول مولود دفعة واحدة: جميع الكواكب، جميع حواف المنازل، والصاعد والوسط. يحمل الاستجابة المواضع الموجودة تحت data.planets و data.houses، والقوس نفسه بالدرجات تحت data.arc، والمفتاح الذي أنتجته تحت data.key. بما أن قوسًا واحدًا يتم تطبيقه بشكل موحد، يتم الحفاظ على هندسة المخطط المولود وتتغير فقط علاقته بالدرجات المولودة، وهو ما يجعل التقنية اقتصادية للقراءة: رقم واحد يخبرك بحالة المخطط بأكمله في عمر معين. متاح مفتاحان آخران على نفس نقطة النهاية. اضبط المفتاح على naibod لمعدل الشمس المتوسط 59'08.3" في السنة، أو تجاهله للحصول على درجة واحدة في السنة العادية. إرسال converse true توجه للخلف من لحظة الميلاد بدلاً للأمام، عكس إشارة القوس.
POST/v1/symbolic-directions
curl -X POST https://api.astroway.info/v1/symbolic-directions \
-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,
"targetDate": "2026-05-15",
"key": "solar_arc"
}'{
"ok": true,
"data": {
"arc": 34.5083,
"key": "solar_arc",
"planets": [
{
"id": 0,
"name": "Sun",
"longitude": 88.8843,
"isRetrograde": false
}
],
"houses": {
"system": "P",
"ascendant": 204.4763,
"mc": 111.5826
}
}
}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. 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). |
| targetDate | string (YYYY-MM-DD) | yes | The date the chart is directed to. |
| key | string | no | Directional key: solar_arc (the arc of the progressed Sun), naibod (59'08.3" per year), or one_degree (the default, 1° per year). |
| converse | boolean | no | Direct backwards from the birth moment instead of forwards. Reverses the sign of the arc. |
When to use it
استخدم الشمسية عندما تحتاج إلى توقيت رمزي بدلاً من فلكي، وعندما تريده في شكل يمكن القارئ متابعته. بما أن كل شيء يتحرك بنفس المعدل، يصل اتصال موجه إلى عام محدد بدلاً من نافذة، وهو ما يناسب ميزارن حياة، أو تقرير علامة عمر، أو سرد ذكي يجب أن يشرح ما يتعلق بعام معين. يزوج بشكل طبيعي مع التقدم الثانوي، حيث أن القوس مشتق من نفس الشمس المتقدمة: التقدم يعطيك المخطط الداخلي المتحرك، والشمسية تعطيك المخطط بأكمله مترجمًا للأمام. قارن بين المفاتيح الثلاثة عندما تكون الدقة مهمة لجمهورك. الشمسية تتبع الشمس الفعلية لذا تختلف قليلاً حسب تاريخ الميلاد، بينما يستخدم Naibod المعدل المتوسط، ودرجة واحدة في السنة هي التقريب التقليدي. لميلاد في منتصف مايو، تكون النتائج الثلاثة حوالي 34.5، 35.5 و 36.0 درجة على مدى 36 عامًا، قريبة بما يكفي للاتفاق على العقد، وبعيدة بما يكفي لتسمية سنوات مختلفة.
Notes
القوس هو المسافة التي قطعتها الشمس المتقدمة ثانويًا، يوم مقابل عام، وهو التعريف القياسي؛ يستخدم مفتاح Naibod الحركة اليومية المتوسط للشمس، 59'08.3" في السنة. بالنسبة للشمسية، يتم حساب المخطط المتقدم للأمام ويتم تطبيق اتجاه السفر مرة واحدة، لذا فإن الاتجاهات العكسية تعيد القوس سالبًا بدلاً من مضاعفته. تأتي المواضع من محرك Swiss Ephemeris في البرج الاستوائي، على نفس الأجسام وأنظمة المنازل نقاط النهاية المولودة.
Try the اتجاهات الشمسية API
Grab a key and make your first call in under a minute.