API الفلك لـ Local Space
Local Space يطرح سؤال مختلف عن astrocartography: ليس أين على الأرض كان الكوكب زاويًا، بل في أي اتجاه بوصلة كان من مكان الولادة. الـ endpoint يرجع azimuth و altitude لكل جسم، بالإضافة إلى great-circle path اللي يتبعها الاتجاه عبر الكرة الأرضية.
API الفلك لـ Local Space
الـ endpoint يبني خريطة الميلاد، يحول كل كوكب من إحداثيات الإكليبتك إلى إطار الأفق لمكان الولادة، ويرجع الـ azimuth بالدرجات باتجاه عقارب الساعة من الشمال الحقيقي مع الـ altitude فوق أو تحت الأفق. بعدين يطرح كل azimuth كدائرة كبيرة من مكان الولادة ويرجع المسار الناتج كسلسلة إحداثيات، بحيث الخط المرسوم على خريطة العالم يبقى اتجاه حقيقي مو خط مستقيم على إسقاط مسطح. فيه ثلاثة عشر جسم، كل واحد له لون ثابت عشان الخريطة المرسومة تحافظ على نفس الباليت لبقية الحزمة. الـ altitude مهم زي الـ azimuth هنا: كوكب تحت الأفق وقت الولادة يقرأ بشكل مختلف عن كوكب عالي في السماء بنفس الاتجاه.
POST/v1/local-space
curl -X POST https://api.astroway.info/v1/local-space \
-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": {
"birthplace": { "latitude": 50.45, "longitude": 30.52 },
"count": 13,
"lines": [
{
"planetId": 0,
"planetName": "Sun",
"azimuth": 219.8018,
"altitude": 53.1309,
"color": "#FFB300",
"points": [{ "lat": 50.45, "lng": 30.52 }, "…"]
}
]
}
}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). Local space is anchored here, so this is not optional. |
| longitude | number | yes | Birth-place longitude, decimal degrees (east positive). |
When to use it
استخدم local space لما يكون المنتج عن الاتجاه والمسافة من منزل ثابت بدلًا من الموقع المطلق على الكرة الأرضية. فيه حالتين رئيسيتين. الأولى هي الانتقال بأي حجم، من اختيار أي مدينة على اتجاه مفضل إلى تحديد أي اتجاه تتحرك فيه داخل دولة، لأن دائرة كبيرة من مكان الولادة تمر بأراضي أكثر قابلية للاستخدام من شوية خطوط astrocartography. الثانية هي الأعمال الداخلية ومواقع البناء، حيث تُقَرَأ نفس الـ azimuths على مستوى الغرفة داخل مسكن: الـ endpoint يرجع الاتجاهات، و/ local-space /influence-zone يحوّل واحد منها إلى مضلع مخروط تقدر ترسمه. إذا كنت ترسم astrocartography بالفعل، إضافة local space هي أرخص طريقة لتضاعف عمق ميزة الانتقال، لأنها تستخدم نفس مدخلات الولادة ونفس سطح الخريطة.
Notes
المواقع جايّة من Swiss Ephemeris (Astrodienst) المجمّعة إلى WASM. الـ azimuth يُقاس باتجاه عقارب الساعة من الشمال الحقيقي، مو الشمال المغناطيسي، فما في تصحيح انحراف مطلوب أو مُطبّق. الـ great-circle path يُرجع كإحداثيات مُعَينة بدلًا من صيغة، وهذا يخلي العميل بعيد عن الهندسة الكروية. التقنية بهالشكل طوّرها Michael Erlewine ومُوثّقة في Astrophysical Directions.
Try the Local Space API
Grab a key and make your first call in under a minute.