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

صندوق إحاطة المضلع

صندوق إحاطة المضلع هو أصغر مستطيل موازٍ لمحوري خط العرض وخط الطول ويحتوي جميع الرؤوس المقدمة.

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

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

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

جهزوا رؤوس المضلع

قدموا ثلاثة رؤوس على الأقل، على أن يمثل كل رأس بقيمتين عدديتين هما lat وlon بالدرجات العشرية. يجب أن يقع خط العرض بين -90 و90، وخط الطول بين -180 و180. يمكن للنقاط أن تصف مضلعًا محدبًا أو مقعرًا، كما يمكن تكرار النقطة الأولى في النهاية لإغلاق الحلقة. بخلاف حساب المساحة أو المركز الهندسي، لا يعتمد صندوق الإحاطة على اتجاه ترتيب الرؤوس مع عقارب الساعة أو عكسها، إذ تسهم كل نقطة على حدة في تحديد القيم القصوى. ومع ذلك، يلزم تقديم ثلاث نقاط لأن المدخل يمثل مضلعًا لا مجموعة نقاط عشوائية. استخدموا أرقامًا بدل النصوص المنسقة التي تتضمن رمز الدرجة أو لاحقة الاتجاه أو إحداثيات مفصولة بفواصل. ترفض الأداة بوضوح السجلات غير الصحيحة والإحداثيات الناقصة والقيم غير المنتهية والإحداثيات الخارجة عن النطاق. يقبل كل طلب حتى 10,000 رأس، مما يحافظ على تنفيذ متوقع حتى عند معالجة حدود جغرافية مفصلة.

افهموا الركنين المعادين

تتضمن النتيجة min_corner وmax_corner. يجمع الركن الأدنى أصغر خط عرض في القائمة مع أصغر خط طول، بينما يجمع الركن الأقصى أكبر خط عرض مع أكبر خط طول. يصف الركنان مستطيلًا موازيًا للمحاور في مستوى خطوط العرض والطول. وليس من الضروري أن يكونا رأسين فعليين في المضلع، لأن أصغر خط عرض وأصغر خط طول قد يظهران في نقطتين مختلفتين. لا تطبق الأداة هامشًا أو إسقاطًا أو تقريبًا أو توسيعًا جيوديسيًا، ولذلك تحافظ الاستجابة على القيم القصوى الرقمية المقدمة. يعامل خط الطول حرفيًا ضمن النطاق التقليدي من -180 إلى 180. لذلك قد ينتج عن مضلع يعبر خط التاريخ الدولي صندوق واسع رقميًا، مثل امتداد من -179 إلى 179 درجة. هذا السلوك مقصود، فهو يبلغ عن الحدين العدديين المعتادين بدل اختيار نافذة خريطة ملتفة تلقائيًا. ويمكن للتطبيقات التي تدعم خطوط الطول الدورية مقارنة امتدادات بديلة بعد استلام هذه الحدود المباشرة.

استخدموا الحدود في الخرائط ومسارات البيانات

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

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

ضبط نطاق عرض الخريطة

حولوا رؤوس المضلع إلى ركنين أدنى وأقصى كي يعرض تطبيق الخرائط الحد كاملًا.

ترشيح السجلات المكانية مبدئيًا

خزنوا القيم القصوى البسيطة لاختيار المرشحين قبل اختبارات تقاطع المضلعات الدقيقة.

التحقق من التغطية الجغرافية

قارنوا امتداد الحد المقدم بنطاقات خطوط العرض والطول المسموح بها أثناء الاستيراد.

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

ما تكلفة الحساب؟

سعر API هو $0.002 لكل عنصر، وحاسبة المتصفح مجانية في هذه الصفحة.

هل يؤثر ترتيب الرؤوس؟

لا، إذ يبحث الحساب بصورة مستقلة عن أصغر وأكبر قيم لخطوط العرض والطول.

هل يجب تكرار الرأس الأول في النهاية؟

لا، فالقوائم المفتوحة والمغلقة تعيد الحدود نفسها عندما تكون قيمها القصوى متطابقة.

كيف تعالج المضلعات التي تعبر خط التاريخ الدولي؟

تستخدم الأداة القيم الحرفية من -180 إلى 180، ولذلك قد يكون الصندوق واسعًا بدل أن يكون ملتفًا.

هل هذا اختبار دقيق لاحتواء المضلع؟

لا، فالمستطيل يحتوي جميع الرؤوس، لكن قد تقع نقطة داخله خارج المضلع نفسه.

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/geo/polygon-bounding-box

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

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

curl -X POST https://api.kit.forhosting.com/geo/polygon-bounding-box \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"vertices":[{"lat":40.7128,"lon":-74.006},{"lat":34.0522,"lon":-118.2437},{"lat":41.8781,"lon":-87.6298}]}'

const res = await fetch("https://api.kit.forhosting.com/geo/polygon-bounding-box", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "vertices": [
      {
        "lat": 40.7128,
        "lon": -74.006
      },
      {
        "lat": 34.0522,
        "lon": -118.2437
      },
      {
        "lat": 41.8781,
        "lon": -87.6298
      }
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/geo/polygon-bounding-box",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "vertices": [
        {
            "lat": 40.7128,
            "lon": -74.006
        },
        {
            "lat": 34.0522,
            "lon": -118.2437
        },
        {
            "lat": 41.8781,
            "lon": -87.6298
        }
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/geo/polygon-bounding-box", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"vertices":[{"lat":40.7128,"lon":-74.006},{"lat":34.0522,"lon":-118.2437},{"lat":41.8781,"lon":-87.6298}]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"vertices":[{"lat":40.7128,"lon":-74.006},{"lat":34.0522,"lon":-118.2437},{"lat":41.8781,"lon":-87.6298}]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/geo/polygon-bounding-box", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "vertices": [
    {
      "lat": 40.7128,
      "lon": -74.006
    },
    {
      "lat": 34.0522,
      "lon": -118.2437
    },
    {
      "lat": 41.8781,
      "lon": -87.6298
    }
  ]
}

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

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

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

الأسعار

لكل طلب$0.002

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

الحدود

max_items 10000

الأخطاء

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

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