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

حساب طول الظل من زاوية ارتفاع الشمس

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

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

شغّل الأداة مجانًا اطّلع على الـAPI

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

أدخلوا ارتفاعا رأسيا وزاوية شمس صحيحة

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

افهموا علاقة ظل التمام

في النموذج الهندسي المبسط، يشكل الجسم الرأسي وظله الأفقي وشعاع الشمس المستقيم مثلثا قائما. يمثل ارتفاع الجسم الضلع المقابل لزاوية ارتفاع الشمس، ويمثل الظل الضلع المجاور لها. لذلك يساوي ظل الزاوية ارتفاع الجسم مقسوما على طول الظل. وبعد إعادة ترتيب المعادلة، يساوي طول الظل الارتفاع مقسوما على ظل زاوية الارتفاع، وهو ما يكافئ ضرب الارتفاع في ظل التمام. تحول الأداة الدرجات إلى راديان، وتقرب القيم المعروضة إلى 12 منزلة عشرية حتى تكون المخرجات المقروءة آليا مستقرة. عند 45 درجة يساوي الظل 1، ولذلك يتساوى طول الظل مع ارتفاع الجسم. تحت هذه الزاوية يكون الظل أطول من الجسم، وفوقها يكون أقصر. وتوضح نسبة الظل إلى الارتفاع هذه العلاقة، ويمكن إعادة استخدامها لأجسام متعددة تحت ضوء الشمس نفسه. إذا ضاعفتم الارتفاع تضاعف الظل المتوقع، بينما يؤثر تغيير الزاوية في جميع الأجسام من خلال نسبة ظل التمام نفسها.

فسروا التقدير وحدوده العملية

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

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

خططوا لظل مؤقت

قدروا مدى ظل عمود أو حاجب أو منشأة رأسية عند معرفة زاوية ارتفاع الشمس.

استعدوا للتصوير الخارجي

توقعوا الامتداد التقريبي للظلال عند اختيار موضع التصوير ووقته للحصول على ضوء موجه.

علموا هندسة المثلث القائم

وضحوا كيف يربط ظل التمام زاوية الارتفاع وارتفاع الجسم بطول الظل المجاور.

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

ما الصيغة التي تستخدمها الأداة؟

تستخدم طول الظل = الارتفاع / tan(زاوية ارتفاع الشمس)، وهو ما يكافئ ضرب الارتفاع في ظل التمام.

بأي وحدة يظهر طول الظل؟

يظهر بوحدة الارتفاع نفسها. إذا كان الارتفاع بالمتر، يكون طول الظل بالمتر أيضا.

لماذا يجب أن تكون الزاوية بين 0 و90 درجة؟

تصف هذه الحدود شمسا فوق الأفق وتتجنب حالة التفرد عند الأفق والحالة الحدية عندما تكون الشمس فوق الرأس تماما.

هل تراعي الأداة الأرض المائلة؟

لا. تفترض جسما رأسيا فوق أرض أفقية، أما الميل فيحتاج إلى نموذج هندسي مختلف.

هل ارتفاع الشمس هو السمت نفسه؟

لا. الارتفاع زاوية فوق الأفق، أما السمت فهو اتجاه البوصلة حول الأفق.

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

تكلف كل عملية طلب عبر API مبلغ $0.002؛ ويمكن تنفيذ الحساب الحتمي نفسه محليا في المتصفح.

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/trig/shadow-length

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

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

curl -X POST https://api.kit.forhosting.com/trig/shadow-length \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"height":2,"sun_elevation_degrees":45}'

const res = await fetch("https://api.kit.forhosting.com/trig/shadow-length", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "height": 2,
    "sun_elevation_degrees": 45
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/trig/shadow-length",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "height": 2,
    "sun_elevation_degrees": 45
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/trig/shadow-length", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"height":2,"sun_elevation_degrees":45}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"height":2,"sun_elevation_degrees":45}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/trig/shadow-length", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "height": 2,
  "sun_elevation_degrees": 45
}

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

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "trig.shadow_length",
  "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 الكامل ←