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