واجهة برمجة تطبيقات تفسير علم المكان الفلكي
هندسة الخطوط وحدها لا تخبر المستخدم أين يجب أن ينتقل. نقطة النهاية هذه تأخذ مجال حياة، وتختار خطوط علم المكان الفلكي التي تحكمه فعليًا، وتصنفها حسب قوة ومدى تطبيقها، وتعيد نص التفسير لكل منها. مكالمة واحدة تحل محل تعيين الكوكب إلى الموضوع الذي يجب على كل منتج إعادة توطين أن يبتكره داخليًا.
واجهة برمجة تطبيقات تفسير علم المكان الفلكي
تقوم نقطة النهاية بحساب مجموعة علم المكان الفلكي الكاملة لموعد الولادة، ثم تفلترها من خلال تصنيف لمجالات حياة تسعة عشر مبنية على الأدبيات المؤسسة للأسلوب: جيم لويس لمعنى الكوكب عند الزاوية، إيرين سوليفان لما تحكمه كل من الزوايا الأربع، ومارتين ديفيس للتعامل مع الخطوط الصعبة. يسمي كل مجال الخطوط التي تنتمي إليه بوزن من واحد إلى ثلاثة، لذا فإن الشمس عند الوسطى تفوق عطارد عند نفس الزاوية فيما يتعلق بالمسيرة المهنية. يحمل كل تعيين أيضًا قطبية، ويتم إرجاع الخطوط التحدي جنبًا إلى جنب مع الخطوط الداعمة بدلاً من فلترةها، لأن أداة إعادة التوطين التي تظهر فقط الخطوط المواتية تمثل الأسلوب بشكل خاطئ. عندما تمر عبر نقطة، تختفي الخطوط خارج النصف القطر، وتضاعف القوة المعادة الوزن الفلكي بالقرب الجغرافي، وهو ما يسمح لك بتصنيف المدن المرشحة بدلاً من مجرد سرد الخطوط. يتم تقديم نص التفسير من قاعدة معرفة منتقاة تغطي جميع أربعين مزيج الكوكب والزاوية في أحد عشر لغة، مع وجود احتياطي موثق عند عدم وجود ترجمة.
POST/v1/acg/by-category
curl -X POST https://api.astroway.info/v1/acg/by-category \
-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,
"category": "career",
"point": { "lat": 51.5074, "lng": -0.1278 },
"radiusDeg": 8,
"language": "en"
}'{
"ok": true,
"data": {
"category": { "id": "career", "name": "Career" },
"language": "en",
"count": 3,
"lines": [
{
"planet": "Jupiter",
"type": "MC",
"weight": 3,
"polarity": "supportive",
"strength": 2.31,
"distanceDeg": 1.84,
"pointCount": 341,
"segments": [
[[-85, 110.48], [-84.5, 110.48], "…"]
],
"interpretation": {
"title": "Jupiter - MC",
"text": "Expansion of professional opportunity…",
"lang": "en"
}
}
]
}
}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. |
| category | string | yes | One of 19 life areas: career, love, money, health, home, learning, power, travel and more. Fetch the full list from GET /v1/acg/categories. |
| point | { lat, lng } | no | Optional geographic focus. With it, only lines running within radiusDeg of that point are returned and strength folds in proximity. |
| radiusDeg | number | no | Search radius in degrees around point. Default 4, range 0.5 to 20. |
| polarity | string | no | supportive, challenging, or all (default). Challenging lines are returned by default rather than hidden. |
| includeText | boolean | no | Attach the interpretation text for each line. Default true. |
| includeCoordinates | boolean | no | Attach the line geometry as `segments`, an array of `[lat, lng]` polylines. A rising or setting curve is several disjoint segments, so they are kept separate rather than concatenated. Default true; set false for a compact ranking response. |
| language | string | no | Interpretation language. Falls back to English then Ukrainian when a translation is missing, and the served language is reported per line. |
When to use it
استخدم هذا عندما يجيب منتجك على سؤال صيغ بلغة عادية: أين يجب أن أذهب للعمل، أي هذه المدن الثلاثة أفضل للعلاقة، ماذا يعني هذا الخط فوق مدينتي حقًا. تغطي ثلاثة أشكال معظم البناءات. التصنيف، عن طريق إرسال فئة ونقطة لكل مدينة مرشحة والفرز حسب القوة. الشرح، عن طريق استدعاء /v1/acg/line-report لكوكب وزاوية واحد للحصول على النص الكامل بالإضافة إلى كل مجال حياة آخر يلامس هذا الخط. الاكتشاف، عن طريق جلب GET /v1/acg/categories مرة واحدة عند صفر ائتمان وبناء واجهة المستخدم الخاصة بك من التصنيف المعاد، بحيث تظهر فئة جديدة بدون إصدار عميل. بما أن النص منتقاة وليس مولدة، فإن الاستجابات محددة، لا تشير إلى أي نموذج، ولا تكلف شيئًا إضافيًا في الاستدلال: نفس الطلب يعيد نفس الكلمات غدًا.
Notes
يغطي التصنيف العشرة الأجسام التقليدية. تظهر كايرون، ليليت والعقد القمرية في هندسة /v1/acg ولكنها تكون خارج التعيين عن قصد، حيث لا يحددها الأسلوب كما حدده جيم لويس كحكام لمجالات حياة زاوية. الأوزان والقطبيات هي حكم تحريري معبر عنه كبيانات، موسوم في المستودع وقابل للمراجعة بدلاً من أن يكون مخفيًا داخل طلب. نص التفسير هو بحث في قاعدة المعرفة، وليست استدعاء لنموذج لغوي، لذا فهو مستقر، قابل للتكرار دون اتصال، وخالي من التحذيرات التي يتطلبها التفسير المولد.
Try the تفسيرات علم المكان الفلكي API
Grab a key and make your first call in under a minute.