واجهة برمجة تطبيقات Star-planet parans

لكل نجمة وكوكب الـ endpoint ياخذ الأربعة أحداث زاوية (rising, setting, culminating, anticulminating) ويسأل على أي latitude يصير الحدثين في نفس الـ local sidereal time. الـ culmination يثبت الـ sidereal time عند الـ right ascension للجسم؛ الـ rising والـ setting يحركونه بالـ semi-diurnal arc، وهو تابع للـ latitude والـ declination. كل واحد من الـ twelve event pairs يُحل وكل root يُذكر، مع الـ latitude، الـ sidereal time، والـ meridian اللي فيه الزوج زاوي في هاللحظة من الـ chart. الـ meridian ضد الـ meridian يُرفض: هالشرط ما فيه latitude، فإما ما يصير أبداً أو يصير بكل مكان، وإذا صار بكل مكان يعني إنهم يشاركون الـ right ascension. النجوم اللي انحلت لكن ما أعطت شيء تُذكر بالـ response بدل ما تُسقط صامتاً، وهذا اللي يصير مع نجمة circumpolar مثل Polaris تقريباً بكل النطاق.

curl -X POST https://api.astroway.info/v1/parans/star \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
  "date": "1990-05-15",
  "time": "14:30:00",
  "timezoneOffset": 3,
  "stars": ["Regulus", "Sirius"],
  "planets": [0, 4]
}'

{
  "ok": true,
  "data": {
    "type": "star-parans",
    "horizon": "geometric",
    "latitudeLimit": 60,
    "count": 16,
    "stars": [
      { "name": "Regulus", "magnitude": 1.36, "rightAscension": 151.9686, "declination": 12.0133 }
    ],
    "parans": [
      {
        "star": "Regulus",
        "starEvent": "rise",
        "planetId": 0,
        "planetName": "Sun",
        "planetEvent": "culminate",
        "latitude": 39.1022,
        "longitude": 6.5735,
        "lst": 51.6
      }
    ]
  }
}

استعملها لما طبقة النجوم الثابتة في الـ chart تحتاج تكون أكثر من قائمة تقاربات. نجمة تقابل كوكب بزاوية طول الفلك هي إسقاط؛ الباران هو النجمة والكوكب واقفين فعلياً على الزوايا سوا، وهذا هو العلاقة اللي مبنية عليها شغل Brady واللي تربط نجمة بمكان على الخريطة. في منتج النقل، الـ latitudes تُرسم كأشرطة أفقية، والمدينة اللي قاعدة على واحدة تحمل هالتزاوج نجمة-كوكب. لاحظ إن الـ endpoint ما يحتاج مكان الميلاد، بس اللحظة: أي latitudes موجودة هي خاصية للسماء، مو لمكان ولادة الشخص.

محلول على hour angles بدل ما يكون بتقاطع map polylines، فـ latitude تكون دقيقة بدل ما تكون quantised على خطوة الـ polyline، وتُستعمل الـ declination الفعلية للنجمة بدل درجة البروج اللي تُسقط عليها. هالفرق مهم: Vega على ecliptic latitude 61 درجة وSirius على -39، فدرجة الموقع ما ترتفع قريباً لما ترتفع. مواضع النجوم جايّة من Swiss Ephemeris fixed-star catalogue، والتحويل ecliptic-to-equatorial يُتأكد منه ضد الـ ephemeris نفسه بتشغيل الكواكب من خلاله. مثال Castor اللي اشتغلت عليه Brady يتعاد داخل درجة؛ ما يحدد إذا استخدمت geometric أو apparent horizon، وبما إن الاثنين يختلفوا بحوالي درجتين من paran latitude، هالاختيار يكون request parameter مو default صامت.