واجهة برمجة تطبيقات علاج السنة الشمسية الجغرافي الفلكي
علاج الميلاد الجغرافي الفلكي يحدد أين يعمل الرسم البياني. علاج السنة الشمسية الجغرافي الفلكي يحدد أين يعمل هذا العام. نقطة النهاية تحسب اللحظة الدقيقة التي يعود فيها الشمس إلى خط الطول الميلادي في السنة التي تحددها، ثم يرسم ذلك الرسم البياني عبر العالم ك مجموعة من الخطوط الزاوية.
واجهة برمجة تطبيقات علاج السنة الشمسية الجغرافي الفلكي
تقوم نقطة النهاية أولاً ببناء الرسم البياني الميلادي، ثم تبحث عن اللحظة في السنة المطلوبة التي يصل فيها الشمس المتحرك إلى خط الطول الشمسي الميلادي، بدقة تقل عن ثانية قوسية. إنها تحسب مواقع الكواكب لتلك اللحظة وتتبع عائلات الخطوط الزاوية الأربع عبر العالم، تمامًا كما تفعل نقطة نهاية علاج الميلاد الجغرافي الفلكي، مع إرجاع ثلاثة وستين خطًا. يحمل كل اسم كوكب لاحقة SR بحيث لا يمكن للعميل الذي يعرض الخريطين في وقت واحد الخلط بين خط المشتري الميلادي وخطر السنة الشمسية. يتم إرجاع الخطوط كأزواج إحداثيات بنفس شكل /acg، لذا لا يحاجب العارض الحالي أي تغييرات بخلاف نمط للطبقة الثانية.
POST/v1/solar-acg
curl -X POST https://api.astroway.info/v1/solar-acg \
-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,
"year": 2026
}'{
"ok": true,
"data": {
"year": 2026,
"lines": [
{
"planet": "Sun (SR)",
"planetId": 0,
"type": "MC",
"coordinates": [[-85, 110.4845], [-84.5, 110.4845], "…"]
}
]
}
}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. |
| latitude | number | yes | Birth-place latitude, decimal degrees. |
| longitude | number | yes | Birth-place longitude, decimal degrees. |
| year | number | yes | Calendar year of the solar return whose map you want. |
When to use it
هذه هي نقطة النهاية وراء السؤال التجاري الأكثر شيوعًا في علم الجغرافيا الفلكي للإقامة: أين يجب أن أمضي عيد ميلادي، وأين يجب أن أقيم هذا العام. يتم تقليدياً حساب مخططات السنة الشمسية لأين يكون الشخص فعلياً في وقت العودة، مما يجعل الموقع قرارًا بدلاً من أمر مسلم به، وهذه الخريطة هي ما يحول ذلك القرار إلى شيء يمكن للمستخدم رؤيته. قم ببناء تقرير إعادة إقامة سنوي، أو موصي برحلة عيد ميلاد، أو طبقة سنوية فوق خريطة الجغرافيا الفلكية الحالية. نظرًا لأن لحظة العودة الأساسية تتغير كل عام، فإن النتيجة هي محتوى يمكن شراؤه بشكل طبيعي بدلاً من حساب لمرة واحدة، ويتكامل مباشرة مع /solar-return عندما يريد المستخدم الرسم البياني بالإضافة إلى الخريطة.
Notes
المواضع تأتي من المبادئ الشمسية السويسرية (Astrodienst) المُجمعة إلى WASM. يتم حل لحظة العودة مقابل خط الطول الشمسي الميلادي في البروج الاستوائية؛ عوائد السنة الشمسية النجمية هي تقنية مختلفة وليست ما تحسبها هذه نقطة النهاية. يتم رسم الخريطة من مخطط العودة فقط، لذا هي بديل كامل للخطوط الميلادية لهذا العام بدلاً من تعديلها. بعض المدارس تحسب العودة لمكان الميلاد بدلاً من الموقع الحالي؛ هذا الخيار ينتمي إلى طبقة التفسير الخاصة بك، حيث أن هندسة الخط نفسها متطابقة في كلتا الحالتين.
Try the علاج السنة الشمسية الجغرافي الفلكي API
Grab a key and make your first call in under a minute.