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

حساب السمت النسبي من اتجاه السفينة

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

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

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

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

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

ما الذي يوضحه السمت النسبي

يصف السمت الحقيقي والسمت النسبي خط النظر نفسه، لكن كلًّا منهما يستخدم مرجعًا مختلفًا. يُقاس السمت الحقيقي في اتجاه عقارب الساعة من الشمال الحقيقي، بينما يُقاس السمت النسبي من مقدمة السفينة. تغيّر الحاسبة المرجع بطرح اتجاه السفينة من السمت الحقيقي للهدف. تعني نتيجة 0 درجة أن الهدف يقع أمام المقدمة مباشرة، و90 درجة أنه على عرض الميمنة، و180 درجة أنه خلف المؤخرة مباشرة، و270 درجة أنه على عرض الميسرة. تحدد القيم الواقعة بين هذه المواضع اتجاه الهدف بدقة حول السفينة. ويهم هذا الفرق لأن المراقب يبلّغ عادةً نسبةً إلى المقدمة، في حين قد تعرض الخريطة أو أجهزة الملاحة الاتجاه نسبةً إلى الشمال. يساعد الحقل target_side على مراجعة الرقم؛ فالقيم بين 0 و180 تقع على الميمنة، والقيم بين 180 و360 تقع على الميسرة.

كيفية معالجة عبور اتجاه الشمال

المعادلة الأساسية هي السمت النسبي = السمت الحقيقي − اتجاه السفينة. قد ينتج عن الطرح المباشر عدد سالب عندما تكون القيمة العددية لسمت الهدف أقل من اتجاه السفينة. لا يعني ذلك أن الاتجاه غير صالح، بل يعني أن النتيجة عبرت مرجع الصفر عند الشمال. تضيف الحاسبة 360 درجة ثم تطبق modulo 360 للحصول على المجال المعتاد من 0 شاملًا إلى 360 غير شامل. فعلى سبيل المثال، ينتج عن اتجاه سفينة قدره 350 درجة وسمت هدف قدره 45 درجة سمت نسبي قدره 55 درجة، أي إن الهدف يقع أمام السفينة جهة الميمنة. يمكن إدخال 0 أو 360 للدلالة على الشمال، وتُطبَّع القيمتان إلى 0. تقبل الأداة الدرجات العشرية، وتقرّب الناتج إلى ست منازل عشرية لضمان الثبات. ويجب أن يكون المدخلان عددين محدودين ضمن المجال المنشور 0–360 درجة.

استخدام النتيجة على نحو صحيح

تحققوا من أن الزاويتين تستخدمان الشمال الحقيقي مرجعًا لهما. فالجمع بين اتجاه مغناطيسي وسمت حقيقي يخلط نظامين مرجعيين وقد يعطي رقمًا يبدو معقولًا لكنه غير صحيح. حوّلوا القيم المغناطيسية أولًا عند الحاجة إلى تطبيق الاختلاف أو الانحراف. وتذكّروا أن اتجاه السفينة يصف الجهة التي تشير إليها المقدمة، ولا يساوي بالضرورة المسار فوق سطح الأرض عند وجود رياح أو تيار أو انحراف جانبي. تتبع النتيجة اصطلاح 0–360 في اتجاه عقارب الساعة، لا زاوية بإشارة؛ ولذلك تعني 315 درجة زاوية قدرها 45 درجة إلى الميسرة. يزيل target_side هذا الالتباس. الحساب فوري وحتمي، ويلائم التدريبات وفحص برمجيات الجسر ومعالجة السجلات والأتمتة عبر API مقابل $0.002 لكل طلب. لا تحسب الأداة المسافة أو خطر التصادم أو نقطة الاقتراب القصوى.

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

تحويل سمت مرسوم على الخريطة

حوّلوا السمت الحقيقي المأخوذ من خريطة أو مستشعر إلى الزاوية التي يبلّغ عنها المراقب في اتجاه عقارب الساعة بدءًا من المقدمة.

مراجعة تمارين الملاحة

تحققوا من حساب السمت النسبي، بما في ذلك الحالات التي يعبر فيها الطرح اتجاه الشمال وينتج مبدئيًا عددًا سالبًا.

توحيد مشاهدات جسر القيادة

حوّلوا سجلات اتجاه السفينة والسمت الحقيقي إلى قيم سمت نسبي متسقة ضمن 0–360 درجة لاستخدامها في السجلات أو التحليل.

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

ما المعادلة المستخدمة؟

تطرح الحاسبة اتجاه السفينة من السمت الحقيقي، ثم تطبّع الفرق ضمن المجال من 0 شاملًا إلى 360 درجة غير شامل.

ماذا يعني سمت نسبي قدره 270 درجة؟

يعني أن الهدف يقع على عرض الميسرة مباشرة، أي بزاوية 90 درجة إلى الميسرة انطلاقًا من المقدمة.

هل يمكن الجمع بين السمت المغناطيسي والحقيقي؟

لا. يجب أن تستخدم الزاويتان مرجع الشمال نفسه؛ وتتوقع هذه القدرة تحديدًا سمتًا حقيقيًا واتجاه سفينة حقيقيًا.

هل تحسب الأداة خطر التصادم أو المسافة؟

لا. فهي تحسب الاتجاه نسبةً إلى المقدمة فقط، ولا تستخدم المسافة أو السرعة أو تغيرات المسار أو بيانات نقطة الاقتراب القصوى.

ما كلفة طلب API؟

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

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/geo/relative-bearing

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

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

curl -X POST https://api.kit.forhosting.com/geo/relative-bearing \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"true_bearing":45,"vessel_heading":350}'

const res = await fetch("https://api.kit.forhosting.com/geo/relative-bearing", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "true_bearing": 45,
    "vessel_heading": 350
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/geo/relative-bearing",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "true_bearing": 45,
    "vessel_heading": 350
},
)
task_id = res.json()["task_id"]

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

body := bytes.NewBufferString(`{"true_bearing":45,"vessel_heading":350}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/geo/relative-bearing", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "true_bearing": 45,
  "vessel_heading": 350
}

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

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