المسافة الإجمالية للمسار
احصل على الطول الإجمالي لمسار يمر بعدة نقاط GPS، مقطعًا بعد مقطع: مجموع نقاط المرور الثلاث في المثال 327.98509 كم، أي 203.800486 ميل، في خط مستقيم فوق سطح الأرض. ويظهر كل مقطع بالكيلومترات أيضًا. مجاني في متصفحك.
- مجاني
- يعمل في متصفحك
- دون تسجيل
- بياناتك لا تغادر جهازك
شغّل الأداة مجانًا
عندما يُعرَّف المسار كقائمة مرتبة من إحداثيات GPS — جولة تسليم، تصدير مسار مشي، خطة طيران، أو مسودة رحلة متعددة المدن — فإن الرقم الأول الذي تحتاجه فرق المنتجات عادةً هو الطول الإجمالي لذلك الخط المتعدد النقاط على خط مستقيم (على خط النظر). أدوات المسافة الزوجية تغطي نقطتين فقط في كل مرة؛ وأدوات محيط الحلقة المغلقة تُجبركم على العودة إلى البداية. تقبل حاسبة المسافة الإجمالية للمسار نقطتي مرور أو أكثر، وتقيس قوس الدائرة العظمى لكل مقطع متتالٍ بصيغة haversine على أرض كروية ثابتة، وتعيد الطول المجموع بالكيلومترات والأميال النظامية والأمتار، إضافة إلى كل مقطع بالكيلومترات.
كيف تُحسب مسافة مسار متعدد النقاط على الدائرة العظمى
المسار متعدد نقاط المرور هو خط متعدد النقاط مفتوح ومرتب على الأرض: من النقطة الأولى إلى الثانية، ومن الثانية إلى الثالثة، وهكذا حتى آخر إحداثية. لا تغلق هذه القدرة المسار عائدًا إلى الأصل؛ إذا احتجتم طول حلقة جغرافية مغلقة مثل قطعة أرض أو منطقة تسليم، فاستخدموا أداة محيط مضلع بدلًا من ذلك. لكل زوج متتالٍ يقيّم المعالج صيغة haversine — هوية في علم المثلثات الكروي مستقرة عدديًا تحوّل خطّي عرض وطول إلى الزاوية المركزية بينهما ثم تضربها في نصف قطر الأرض المتوسط 6371 كيلومترًا.
يطابق هذا نصف القطر عرف كثير من مقتطفات GIS المفتوحة وعائلة haversine ثنائية النقاط في هذا الكتالوج، لذا تستنسخ مكالمة بنقطتي مرور نفس طول القوس لأداة مسافة زوجية حتى التقريب المشترك. تستخدم الأميال النظامية التحويل الدولي 1609.344 مترًا لكل ميل. النموذج كروي وليس جيوديسيات إهليلجية WGS84 من Vincenty أو Karney، لذا قد تختلف النتائج بجزء صغير من النسبة المئوية عن مكتبات المسح — عادة كافية لمرشحات لوجستية مسبقة ومخططي رحلات وملخصات رياضية ودلاء تحليلات، وليست بديلًا عن المسح العقاري.
تُدعم النقاط المتقابلة وشبه المتطابقة؛ يمنع التثبيت الداخلي حالات الحافة العائمة من إنتاج NaN، وتساهم نقاط المرور المتتالية المتطابقة بطول صفري.
أين تناسب المسافة الإجمالية للمسار المنتجات وخطوط الأنابيب
استخدموا هذه النقطة الطرفية كلما كانت لديكم إحداثيات مرتبة وتحتاجون طول جولة شفافًا على خط النظر: مسودات تسليم متعددة التوقفات قبل التوجيه الطرقي، صادرات مسارات GPX أو GeoJSON مختزلة إلى مسافة عنوانية، مختبرات GIS صفّية تقارن طول الخط المتعدد النقاط بخرائط مستوية، تطبيقات رياضية تلخص مقاطع بين نقاط تفتيش، وميزات احتيال أو مخاطر تقارن مسارات مزعومة بحدود مستقيمة. اقرنوا بمُرمِّز جغرافي فقط عند البدء من عناوين؛ وبعد الحصول على lat وlon تجنبوا إعادة الترميز الجغرافي لمجرد قياس الطول.
لمسافة القيادة منعطفًا بمنعطف أو ETA مع ازدحام أو ملامح ارتفاع، احتفظوا بمحرك توجيه مخصص — هذه الأداة طول خط متعدد النقاط على الدائرة العظمى وليست تكلفة شبكة طرق. للحدود المغلقة استخدموا محيط المضلع؛ ولزوج منشأ–مقصد واحد تكفي مكالمة haversine بنقطتين، لكن منتجات متعددة المدن ونقاط التفتيش تحتاج شكل المسار المجموع حتى يستبدل طلب واحد n−1 مكالمات زوجية ويضمن ترتيبًا متسقًا. فشل التحقق لا يستهلك الرصيد.
حافظوا على قوائم معتدلة لتجربة تفاعلية، وثبّتوا المجاميع المقربة في الاختبارات، فتحصلون على لبنة صغيرة قابلة للتدقيق لكل قناة يخدمها KIT أصلًا.
حالات الاستخدام
مسودات تسليم متعددة التوقفات وخدمة ميدانية
اجمعوا مقاطع الدائرة العظمى بين المستودع ودبابيس العملاء لتقدير طول الجولة قبل إنفاق الميزانية على واجهات توجيه طرقية كاملة.
عناوين مسافة لمسارات GPX وGeoJSON
اختزلوا مسارًا مصدَّرًا للمشي أو الدراجة أو الطيران إلى مجاميع km وmi وm مع مقاطع لكل جزء للوحات والمشاركة.
GIS صفّي وإثراء جماعي لخطط الرحلات
أضيفوا مجاميع مسارات متعددة المدن على خط النظر إلى بيانات الدروس أو مخططي السفر أو صفوف CSV دون إقامة مكدس GIS.
الأسئلة الشائعة
هل يُغلق المسار عائدًا إلى أول نقطة مرور؟
لا. تقيس هذه الأداة خطًا متعدد النقاط مفتوحًا. لمحيط حلقة جغرافية مغلقة استخدموا حاسبة محيط مضلع بدلًا من ذلك.
هل هذا نفس مسافة القيادة أو الطريق؟
لا. النتائج على خط النظر على كرة. مسافة الطريق والازدحام والارتفاع تتطلب محرك توجيه؛ استخدموا هذا لطول الخط المتعدد النقاط والمرشحات المسبقة.
كم نقطة مرور يمكنني إدخالها؟
نقطتان على الأقل وحتى 5000 نقطة. عند إدخال نقطة واحدة أو قائمة فارغة أو أكثر من 5000 نقطة لا يبدأ الحساب وتظهر رسالة بالسبب.
بأي وحدات يظهر المجموع؟
بالكيلومترات افتراضيًا، أو بالأميال البرية أو الأمتار إن شئت. تظهر المجاميع الثلاثة دائمًا مع كل مقطع بالكيلومترات، ويُحسب الميل 1609.344 متر.
ماذا يحدث إذا بدّلت خط العرض وخط الطول؟
إذا بقي الرقمان ضمن النطاقات الصالحة يُقاس المسار رغم ذلك ويصبح المجموع بلا معنى. تحقق أي القيمتين خط العرض وأيهما خط الطول قبل قياس قائمة طويلة.
أدوات ذات صلة
للمطوّرين — الوصول عبر API
كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.
الـEndpoint
صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.
استدعِ الخدمة من بيئتك
curl -X POST https://api.kit.forhosting.com/geo/route-total-distance \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"waypoints":[{"lat":40.7128,"lon":-74.006},{"lat":39.9526,"lon":-75.1652},{"lat":38.9072,"lon":-77.0369}]}'const res = await fetch("https://api.kit.forhosting.com/geo/route-total-distance", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"waypoints": [
{
"lat": 40.7128,
"lon": -74.006
},
{
"lat": 39.9526,
"lon": -75.1652
},
{
"lat": 38.9072,
"lon": -77.0369
}
]
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/geo/route-total-distance",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"waypoints": [
{
"lat": 40.7128,
"lon": -74.006
},
{
"lat": 39.9526,
"lon": -75.1652
},
{
"lat": 38.9072,
"lon": -77.0369
}
]
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/geo/route-total-distance", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"waypoints":[{"lat":40.7128,"lon":-74.006},{"lat":39.9526,"lon":-75.1652},{"lat":38.9072,"lon":-77.0369}]}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"waypoints":[{"lat":40.7128,"lon":-74.006},{"lat":39.9526,"lon":-75.1652},{"lat":38.9072,"lon":-77.0369}]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/geo/route-total-distance", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)مثال على الطلب
{
"waypoints": [
{
"lat": 40.7128,
"lon": -74.006
},
{
"lat": 39.9526,
"lon": -75.1652
},
{
"lat": 38.9072,
"lon": -77.0369
}
]
}مثال على الاستجابة
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "geo.route_total_distance",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.
الأسعار
السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.
الأخطاء
| HTTP | الرمز | المعنى |
|---|---|---|
401 | unauthorized | مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك. |
402 | insufficient_balance | رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة. |
404 | unknown_type | نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب. |
429 | rate_limited | تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة. |
ملاحظات تقنية
تغذي الوحدة النقية نفسها أداة المتصفح المجانية ومسار API المدفوع مسبقًا، بحيث تتفق الدفاتر والعاملون على الحافة واختبارات الانحدار دائمًا على نفس المجاميع المقربة دون بلاط خرائط أو ترميز جغرافي أو قفزات شبكة.
كيف تُحسب مسافة مسار متعدد النقاط على الدائرة العظمى
تُخزَّن أطوال المقاطع بالكيلومترات، وتُجمع بدقة كاملة، ثم تُقرَّب لعقد JSON مستقر: ست منازل للكيلومترات والأميال وثلاث للأمتار.
عقد الإدخال والوحدات والأسماء البديلة وأخطاء التحقق
يجب أن يقع العرض في الفترة المغلقة من −90 إلى 90؛ والطول من −180 إلى 180 شاملة. يختار unit الاختياري أي قيمة تملأ حقل total الرئيسي: km (الافتراضي) أو mi أو m. نقطة مرور واحدة أو مصفوفة فارغة أو أكثر من خمسة آلاف نقطة تفشل في التحقق قبل حساب أي مسافة. تبديل lat وlon خطأ شائع لدى العميل: إذا بقي الرقمان ضمن النطاقين فقد تنجح المكالمة بمسار غير منطقي، فتحققوا دائمًا من الشمال–الجنوب مقابل الشرق–الغرب قبل المهام الجماعية. أرسلوا جسم JSON بمصفوفة waypoints إلزامية من كائنين على الأقل، يحمل كل منهما خط العرض وخط الطول بدرجات عشرية بأسلوب WGS84. القيم خارج النطاق أو غير المنتهية أو الحقول المفقودة أو السلاسل الفارغة أو عناصر المصفوفة غير الكائنات تُرفض بـ invalid_input ولا تُحاسب أبدًا. تقبل المصفوفة الأسماء البديلة للنقل points وcoordinates وroute؛ ويقبل كل رأس latitude بدل lat وlongitude أو lng بدل lon حتى تربط عملاء GeoJSON والجوال الحقول دون خطوة إعادة تشكيل. بغض النظر عن unit، تتضمن كل استجابة ناجحة دائمًا total_km وtotal_mi وtotal_m ليعرض العملاء وحدات متعددة دون استدعاء ثانٍ. يبلّغ الحمولة أيضًا عن waypoint_count وsegment_count (دائمًا أقل بواحد من عدد نقاط المرور لمسار مفتوح صالح) وsegments_km كقائمة مرتبة لأطوال المقاطع وearth_radius_km مساويًا لـ 6371 للتدقيق. التسعير مبلغ ثابت $0.002 لكل عنصر ناجح على API؛ ومسار tier-A في المتصفح مصمم لفحوصات تفاعلية دون ربط خط أنابيب كامل أولًا.
أين تناسب المسافة الإجمالية للمسار المنتجات وخطوط الأنابيب
استدعوها من Worker أو مهمة خلفية أو سكربت: مرروا قائمة نقاط المرور، واقرأوا total وحقول الوحدات الثلاث، واحفظوا اختياريًا segments_km بجانب كل مقطع لتفصيل الواجهة.
أسئلة تقنية
كيف تُحسب المسافة الإجمالية للمسار؟
يُقاس كل زوج متتالٍ من نقاط المرور بصيغة haversine للدائرة العظمى على كرة نصف قطرها 6371 km؛ وتُجمع أطوال المقاطع لإنتاج total_km وtotal_mi وtotal_m.
ما الحد الأدنى لعدد نقاط المرور؟
يلزم نقطتان {lat, lon} على الأقل. نقطة واحدة أو قائمة فارغة تعيد invalid_input ولا تُحاسب.
كم تكلفة API؟
كل طلب ناجح يُسعَّر بمبلغ $0.002 من رصيد ForHosting KIT المدفوع مسبقًا. فشل التحقق لا يُحاسب. أداة المتصفح مجانية.