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

محدد الربع

تأخذ واجهة API لتحديد الربع الإحداثيين x وy لنقطة في المستوى الديكارتي وتخبرك بدقة بمكانها: في الربع الأول أو الثاني أو الثالث أو الرابع، أو على المحور x، أو على المحور y، أو في نقطة الأصل.

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

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

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

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

ماذا يعني ربع النقطة

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

كيف يُتَّخذ قرار التصنيف

القاعدة اختبار إشارات صارم يُطبَّق بترتيب ثابت بحيث تكون النتيجة لا لبس فيها دائمًا. أولًا يتحقق المسار مما إذا كانت كلتا الإحداثيتين صفرًا، وعندها تكون النقطة هي الأصل. ثم يتحقق مما إذا كانت y تساوي صفرًا، وهو ما يضع النقطة على المحور x، ومما إذا كانت x تساوي صفرًا، وهو ما يضعها على المحور y. وفقط عندما تكون كلتا الإحداثيتين غير صفرية، تحدد إشارة كل منهما الربع: موجب-موجب هو الأول، وسالب-موجب هو الثاني، وسالب-سالب هو الثالث، وموجب-سالب هو الرابع. هذا الترتيب مهم لأن نقطة مثل (0, 5) تقع على المحور y وليست في الربع الأول أو الثاني، ولأن (0, 0) هي الأصل وليست محورًا اعتباطيًا. والتحقق من الإدخال صارم بالقدر نفسه: يجب أن تكون كل إحداثية عددًا منتهيًا، لذا تُرفَض NaN وInfinity والحقول الناقصة والقيم غير الرقمية بخطأ إدخال غير صالح بدلًا من إنتاج تصنيف خاطئ بصمت.

أين يندرج في العمل الحقيقي

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

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

تصحيح تمارين هندسة الإحداثيات

تحقق مما إذا كان الطالب قد وضع النقطة في الربع الصحيح دون كتابة منطق اختبار الإشارات الخاص بك.

تجميع نقاط مخطط التشتت لتلوينها

صنّف كل نقطة حسب الربع أو المحور قبل العرض حتى تحصل كل منطقة على لونها الخاص.

التحقق من إحداثيات عالم اللعبة على الخادم

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

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

كم التكلفة؟

$0.002 لكل طلب. كما يمكن تشغيله مجانًا في متصفحك على هذه الصفحة.

أي ترقيم للأرباع تستخدم؟

الاصطلاح القياسي: الربع الأول له x موجب وy موجب، ويستمر الترقيم عكس عقارب الساعة حتى الرابع.

ماذا يحدث عندما تكون إحداثية صفرًا؟

تُبلَّغ النقطة على أنها على المحور x (y = 0) أو على المحور y (x = 0) أو في الأصل (كلتاهما صفر) — وليست أبدًا ربعًا.

ما الإدخال الذي يُرفَض؟

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

هل يُخزَّن أي شيء؟

لا. تُصنَّف الإحداثيات ثم تُهمَل؛ ولا يُعاد سوى الموقع.

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/math/coordinate-grid

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

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

curl -X POST https://api.kit.forhosting.com/math/coordinate-grid \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"x":-3.5,"y":2}'

const res = await fetch("https://api.kit.forhosting.com/math/coordinate-grid", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "x": -3.5,
    "y": 2
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/math/coordinate-grid",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "x": -3.5,
    "y": 2
},
)
task_id = res.json()["task_id"]

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

body := bytes.NewBufferString(`{"x":-3.5,"y":2}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/math/coordinate-grid", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "x": -3.5,
  "y": 2
}

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

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