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

حاسبة الوسيط الهندسي

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

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

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

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

اختاروا الوسيط الهندسي عندما تكون المسافة هي الهدف

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

افهموا تنقيح وايزفيلد ونتيجة التوقف

يبدأ الحساب من مركز الثقل الحسابي، ثم ينشئ مرارًا متوسطًا موزونًا لجميع النقاط، تكون أوزانه مقلوب المسافة. تحصل المشاهدات القريبة على وزن أكبر في كل خطوة، فتتحرك النتيجة التقديرية نحو موقع ذي مسافة كلية أقل. وتعالج خطوة وايزفيلد معدلة الحالة المهمة التي يقع فيها التقدير على نقطة مدخلة تمامًا؛ إذ يفحص الحل شرط المثالية الهندسي هناك بدل القسمة على صفر. يتوقف التكرار عندما لا تتجاوز الحركة بين تقديرين متتاليين قيمة السماح المطلوبة. تتضمن الاستجابة converged وiterations وtolerance مع المركز وtotal_distance. إذا كانت converged تساوي true فهذا يعني نجاح اختبار الحركة أو شرط النقطة الدقيق. أما false فتعني استنفاد الحد الأقصى للتكرارات، ويمكنكم إعادة الحساب بحد أعلى. وقد تتطلب tolerance الأصغر عملًا أكثر. لا تختاروا قيمة أدنى بكثير من الدقة المفيدة للقياسات، لأن حساب الفاصلة العائمة لا يستطيع إضافة دقة غير موجودة في البيانات الأصلية.

فسّروا المركز التقديري وتحققوا منه وطبقوه

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

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

وضع نقطة خدمة مشتركة

قدّروا موقعًا مركزيًا مستويًا يقلل مجموع المسافات المستقيمة إلى العملاء أو المنشآت.

تلخيص المشاهدات المتجمعة

استخرجوا مركزًا ممثلًا متينًا لا تشوهه مشاهدة بعيدة بقدر ما تشوه متوسط الإحداثيات.

بدء بحث خاضع للقيود

استعملوا المركز الوسيط غير المقيد مرجعًا لتقييم المواقع المؤهلة أو النقاط المرشحة القريبة.

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

ما تكلفة طلب API؟

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

هل الوسيط الهندسي هو مركز الثقل؟

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

هل يمكن إدخال خطوط العرض والطول؟

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

ماذا يحدث عند تكرار النقاط؟

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

ماذا تعني converged عندما تساوي false؟

بلغ الحساب max_iterations قبل استيفاء شرط التوقف؛ ارفعوا الحد أو خففوا tolerance إذا كان ذلك مناسبًا.

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/geo/median-center

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

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

curl -X POST https://api.kit.forhosting.com/geo/median-center \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"points":[{"x":0,"y":0},{"x":4,"y":0},{"x":2,"y":3}]}'

const res = await fetch("https://api.kit.forhosting.com/geo/median-center", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "points": [
      {
        "x": 0,
        "y": 0
      },
      {
        "x": 4,
        "y": 0
      },
      {
        "x": 2,
        "y": 3
      }
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/geo/median-center",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "points": [
        {
            "x": 0,
            "y": 0
        },
        {
            "x": 4,
            "y": 0
        },
        {
            "x": 2,
            "y": 3
        }
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/geo/median-center", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"points":[{"x":0,"y":0},{"x":4,"y":0},{"x":2,"y":3}]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"points":[{"x":0,"y":0},{"x":4,"y":0},{"x":2,"y":3}]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/geo/median-center", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "points": [
    {
      "x": 0,
      "y": 0
    },
    {
      "x": 4,
      "y": 0
    },
    {
      "x": 2,
      "y": 3
    }
  ]
}

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

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