Parans API
الباران هو النقطة التي تتقاطع فيها خطان من خطوط الفلكية الخرائطية: مكان حيث كان كوكبان زاويان في نفس الوقت. هذه الendpoint تُرجع كل تقاطع لوقت الولادة، مع إحداثيات كل واحد، بحيث يمكنك وضع علامات على نقاط الخريطة حيث يندمج موضوعان كوكبيان بدلًا من مجرد مرورهما جنبًا إلى جنب.
Parans API
الendpoint يحول وقت الولادة إلى يوم جولياني، يحسب مجموعة الفلكية الخرائطية الكاملة (أربع خطوط زاوية لكل جسم)، ثم يتقاطع كل خط مع كل خط يخص كوكبًا مختلفًا. كل تقاطع يُرجع مع الكوكبين الأصليين، ونوعَي الخطين، وخط العرض والطول حيث يقع التقاطع. لأن خطوط MC و IC هي خطوط طولية وخطوط AC و DC تعتمد على خط العرض، معظم التقاطعات تكون هندسية وليس متماثلة: زوج Sun-MC و Moon-ASC يلتقي في مكان واحد بالضبط لكل نصف كرة، وليس على شريط مشترك. مخطط نموذجي ينتج أكثر من أربع مئة تقاطع حول العالم، لذلك تُرجع كقائمة مسطحة قابلة للترتيب بدلًا من تصفية مسبقة حسب الأهمية.
POST/v1/parans
curl -X POST https://api.astroway.info/v1/parans \
-H "X-Api-Key: aw_live_..." \
-H "Content-Type: application/json" \
-d '{
"date": "1990-05-15",
"time": "14:30:00",
"timezoneOffset": 3
}'{
"ok": true,
"data": {
"count": 414,
"parans": [
{
"planet1Id": 0,
"planet1Name": "Sun",
"line1Type": "MC",
"planet2Id": 1,
"planet2Name": "Moon",
"line2Type": "ASC",
"location": { "lat": -45.9153, "lng": 6.5735 }
}
]
}
}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) | no | UTC offset in effect at the birth moment. Defaults to 0. Decimal allowed for half-hour zones. |
When to use it
استخدم الباران عندما تكون خطوط الفلكية الخرائطية وحدها خشنّة جدًا. الخطوط تخبر المستخدم أن ممرًا يحمل المشتري؛ الباران تخبره أن في نقطة محددة على ذلك الممر يلتقي المشتري بالزهرة. هذا الفرق هو ما يفرضه مستشارو الانتقال، وهو الطبقة التي تتخطاها معظم أدوات الخرائط. عمليًا: ارسم الخطوط كخطوط متعددة والباران كعلامات قابلة للنقر، أو صَفِّ القائمة إلى أزواج الكواكب التي يهتم بها منتجك ورتب المدن القريبة حسب القرب من تلك النقاط. الاستجابة تحتوي فقط على إحداثيات، لذا يمكنك ربطها ببيانات مدينتك أو منطقتك دون الحاجة لتنسيق نصي. لاحظ أن هذا الendpoint لا يحتاج إلى مكان الولادة، فقط إلى اللحظة، لأن التقاطعات هي خصائص للسماء وليس لمكان وجود الشخص.
Notes
المواقع مأخوذة من Swiss Ephemeris (Astrodienst) المجمعة إلى WASM، نفس المحرك المستخدم في الendpoints الفطرية، لذا الباران ترتكز على نفس خطوط الطول الكوكبية التي تستمد منها الخطوط. التقاطعات تُحسب في البروج الاستوائي من الهندسة الكاملة للخط وليس من تقريب خط العرض. العقيدة الكلاسيكية للباران كما وضعتها Bernadette Brady تعالج أيضًا باران النجمة إلى الكوكب، وتُبلغ عنها كخط عرض وليس كنقطة؛ لهذا الحالة يوجد endpoint خاص بها، [star-planet parans](/astrology-api/star-parans/). هذا يغطي حالة الكوكب إلى الكوكب التي يولدها خريطة الفلكية الخرائطية نفسها.
Try the Parans API
Grab a key and make your first call in under a minute.