ForHosting KIT · أدوات المطورين

حساب المطلع المستقيم من الإحداثيات الكسوفية

تحوّل هذه الحاسبة الطول الكسوفي والعرض الكسوفي لجرم ما إلى المطلع المستقيم في النظام الاستوائي.

● Betaمجاني · داخل متصفحك

استخدمها من الويبAPIالبريدTelegramالتطبيق قريبًا

وهي تطبق ميل الكسوف على هيئة دوران ثلاثي الأبعاد للإحداثيات، وتحافظ على الربع الصحيح، ثم تعيد النتيجة بالساعات العشرية من 0 إلى أقل من 24. الحساب حتمي، كما يقبل أطوالاً تتجاوز دورة واحدة بعد تطبيعها قبل الدوران. وتتحقق الحاسبة أيضاً من العرض والميل، كي تؤدي الهندسة الزاوية غير الصحيحة إلى رسالة خطأ واضحة بدلاً من إحداثي يبدو معقولاً وهو مضلل.

أدخلوا إحداثيات من الإطار والحقبة نفسيهما

أدخلوا الطول الكسوفي والعرض الكسوفي وميل الكسوف بالدرجات العشرية. يجب أن تصف القيم الثلاث الإطار المرجعي والحقبة نفسيهما. وهذا مهم لأن ميل الكسوف يتغير ببطء مع الزمن، في حين قد ترتبط إحداثيات الفهرس بحقبة قياسية مثل J2000.0 أو تكون محسوبة لتاريخ الرصد. يؤدي خلط إحداثيات حقبة بميل مأخوذ من حقبة أخرى إلى انزياح منهجي، حتى لو اكتملت العملية الحسابية بنجاح. يمكن كتابة الطول ضمن المجال المعتاد من 0 إلى 360 درجة، أو بقيمة مكافئة خارجه؛ إذ تطبّع الحاسبة الدورات الكاملة تلقائياً. يجب أن يبقى العرض بين -90 و90 درجة، وأن يبقى الميل بين 0 و90 درجة. استخدموا عدداً من المنازل العشرية يناسب الدقة المطلوبة، لكن تذكروا أن زيادة الأرقام لا تعوض عدم يقين الإحداثيات الأصلية، أو تقريب الحقبة، أو التأثيرات الجوية، أو عدم تطابق الأطر المرجعية.

كيف ينتج المطلع المستقيم من دوران الإحداثيات

يمثل التحويل أولاً الموضع الكسوفي بمتجه ديكارتي وحدي. ثم يدير ذلك المتجه حول المحور x المشترك وفق ميل الكسوف المدخل، فينقل اتجاهه من المستوى الكسوفي إلى المستوى الاستوائي. المطلع المستقيم هو زاوية إسقاط المتجه بعد دورانه على المستوى الاستوائي x-y. تحسب الأداة هذه الزاوية بدالة ظل عكسي ذات وسيطين، فتحفظ إشارات مركبتي الإسقاط وتختار الربع الصحيح. أما دالة الظل العكسي ذات الوسيط الواحد فقد تخلط بين موضعين يفصل بينهما اثنتا عشرة ساعة. تُطبّع الزاوية الناتجة إلى دورة موجبة كاملة، ثم تُقسم على خمسة عشر لأن 360 درجة تقابل 24 ساعة. لذلك تكون القيمة المعادة دائماً أكبر من أو تساوي الصفر وأقل من 24. وإذا وقع الموضع بعد الدوران عند قطب سماوي تماماً، فلن يكون لإسقاطه اتجاه ويصبح المطلع المستقيم غير معرّف رياضياً؛ وعندئذ تعيد الحاسبة خطأ بدلاً من اختلاق قيمة زمنية.

فسّروا نتيجة الساعات العشرية وتحققوا منها

تأتي النتيجة بوصفها مطلعاً مستقيماً بالساعات العشرية، وهي مناسبة للمعالجة العددية ومقارنة الفهارس وعرض الإحداثيات والحسابات الفلكية اللاحقة. لتحويلها إلى ساعات ودقائق وثوان، خذوا الجزء الصحيح ساعات، واضربوا الكسر المتبقي في 60 للحصول على الدقائق، ثم اضربوا كسر الدقيقة في 60 للحصول على الثواني. انتبهوا قرب حد الالتفاف: فالنتيجة القريبة من 24 ساعة تجاور 0 ساعة على السماء، ولا تفصلها عنها دورة كاملة عملياً. وللتحقق، جرّبوا موضعاً طوله وعرضه صفر؛ إذ يجب أن يعطي صفراً من الساعات مع أي ميل صحيح. ويمكن أيضاً جعل الميل صفراً، وعندها يتطابق المستويان ويصبح المطلع المستقيم مساوياً للطول المطبع مقسوماً على خمسة عشر، باستثناء القطب. تعيد الحاسبة الإحداثي الهندسي فقط، ولا تطبق المبادرة أو الترنح أو الزيغ أو اختلاف المنظر أو الانكسار أو تصحيحات توقيت الرصد.

