ForHosting KIT · السفر والجغرافيا

خط الرؤية فوق التضاريس

تحقّق مما إذا كان خط الرؤية المستقيم يتجاوز التضاريس بين الراصد والهدف: مع الملف 100 و105 و120 و110 و95 م وعين على ارتفاع 1.7 م يُحجب الشعاع ويمر أسفل القمة البالغ ارتفاعها 120 م بمقدار 21.65 م. مجاني في متصفحك.

مجاني
يعمل في متصفحك
دون تسجيل
بياناتك لا تغادر جهازك

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

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

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

كيف يعمل نموذج خط الرؤية فوق التضاريس

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

عند فهرس العيّنة i من أصل n عيّنات، المسافة الكسرية على طول المسار t تساوي i مقسومًا على n ناقص واحد. الارتفاع الهندسي لخط الرؤية عند ذلك الكسر هو eye0 زائد t مضروبًا في (eye1 ناقص eye0)، حيث eye0 وeye1 هما الطرفان المرتفعان. الخلوص عند العيّنة i هو ذلك الارتفاع الهندسي ناقص ارتفاع التضاريس عند i.

إذا كان كل خلوص أكبر من أو يساوي صفرًا فالمسار حرّ — بما في ذلك تماس الرعي الذي يلمس خطًا جبليًا فقط. وإذا كان أي خلوص سالبًا تمامًا، يحجب الشعاعَ أرضٌ صلبة عند تلك العيّنة. يعيد هذا الطرف الخلوص الأدنى العام وفهرسه حتى تروا مدى قرب شبه الإخفاق، وعلى مسار محجوب يعيد أيضًا أول فهرس حاجب مع ارتفاعي التضاريس وخط الرؤية هناك.

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

من يستفيد من فحص خط الرؤية

غالبًا ما تحوي دفاتر المساحة وGIS بالفعل قائمة عيّنات DEM على طول قفزة ميكروويف مخطّطة أو سمت كاميرا مسار أو نقطة تطلّ مشي؛ تجيب هذه الحاسبة السؤال الثنائي حرّ أو محجوب دون نصب مكدّس viewshed كامل. يستطيع مخطّطو الراديو دفع آلاف المسارات المرشّحة دفعةً في عمّال الحافة لأن الخوارزمية حساب صرف بلا شبكة صادرة. أدوات الألعاب والمحاكاة التي تخزّن خرائط الارتفاع يمكنها تصدير شريحة 1-D وإعادة استخدام العقد نفسه لفحوص رؤية الذكاء الاصطناعي.

مواقع المحتوى التي تترتّب على حاسبة خط الرؤية فوق التضاريس تستفيد من ودجة متصفح مجانية حيّة تطابق مسار الأتمتة المدفوع بايتًا ببايت على وحدة lib المشتركة. التحقق الفاشل لا يستهلك الرصيد. أبقوا الملفات دون خمسة آلاف عيّنة وثبّتوا الخلوصات المقرّبة في الاختبارات لتحصلوا على قرارات LOS قابلة لإعادة الإنتاج لأطقم الميدان وعروض LMS وأنابيب الإنتاج دون خادم GIS خاص بكم.

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

فحوص مسارات الراديو والميكروويف

قدّموا عيّنات DEM على طول قفزة مع ارتفاعات الهوائي لمعرفة إن كان الشعاع الهندسي يتجاوز التضاريس الوسيطة قبل ميزانية وصلة كاملة.

تموضع المرمى والمسار والكاميرا

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

شرائح الرؤية في المحاكاة والألعاب

صدّروا شريحة 1-D من خريطة الارتفاع بين كيانين وأعيدوا استخدام عقد الحرّ/المحجوب لاختبارات خط رؤية حتمية للذكاء الاصطناعي.

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

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

الأمتار لكل حقل ارتفاع وعلو. حافظوا على الملف والارتفاعات في نظام وحدات واحد؛ الرياضيات متسقة ما لم تخلطوا الأقدام بالأمتار.

هل تراعي الأداة انحناء الأرض أو الانكسار؟

لا. النموذج هندسة أرض مسطّحة على الملف الذي تقدّمونه.

ماذا لو كان ملفي بنقطتين فقط؟

ذلك صالح: يُفحص الخلوص عند الطرفين فقط (عين المراقب وطرف الهدف فوق أرضيهما). مع ارتفاعات غير سالبة يكون المسار دائمًا حرًّا لعيّنتين؛ والتضاريس الوسيطة تحتاج عيّنات وسطى.

ماذا يعني أدنى خلوص؟

هو أصغر فجوة بين خط الرؤية والأرض على طول الملف، مع موضع العينة التي يحدث عندها. والقيمة السالبة تعني أن الأرض ترتفع فوق الشعاع: ففي المثال تبلغ −21.65 م عند القمة البالغة 120 م، فترى مقدار النقص.

هل يُعد الشعاع الذي يلامس القمة ملامسة خفيفة خطًا حرًا؟

نعم. يكون المسار حرًا ما دام الشعاع عند مستوى كل عينة أو فوقها، لذا تُحتسب الملامسة الدقيقة للقمة رؤية حرة. ولا يُحجب الشعاع إلا إذا ارتفعت الأرض فوقه ارتفاعًا فعليًا عند نقطة ما.

أدوات ذات صلة

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/geo/line-of-sight

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

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

curl -X POST https://api.kit.forhosting.com/geo/line-of-sight \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"profile":[100,105,120,110,95],"observer_height":1.7,"target_height":0}'

