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

مقياس ألوان حسب الفئات

تُسند أداة مقياس الألوان حسب الفئات قيمة رقمية إلى واحد من عدة مجالات متساوية العرض، ثم تعيد اللون الموافق بين حدّين لونيين بصيغة سداسية.

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

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

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

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

حوّلوا المجال المتصل إلى فئات موثوقة

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

أنشئوا المقياس باستيفاء RGB حتمي

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

تحققوا من المجالات قبل عرض البيانات

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

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

تلوين لوحة لمؤشرات الأداء

عيّنوا ألواناً متسقة لقيم زمن الاستجابة أو الإيرادات أو الاستخدام أو الجودة عبر البطاقات والرسوم.

إنشاء تصنيف لخريطة موضوعية

وزّعوا القياسات الإقليمية على مجالات ثابتة، وحافظوا على تطابق ألوان الخريطة مع وسيلة الإيضاح.

توحيد شرائح المخاطر

طبّقوا مجالاً وعدد فئات ولوحة ألوان مشتركة على الدرجات القابلة للتكرار في التقارير والتصدير.

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

هل تحسب الأداة الكميات الإحصائية من مجموعة بيانات؟

لا. تنشئ فئات متساوية العرض بين الحدين الأدنى والأقصى الصريحين، ولا تستقبل مجموعة بيانات أو تحللها.

ماذا يحدث عندما تساوي القيمة الحد الأقصى؟

تكون القيمة القصوى صحيحة وتُسند إلى الفئة الأخيرة التي تشمل حدها الأعلى.

ما صيغ الألوان المقبولة؟

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

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

تُستوفى قنوات الأحمر والأخضر والأزرق بصورة مستقلة حسب موضع الفئة، ثم تُقرّب إلى أعداد صحيحة.

هل يمكن تقييد القيم الخارجة عن المجال؟

لا. تُرفض كيلا يظهر قياس غير صحيح بصمت على أنه لون طرفي صالح.

ما تكلفة الاستخدام؟

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

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/color/scale-buckets

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

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

curl -X POST https://api.kit.forhosting.com/color/scale-buckets \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"value":72,"min":0,"max":100,"buckets":5,"start_color":"#ffffcc","end_color":"#800026"}'

const res = await fetch("https://api.kit.forhosting.com/color/scale-buckets", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "value": 72,
    "min": 0,
    "max": 100,
    "buckets": 5,
    "start_color": "#ffffcc",
    "end_color": "#800026"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/color/scale-buckets",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "value": 72,
    "min": 0,
    "max": 100,
    "buckets": 5,
    "start_color": "#ffffcc",
    "end_color": "#800026"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/color/scale-buckets", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"value":72,"min":0,"max":100,"buckets":5,"start_color":"#ffffcc","end_color":"#800026"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"value":72,"min":0,"max":100,"buckets":5,"start_color":"#ffffcc","end_color":"#800026"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/color/scale-buckets", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "value": 72,
  "min": 0,
  "max": 100,
  "buckets": 5,
  "start_color": "#ffffcc",
  "end_color": "#800026"
}

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

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