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

تطبيع زاوية الاتجاه ضمن نطاق 0 إلى 360 درجة

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

● Betaمجاني · داخل متصفحك
استخدمها من الويبAPIالبريدTelegramالتطبيق قريبًا

تحتسب الأداة دورات كاملة مقدار كل منها 360 درجة من دون تغيير الاتجاه الذي تمثله الزاوية. يفيد ذلك عند التعامل مع بيانات الملاحة والمساحة والخرائط والروبوتات وجداول البيانات التي تستخدم اصطلاحات زاوية مختلفة. أدخلوا قيمة محدودة بالدرجات لتحصلوا على الرقم الأصلي ومكافئه المطبّع بحساب حتمي لا يستعين بأي مصدر خارجي.

فهم نطاق الاتجاه المطبّع

تصف زاوية الاتجاه موضعًا حول دائرة كاملة، ولذلك فإن الزوايا التي يفصل بينها أي مضاعف صحيح لـ360 درجة تشير إلى الاتجاه نفسه تمامًا. فمثلًا تمثل 10 درجات و370 درجة و-350 درجة الاتجاه ذاته. يختار التطبيع ممثلًا قياسيًا واحدًا من هذه المجموعة غير المحدودة. تستخدم الأداة نطاقًا نصف مفتوح يبدأ من 0 درجة مع شمولها وينتهي عند 360 درجة من دون شمولها. لذلك يعاد الشمال بوصفه 0 درجة لا 360 درجة، بينما يقابل الشرق والجنوب والغرب 90 و180 و270 درجة. يمنع هذا الاصطلاح وجود تمثيلين قياسيين عند الحد. لا تدير العملية الاتجاه ولا تقرّبه ولا تعيد تفسيره؛ بل تضيف دورات كاملة أو تطرحها حتى تقع القيمة داخل النطاق. وتظل الكسور العشرية محفوظة، ولذلك تصبح 721.25 درجة مساوية لـ1.25 درجة.

إدخال الزاوية والتحقق من النتيجة

أدخلوا زاوية اتجاه عددية محدودة واحدة مقيسة بالدرجات. يمكن أن تكون القيمة أصلًا بين 0 و360، أو سالبة، أو مشتملة على عدة دورات موجبة أو سالبة. تبقى القيم الواقعة داخل النطاق كما هي، باستثناء الصفر السالب الذي يعرض صفرًا عاديًا. عند إدخال 725.5 درجة تُطرح دورتان فتصبح النتيجة 5.5 درجات، وعند إدخال -10 درجات تؤدي إضافة دورة إلى 350 درجة. يستخدم التنفيذ باقي القسمة المكافئ مباشرة، لذلك لا يزداد زمن المعالجة مع عدد الدورات. تحققوا قبل الاعتماد على الناتج من أن المصدر يستخدم الدرجات واصطلاح الاتجاه المتوقع فعلًا. لا تحول الأداة الراديان، ولا تستطيع اكتشاف نظام يقيس عكس عقارب الساعة من الشرق. وتُرفض القيم المفقودة وغير العددية واللانهائية وNaN لتجنب إنتاج اتجاه مضلل.

استخدام الاتجاهات المطبّعة بأمان

تسهل النتيجة المطبّعة المقارنة والتخزين والترتيب والعرض والصيغ اللاحقة، لكنها لا تغير إلا التفاف القيمة العددية. فهي لا تحول الشمال المغناطيسي إلى الشمال الحقيقي، ولا تطبق الانحراف المغناطيسي أو تقارب الشبكة، ولا تحسب مسارًا أو تستنتج نظامًا مرجعيًا. احتفظوا بهذه التفاصيل منفصلة عند الحاجة. تتطلب المقارنة الدائرية حذرًا قرب الحد أيضًا؛ فالمسافة بين 359 درجة و1 درجة تساوي درجتين فقط، مع أن الطرح العادي يعطي 358. طبّعوا القيمتين أولًا ثم استخدموا صيغة للفرق الدائري. وفي التنظيف الآلي، احتفظوا بالقيمة الأصلية بجانب المطبّعة إذا كانت قابلية التتبع مهمة. يعالج كل طلب API عنصرًا واحدًا وتبلغ تكلفته $0.002. لا يستخدم الحساب شبكة أو تاريخًا أو عشوائية أو جدولًا متغيرًا، لذلك تعطي المدخلات المحدودة المتطابقة نتائج متطابقة دائمًا. طبّقوا أي تقريب للعرض بعد التطبيع وفق دقة أداة القياس أو البيانات.

تنظيف بيانات الملاحة

وحّدوا الاتجاهات السالبة ومتعددة الدورات قبل تخزين سجلات المركبات أو السفن أو الطائرات أو مقارنتها.

ضبط اتجاه الروبوت

حوّلوا زوايا الدوران المتراكمة إلى اتجاه قياسي مناسب للوحات العرض وحدود أنظمة التحكم.

تهيئة حقول الخرائط

طبّعوا أعمدة السمت المستوردة قبل استخدامها في GIS أو التحقق أو الحسابات الاتجاهية.

ما النطاق الذي تستخدمه النتيجة؟

تكون النتيجة مساوية لـ0 درجة أو أكبر منها، وأقل من 360 درجة حصرًا. وتمثل الدورة الكاملة بالقيمة 0 درجة.

كيف تعالج الاتجاهات السالبة؟

تضاف دورات كاملة مقدارها 360 درجة عند الحاجة. فمثلًا تُطبّع -10 درجات إلى 350 درجة.

ماذا يحدث للقيم التي تتجاوز 360 درجة؟

تُحذف الدورات الكاملة من دون تغيير الاتجاه. فمثلًا تصبح 725.5 درجة مساوية لـ5.5 درجات.

هل تحوّل الأداة الراديان إلى درجات؟

لا. تفسر المدخلات بوصفها درجات؛ لذا حوّلوا الراديان بصورة منفصلة قبل استخدام هذه القدرة.

هل يصحح التطبيع الانحراف المغناطيسي؟

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

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

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

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

curl -X POST https://api.kit.forhosting.com/geo/normalize-bearing \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"bearing":725.5}'
{
  "bearing": 725.5
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "geo.normalize_bearing",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

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

لكل طلب$0.002

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

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

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