حالات الاستخدام

تحويل موضع من فهرس فلكي

حوّلوا طول الفهرس وعرضه إلى مطلع مستقيم عشري باستعمال ميل الكسوف الموافق لحقبته.

التحقق من حساب فلكي

قارنوا النتيجة الاستوائية في مساركم بدوران حتمي مستقل يحافظ على الربع الصحيح.

إعداد إحداثيات لخريطة سماوية

أنشئوا مطلعاً مستقيماً مطبعاً لبرامج تعرض الأجرام أو ترتبها بحسب الساعات العشرية.

الأسئلة الشائعة

ما تكلفة الحساب عبر API؟

تبلغ تكلفة كل طلب API مقدار $0.002. ويمكن إجراء الحساب الحتمي نفسه في المتصفح أيضاً.

ما الوحدات التي ينبغي استخدامها؟

أدخلوا الطول الكسوفي والعرض الكسوفي وميل الكسوف بالدرجات العشرية. تعاد النتيجة بالساعات العشرية.

لماذا تُقسم النتيجة على 15؟

يُقاس المطلع المستقيم بالساعات اصطلاحاً، والدورة الكاملة البالغة 360 درجة تساوي 24 ساعة، ولذلك تقابل كل ساعة 15 درجة.

لماذا يجب أن يقع ميل الكسوف بين 0 و90 درجة؟

تمثل هذه القيمة الزاوية بين المستويين الكسوفي والاستوائي. ولا يقبل نموذج الإحداثيات قيماً خارج هذا المجال.

هل يمكن استخدام طول كسوفي سالب؟

نعم. يُطبّع الطول بترديد 360 درجة، فتتحول القيم السالبة والقيم التي تتجاوز 360 إلى اتجاهها المكافئ.

هل يشمل الحساب المبادرة أو الترنح؟

لا. فهو يجري الدوران الهندسي فقط للإحداثيات والميل المدخلين. طبّقوا تصحيحات الحقبة والموضع الظاهري بصورة منفصلة عند الحاجة.

للمطوّرين — الوصول عبر API

كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.

الـEndpoint

POSThttps://api.kit.forhosting.com/astro/ra-from-ecliptic

صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.

استدعِ الخدمة من بيئتك

curl -X POST https://api.kit.forhosting.com/astro/ra-from-ecliptic \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ecliptic_longitude_deg":139.686111,"ecliptic_latitude_deg":4.875278,"obliquity_deg":23.4392911}'

const res = await fetch("https://api.kit.forhosting.com/astro/ra-from-ecliptic", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "ecliptic_longitude_deg": 139.686111,
    "ecliptic_latitude_deg": 4.875278,
    "obliquity_deg": 23.4392911
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/astro/ra-from-ecliptic",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "ecliptic_longitude_deg": 139.686111,
    "ecliptic_latitude_deg": 4.875278,
    "obliquity_deg": 23.4392911
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/astro/ra-from-ecliptic", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"ecliptic_longitude_deg":139.686111,"ecliptic_latitude_deg":4.875278,"obliquity_deg":23.4392911}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"ecliptic_longitude_deg":139.686111,"ecliptic_latitude_deg":4.875278,"obliquity_deg":23.4392911}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/astro/ra-from-ecliptic", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

مثال على الطلب

{
  "ecliptic_longitude_deg": 139.686111,
  "ecliptic_latitude_deg": 4.875278,
  "obliquity_deg": 23.4392911
}

مثال على الاستجابة

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "astro.ra_from_ecliptic",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.

الأسعار

لكل طلب$0.002

السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.

الأخطاء

HTTP	الرمز	المعنى
`401`	`unauthorized`	مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك.
`402`	`insufficient_balance`	رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة.
`404`	`unknown_type`	نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب.
`429`	`rate_limited`	تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.

اطّلع على توثيق KIT الكامل ←