المساحة من الإحداثيات
يحتاج المساحون ومهندسو المدنية ومشغّلو CAD والطلبة كثيرًا إلى مساحة قطعة أو شكل عندما تكون البيانات الوحيدة قائمة مرتَّبة من إحداثيات رؤوس مستوية.
شغّل الأداة مجانًا
تعمل هذه الأداة داخل متصفحك — مجانًا، ولا تُرسل بياناتك إلى أي خادم
تطبق هذه الحاسبة بصيغة الشريط الكلاسيكية (صيغة المساح): نصف القيمة المطلقة للمجموع الدوري لكل x مضروبًا في y التالي ناقص كل x تالٍ مضروبًا في y الحالي. الصقوا ثلاث نقاط [x, y] أو أكثر بترتيب الحدود، واتركوا الرأس الأول بلا تكرار أو كرّروه في النهاية إن فضّلتم حلقات بأسلوب GIS، واحصلوا على المساحة غير السالبة، والمساحة ذات الإشارة التي تكشف الاتجاه، وعدد الرؤوس بعد التطبيع، وقائمة الإحداثيات المنظَّفة. يغذي الوحدة النقية نفسها الأداة المجانية في المتصفح ومسار API المدفوع، فلا تختلف واجبات المدرسة وأنابيب الإنتاج على مستطيل أو مثلث أو قطعة غير منتظمة. الحلقات المنحطة بأقل من ثلاثة رؤوس بعد حذف مكرر الإغلاق تفشل بخطأ invalid_input بدل اختراع نجاح بمساحة صفر. بلا استدعاءات شبكة ولا عيّنة عشوائية ولا رموز نموذج — حساب حتمي فقط على الأرقام التي تقدّمونها.
طريقة الاستخدام
أدخل القيم في النموذج أعلاه. تتحقق الأداة منها قبل الحساب ثم تعرض النتيجة في الصفحة نفسها.
راجع بياناتك
اتبع التسميات والوحدات الموضحة بجانب كل حقل. إذا كانت قيمة مفقودة أو خارج النطاق، توضح الصفحة الحقل الذي يحتاج إلى تصحيح.
أعد الحساب أو نفّذه آليًا
استخدم أداة الويب للفحوص الفردية، واستخدم الواجهة البرمجية عند دمج الإمكانية نفسها في سير عمل آلي.
حالات الاستخدام
احصل على النتيجة الآن
أدخل مجموعة من القيم وشاهد النتيجة من دون إعداد جدول بيانات أو برنامج نصي.
قارن السيناريوهات
غيّر قيمة واحدة في كل مرة وأعد الحساب لمعرفة ما الذي يؤثر في النتيجة.
أتمت العمل المتكرر
استخدم الواجهة البرمجية عندما تحتاج إلى تشغيل الحساب نفسه داخل منتجك أو سير عملك.
الأسئلة الشائعة
كيف أحسب مساحة مضلّع من الإحداثيات؟
أرسلوا قائمة مرتَّبة من ثلاثة رؤوس [x, y] على الأقل في الحقل coordinates. تطبق API صيغة الشريط وتعيد المساحة غير السالبة مع المساحة ذات الإشارة والاتجاه.
هل يجب تكرار النقطة الأولى في النهاية؟
لا. مكرر نهائي للرأس الأول اختياري ويُحذف تلقائيًا قبل عدّ الرؤوس.
ماذا لو أرسلت نقطتين فقط؟
تفشل المهمة بخطأ invalid_input. تحتاج مساحة المضلّع إلى ثلاثة رؤوس على الأقل بعد تطبيع الحلقة؛ والتحقق الفاشل لا يُفوتر.
هل يهم ترتيب الرؤوس؟
نعم بالنسبة إلى signed_area و orientation (counterclockwise مقابل clockwise)، لكن المساحة المطلقة لها المقدار نفسه في الاتجاهين لحلقة بسيطة.
كم تكلفة حاسبة المساحة من الإحداثيات؟
أداة المتصفح مجانية. طلبات API تستخدم رصيد KIT المدفوع مسبقًا بسعر $0.002 لكل استدعاء ناجح؛ والإدخال غير الصالح لا يُفوتر.
للمطوّرين — الوصول عبر API
كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.
الـEndpoint
صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.
استدعِ الخدمة من بيئتك
curl -X POST https://api.kit.forhosting.com/eng/area-coordinates \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"coordinates":[[0,0],[4,0],[4,3],[0,3]]}'const res = await fetch("https://api.kit.forhosting.com/eng/area-coordinates", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"coordinates": [
[
0,
0
],
[
4,
0
],
[
4,
3
],
[
0,
3
]
]
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/eng/area-coordinates",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"coordinates": [
[
0,
0
],
[
4,
0
],
[
4,
3
],
[
0,
3
]
]
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/eng/area-coordinates", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"coordinates":[[0,0],[4,0],[4,3],[0,3]]}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"coordinates":[[0,0],[4,0],[4,3],[0,3]]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/eng/area-coordinates", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)مثال على الطلب
{
"coordinates": [
[
0,
0
],
[
4,
0
],
[
4,
3
],
[
0,
3
]
]
}مثال على الاستجابة
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "eng.area_coordinates",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.
الأسعار
السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.
الأخطاء
| HTTP | الرمز | المعنى |
|---|---|---|
401 | unauthorized | مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك. |
402 | insufficient_balance | رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة. |
404 | unknown_type | نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب. |
429 | rate_limited | تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة. |