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

المسافة القطبية المستوية

تُكتب نقاط المستوى غالباً بالصيغة القطبية كنصف قطر من الأصل مقترناً بزاوية من شعاع مرجعي ثابت.

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

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

تحتاج مسارات الروبوتات وأنماط الهوائيات ومخططات الرادار وعلم المثلثات في الصف إلى المسافة المستقيمة بين نقطتين من هذا النوع دون تحويل كل إحداثي يدوياً إلى ديكارتي. تقبل حاسبة المسافة القطبية المستوية هذه نصفَي قطر وزاويتين، وتطبّق قانون جيب التمام المستوي: d يساوي الجذر التربيعي لمربع r1 زائد مربع r2 ناقص مرتين r1 r2 مضروبة في جيب تمام الزاوية بينهما، وتعيد مسافة حتمية مع الفصل الزاوي ذي الإشارة. يمكن توريد الزوايا بالدرجات افتراضياً أو بالراديان عند ضبط حقل الوحدة. تُرفض أنصاف الأقطار السالبة لأن نصف القطر القطبي مسافة غير سالبة من الأصل. يغذي نفس الوحدة النقية الأداة المجانية في المتصفح ومسار API المدفوع مسبقاً، فلا تختلف فحوصات الواجبات والدفاتر وعمال الحافة في حالة حدّية للفاصلة العائمة.

طريقة الاستخدام

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

راجع بياناتك

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

أعد الحساب أو نفّذه آليًا

استخدم أداة الويب للفحوص الفردية، واستخدم الواجهة البرمجية عند دمج الإمكانية نفسها في سير عمل آلي.

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

احصل على النتيجة الآن

أدخل مجموعة من القيم وشاهد النتيجة من دون إعداد جدول بيانات أو برنامج نصي.

قارن السيناريوهات

غيّر قيمة واحدة في كل مرة وأعد الحساب لمعرفة ما الذي يؤثر في النتيجة.

أتمت العمل المتكرر

استخدم الواجهة البرمجية عندما تحتاج إلى تشغيل الحساب نفسه داخل منتجك أو سير عملك.

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

كيف أحسب المسافة بين نقطتين قطبيتين؟

أرسل r1 وr2 غير سالبين مع الزاويتين theta1 وtheta2. تعيد API القيمة d = sqrt(r1² + r2² − 2·r1·r2·cos(θ2−θ1)) بالدرجات افتراضياً.

هل يمكنني توريد الزوايا بالراديان؟

نعم. اضبط angle_unit على "radians" (أسماء مستعارة: rad، unit). تُفسَّر theta1 وtheta2 كلتيهما بهذه الوحدة.

لماذا تُرفض أنصاف الأقطار السالبة؟

في هذه الحاسبة نصف القطر القطبي مسافة غير سالبة من الأصل. r1 أو r2 السالب يفشل بـ invalid_input ولا يُحاسب.

هل هذه مسافة دائرة عظمى أو جغرافية؟

لا. إنها مسافة إقليدية مستوية بالصيغة القطبية عبر قانون جيب التمام. لجيوديسيات lat/lon استخدم قدرة مسافة geo مخصصة.

كم تكلفة حاسبة المسافة القطبية؟

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

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/geo/polar-distance

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

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

curl -X POST https://api.kit.forhosting.com/geo/polar-distance \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"r1":3,"theta1":0,"r2":4,"theta2":90}'

const res = await fetch("https://api.kit.forhosting.com/geo/polar-distance", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "r1": 3,
    "theta1": 0,
    "r2": 4,
    "theta2": 90
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/geo/polar-distance",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "r1": 3,
    "theta1": 0,
    "r2": 4,
    "theta2": 90
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/geo/polar-distance", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"r1":3,"theta1":0,"r2":4,"theta2":90}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"r1":3,"theta1":0,"r2":4,"theta2":90}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/geo/polar-distance", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "r1": 3,
  "theta1": 0,
  "r2": 4,
  "theta2": 90
}

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

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