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

حاسبة متوسط الخطأ المطلق بالنسبة المئوية (MAPE)

تقارن هذه الحاسبة مصفوفة مرتبة من القيم المرصودة بمصفوفة توقعات مساوية لها في الطول، ثم تعيد متوسط الفروق المطلقة بالنسبة المئوية.

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

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

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

يحول MAPE الأخطاء إلى نسبة يسهل شرحها عند مقارنة توقعات ذات مقاييس مختلفة. أدخل القيم المتناظرة بالترتيب نفسه لتحصل على النسبة المئوية وعدد الأزواج التي جرى تقييمها. ترفض الحاسبة أي قيمة مرصودة تساوي صفرا، لأن الخطأ النسبي لا يكون معرفا عندما يكون المقام صفرا، وبذلك تمنع إدراج نتيجة مضللة في التقارير أو التقييمات الآلية.

جهز القيم المرصودة والمتوقعة بترتيب متطابق

جهز مصفوفتين تصفان الأحداث نفسها وبالترتيب نفسه. يجب أن تقابل القيمة المرصودة الأولى التوقع الأول، وأن تقابل الثانية التوقع الثاني، وهكذا. يلزم أن تتساوى المصفوفتان في الطول، وأن تحتوي كل منهما على عدد محدود واحد على الأقل، وألا تتجاوز الحد المنشور. لا يجوز أن تكون أي قيمة مرصودة صفرا لأنها تستخدم مقاما. ويمكن أن تكون التوقعات صفرا أو سالبة إذا كان ذلك منطقيا في مجال البيانات. لا تستخدم null أو السلاسل الفارغة أو الأعداد المكتوبة كنص أو Infinity أو NaN؛ فالمقبول هو أعداد JSON المحدودة فقط. تحقق كذلك من تطابق الوحدات، فلا تقارن إيرادا مرصودا بوحدة أساسية بتوقع معبر عنه بالآلاف. أرسل المصفوفتين في observed وpredicted. تعرض الاستجابة mape كنسبة مئوية وcount لعدد الأزواج المقيمة.

افهم طريقة حساب النسبة

تطرح الحاسبة التوقع من القيمة المرصودة لكل زوج، وتأخذ القيمة المطلقة للفرق، ثم تقسمها على القيمة المرصودة وفقا للصيغة القياسية. وبعد ذلك تحسب متوسط النسب وتضرب الناتج في 100. لذلك تعني قيمة mape البالغة 8.5 أن التوقعات تختلف عن المشاهدات بمقدار 8.5 في المئة في المتوسط، من دون بيان اتجاه كل خطأ. تمنع القيمة المطلقة الأخطاء الموجبة والسالبة من إلغاء بعضها. ويحصل كل زوج على الوزن نفسه مهما كان حجمه، ولذلك قد تنتج قيمة مرصودة صغيرة خطأ نسبيا ضخما. تستخدم العملية حسابا حتميا بالفاصلة العائمة ولا تقرب الناتج، لكي تختار الدقة المناسبة للعرض أو التقرير. ويساعد الحقل count على تأكيد عدد الأزواج التي دخلت الحساب وكشف أي ترشيح غير مقصود في مرحلة سابقة.

فسر MAPE بحذر

يكون MAPE أنسب عندما تكون القيم المرصودة غير صفرية، وتشترك في مقياس نسبي ذي معنى، وتجيب الفروق المئوية عن سؤال التحليل. ويشيع استخدامه في توقع الطلب وحركة الزيارات والمبيعات والمخزون. قارن فقط مجموعات أعدت بطريقة متسقة، لأن تغيير الفترة أو مزيج المنتجات قد يغير المؤشر كثيرا. توخ الحذر مع القيم القريبة من الصفر؛ فقد يهيمن فرق مطلق صغير على المتوسط. تقبل القيم السالبة رياضيا، لكن تفسيرها النسبي قد يكون غير بديهي. ولا يكشف MAPE الانحياز أو الأنماط الزمنية أو توزيع الأخطاء. استخدم معه مقياسا ذا إشارة إذا كان الإفراط في التوقع مهما، أو فكر في MAE أو RMSE أو WAPE أو مقياس متخصص عندما تكثر الأصفار. تبلغ كلفة API مقدار $0.002 لكل طلب، وتُرفض المدخلات غير الصالحة بوضوح من دون إسقاط بيانات بصمت.

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

تقييم توقعات الطلب

قارن الطلب الأسبوعي المتوقع بالمبيعات المرصودة غير الصفرية واعرض متوسط الخطأ كنسبة مئوية.

مراقبة إصدارات النماذج

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

فحص تقديرات التخطيط

قس مدى اقتراب تقديرات الميزانية أو الزيارات أو السعة من القيم النهائية المرصودة.

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

ماذا تعني قيمة MAPE المعادة؟

إنها متوسط الخطأ المطلق معبرا عنه بالنسبة المئوية. فالقيمة 7 تعني أن متوسط الخطأ المطلق يساوي 7 في المئة.

لماذا ترفض القيم المرصودة الصفرية؟

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

هل يجب أن تتساوى المصفوفتان في الطول؟

نعم. تحتاج كل قيمة مرصودة إلى توقع واحد مناظر تماما، ويعد اختلاف الطول إدخالا غير صالح.

هل تقرب الحاسبة النتيجة؟

لا. تعيد نتيجة حتمية بالفاصلة العائمة لكي تختار أنت دقة العرض الملائمة لتطبيقك.

هل يمكن أن تكون القيم المرصودة سالبة؟

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

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/stat/mape-error

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

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

curl -X POST https://api.kit.forhosting.com/stat/mape-error \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"observed":[100,200,50,400],"predicted":[110,190,55,360]}'

const res = await fetch("https://api.kit.forhosting.com/stat/mape-error", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "observed": [
      100,
      200,
      50,
      400
    ],
    "predicted": [
      110,
      190,
      55,
      360
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/stat/mape-error",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "observed": [
        100,
        200,
        50,
        400
    ],
    "predicted": [
        110,
        190,
        55,
        360
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/stat/mape-error", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"observed":[100,200,50,400],"predicted":[110,190,55,360]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"observed":[100,200,50,400],"predicted":[110,190,55,360]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/stat/mape-error", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "observed": [
    100,
    200,
    50,
    400
  ],
  "predicted": [
    110,
    190,
    55,
    360
  ]
}

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

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "stat.mape_error",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

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

الأسعار

لكل طلب$0.002

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

الحدود

max_items 100000

الأخطاء

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

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