const res = await fetch("https://api.kit.forhosting.com/geo/line-of-sight", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "profile": [
      100,
      105,
      120,
      110,
      95
    ],
    "observer_height": 1.7,
    "target_height": 0
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/geo/line-of-sight",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "profile": [
        100,
        105,
        120,
        110,
        95
    ],
    "observer_height": 1.7,
    "target_height": 0
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/geo/line-of-sight", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"profile":[100,105,120,110,95],"observer_height":1.7,"target_height":0}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"profile":[100,105,120,110,95],"observer_height":1.7,"target_height":0}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/geo/line-of-sight", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "profile": [
    100,
    105,
    120,
    110,
    95
  ],
  "observer_height": 1.7,
  "target_height": 0
}

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

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "geo.line_of_sight",
  "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`	تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.

ملاحظات تقنية

الوحدة النقية نفسها تشغّل ودجة المتصفح المجانية وواجهة API، فلا تختلف أدوات الميدان والأتمتة على خلوص بمقدار مليمتر من ضوضاء الفاصلة العائمة.

كيف يعمل نموذج خط الرؤية فوق التضاريس

تقع عين المراقب (أو نقطة تغذية الهوائي) على مسافة observer_height أمتار فوق أول عيّنة، وطرف الهدف على target_height أمتار فوق الأخيرة. يوسّع distance_m الاختياري التقرير ليظهر تباعد العيّنات بالأمتار؛ ولا يغيّر قرار الحرّ أو المحجوب لأن التباعد المتساوي مفترض أصلًا في كسور الفهرس.

عقد الإدخال وحقول الاستجابة والتحقق

مثال: ملف مئة ومئة وخمسة ومئة وعشرين ومئة وعشرة وخمسة وتسعين مع ارتفاع مراقب واحد فاصلة سبعة أمتار وارتفاع هدف صفر ومسافة ألف متر يبلّغ محجوبًا إن ثقب التلّ عند مئة وعشرين مترًا الشعاع، أو حرًّا إن رفعت الارتفاعات الشعاع فوق كل قمة. أرسلوا جسم JSON يحوي profile، مصفوفة من عددين منتهيين على الأقل لارتفاعات التضاريس بالأمتار من أرض المراقب إلى أرض الهدف؛ وobserver_height، عددًا منتهيًا غير سالب من أمتار العين أو الهوائي فوق أول عيّنة؛ وtarget_height، عددًا منتهيًا غير سالب من أمتار ارتفاع الجسم فوق آخر عيّنة. distance_m الاختياري هو طول المسار الأفقي الكلي بالأمتار عندما تريدون sample_spacing_m في الاستجابة. الأسماء المستعارة المقبولة تشمل terrain وelevations وsamples للملف؛ وobserver_h وh_obs وeye_height للمراقب؛ وtarget_h وh_tgt وobject_height للهدف؛ وdistance وrange_m أو path_length_m لطول المسار. الحقول الإلزامية الناقصة والقيم غير المنتهية والارتفاعات السالبة وملف أقصر من عيّنتين أو أكثر من خمسة آلاف عيّنة تفشل بـ invalid_input مع تسمية المشكلة؛ ولا تُفوتر تلك الإخفاقات. عند النجاح يتضمّن الجسم دائمًا clear (منطقي) وsample_count وobserver_eye_elev وtarget_eye_elev (الارتفاعات المطلقة لطرفي الشعاع) وmin_clearance_m وmin_clearance_index (أضيق عيّنة وقد تبقى موجبة على مسار حرّ) وسلسلة صيغة قصيرة تعيد صياغة الاختبار. عند توريد distance_m يُعاد distance_m وsample_spacing_m ويُشتقّان. عندما يكون clear بقيمة false، يحدّد blocked_at_index وterrain_elev_at_block وlos_elev_at_block أول عيّنة صار فيها الخلوص سالبًا.

أين تثبت واجهة API لخط الرؤية فوق التضاريس قيمتها

يمكن للمربّين في الهواء الطلق ومسؤولي المرامي لصق سلسلة ارتفاعات قصيرة من تطبيق هاتف ورؤية إن كان تلّ يحجب الخط إلى علم أو هدف، مع ضبط observer_height للثنائي مقابل الوقوف وtarget_height لصفحة فولاذ مقابل وتد أرضي. ولأن التنفيذ parse نقي من المستوى A، كل استدعاء ناجح يكلّف السعر الأساسي المنشور $0.002 بلا رموز نموذج وبلا خدمة ارتفاع طرف ثالث — أنتم تقدّمون الملف.

أسئلة تقنية

كيف تقرّر حاسبة خط الرؤية الحرّ مقابل المحجوب؟

تبني شعاعًا مستقيمًا من profile[0]+observer_height إلى profile[n−1]+target_height وتفحص الخلوص عند كل عيّنة متساوية التباعد. إن كان لأي عيّنة los_z − terrain < 0 فالمسار محجوب؛ وإلا فهو حرّ (الرعي يُعدّ حرًّا).

ما تكلفة أداة خط الرؤية فوق التضاريس؟

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

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

شغّل الأداة مجانًا

كيف يعمل نموذج خط الرؤية فوق التضاريس

من يستفيد من فحص خط الرؤية

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

فحوص مسارات الراديو والميكروويف

تموضع المرمى والمسار والكاميرا

شرائح الرؤية في المحاكاة والألعاب

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

أدوات ذات صلة

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

الـEndpoint

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

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

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

الأسعار

الأخطاء

ملاحظات تقنية

كيف يعمل نموذج خط الرؤية فوق التضاريس

عقد الإدخال وحقول الاستجابة والتحقق

أين تثبت واجهة API لخط الرؤية فوق التضاريس قيمتها

أسئلة تقنية

شكرًا