API للخرائط الفلكية
الخرائط الفلكية تأخذ لحظة ولادة واحدة وتُسقطها على كامل الكوكب: بدلاً من سؤال أين كانت الكواكب في السماء، تسأل أين كان كل كوكب زاويًا على الأرض. الـendpoint يُرجع هندسة الخط التي تُرسمها على خريطة العالم لتُظهر أي خطوط طول تُفعّل أي طاقة كوكبية.
API للخرائط الفلكية
من تاريخ الميلاد، وقت الساعة، فرق UTC، وإحداثيات الميلاد، الـendpoint يحدد السماء الدقيقة لتلك اللحظة، ثم يجوب الكرة الأرضية ليجد كل خط طول ومنحنى حيث كان الكوكب في أحد الزوايا الأربعة. لكل من الكواكب العشرة بالإضافة إلى العقد، يرسم أربع عائلات من الخطوط: خط الصعود حيث كان الجسد على الصاعد، خط الغروب على الهابط، الخط القمري على السماء المتوسطة، والخط المضاد للقمري على القاع السماوي. خطوط MC و IC تمتد كخطوط طول نظيفة؛ خطوط AC و DC تنحني كمنحنيات تعتمد على خط العرض، لأن جسمًا يشرق مباشرةً شرقًا عند خط عرض معين يشرق بعيدًا شمالًا أو جنوبًا عند آخر. كل شيء يُرجع كـ line geometry قابلة للتسلسل تحت data.lines، جاهزة لتُغذّى مباشرةً إلى مكتبة رسم الخرائط. هذه التقنية الانتقالية شُهرت بفضل جيم لويس كـ Astro*Carto*Graphy.
POST/v1/astrocartography
curl -X POST https://api.astroway.info/v1/astrocartography \
-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": {
"lines": [
{
"planet": "Venus",
"type": "MC",
"longitude": 14.2
},
{
"planet": "Jupiter",
"type": "AC",
"points": [
"…"
]
}
]
}
}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 عندما تكون الموقع هو المتغيّر وتريد معرفة كيف يعيد المخطط نفسه عبر الخريطة - لنصائح الانتقال، السفر، وأدوات اختيار مكان السكن، أو أي ميزة تُظهر مخطط شخص على الكرة الأرضية. هو الـbackend الطبيعي لخريطة تفاعلية: اطلب الخطوط مرة واحدة للحظة الولادة، ارسمها كـ polylines، وخلي المستخدم يمرّر عبر القارات ليعرف أي كوكب يتحكم في أي ممر. لأن النتيجة هي هندسة صافية وليس نصًا، تتماشى بسهولة مع تنسيق الـfront-end الخاص بك، والتجميع، وطبقات click-to-interpret. اجمعه مع استدعاء natal-chart لما تريد هيكل المخطط الأصلي والخطوط المنقولة جنبًا إلى جنب؛ الاثنين يشاركان نفس دقة الولادة، لذا مواضع الكواكب خلف الخريطة تتطابق تمامًا.
Notes
المواقع جايّة من Swiss Ephemeris (Astrodienst)، نفس المحرك وراء الـnatal endpoints، لذا الخطوط ترتكز على خطوط الطول الكوكبية المتطابقة. الزاوية تُحسب في البروج الاستوائي. الاستجابة تحمل geometry فقط - الرسم، الإسقاط، وتنسيق الـworld map تُترك للعميل الخاص بك.
Try the الخرائط الفلكية API
Grab a key and make your first call in under a minute.