ForHosting KIT · السفر والجغرافيا

مسافة هافرساين - كيلومترات وأميال وأمتار الدائرة العظمى بين نقطتين

احصل على مسافة الدائرة العظمى بين نقطتي GPS بالكيلومترات والأميال والأمتار دفعة واحدة: من 40.7128 و-74.006 إلى 51.5074 و-0.1278 تبلغ 5570.22218 كم، مقيسة على كرة نصف قطرها 6371 كم. مجاني في متصفحك.

  • مجاني
  • يعمل في متصفحك
  • دون تسجيل
  • بياناتك لا تغادر جهازك
استخدمها من الويبAPIالبريدTelegramالتطبيق قريبًا
إذا أدخلت
Lat1
40.7128
Lng1
‎-74.006
Lat2
51.5074
Lng2
‎-0.1278
تحصل على
Km
5,570.22218
Mi
3,461.175597
M
5,570,222.18

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

ما الذي تحسبه صيغة هافرساين فعليًا

صيغة هافرساين طريقة مستقرة عدديًا لتقييم الزاوية المركزية بين نقطتين على كرة انطلاقًا من خطوط عرضهما وطولهما، ثم ضرب تلك الزاوية في نصف قطر الكرة للحصول على طول القوس. وبعبارة أبسط: بمعلومية النقطة A والنقطة B، تُجيب عن المسافة التي ستقطعها لو اتبعت أقصر مسار على كوكب أملس بدلًا من خريطة مسطحة.

لا تستخدم نموذجًا إهليلجيًا مثل Vincenty أو Karney على WGS84، لذا قد تختلف النتائج بكسر ضئيل من النسبة المئوية عن مكتبات القياس الجيوديسي التي تنمذج التفلطح القطبي، وهو أمر مقبول عادةً في فحوص نصف قطر الفروع، ونطاقات الوقت المقدر للتسليم، وسلال التحليلات، وليس بديلًا عن المسح الهندسي الدقيق. الإخراج دائمًا بثلاث وحدات: الكيلومترات (كم)، والأميال القانونية الدولية (ميل، باعتماد 1609.344 مترًا لكل ميل)، والأمتار (م).

عقد الإدخال، ونطاقات الإحداثيات، والأخطاء الشائعة

يجب أن يقع خط العرض في المجال المغلق من −90 إلى 90؛ ويجب أن يقع خط الطول في المجال من −180 إلى 180 بما يشمل الطرفين. كما تفشل الحقول المفقودة، أو القيم غير المنتهية، أو السلاسل التي لا تُحلّل كأرقام في التحقق قبل حساب أي مسافة.

من العلل المتكررة لدى العملاء تبديل خط العرض بخط الطول (مثل لصق مراكز المدن بترتيب lng,lat جريًا على عادة مستوحاة من GeoJSON): قد ينجح النداء إن ظل الرقمان داخل النطاقين، لكن المسافة ستكون بلا معنى للمدن التي قصدتها، فتحقق دائمًا من أن lat هو الشمال-الجنوب و lng هو الشرق-الغرب. ومن المزالق الأخرى تغذية إحداثيات مُسقطة أو أمتار شبكة محلية بدلًا من الدرجات العشرية على نمط WGS84؛ إذ تتوقع هذه الواجهة درجات جغرافية فقط. تُعيد النقاط المتطابقة مسافة صفرية على النحو الصحيح.

الأزواج المتقابلة قطريًا مدعومة؛ ويمنع التقييد الداخلي حالات الفاصلة العائمة الحدية من إنتاج NaN.

موضع مسافة الدائرة العظمى في خط إنتاج المنتج

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

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

أما فيما بين ذلك كله، من لوحات المعلومات واتفاقيات مستوى الخدمة ومرشحات الواجهة، فهذا الطرف هو اللبنة الصغيرة الحتمية: تحقق من النطاقات، وقِس الدائرة العظمى، وأعِد ثلاث وحدات، وانتهى الأمر.

فحوص تحديد أقرب فرع ونصف قطر التسليم

قارن دبوس موقع المتسوق عبر نظام تحديد المواقع بإحداثيات كل فرع أو متجر مظلم، وأبقِ فقط المواقع الواقعة ضمن N كيلومترًا أو ميلًا قبل الترتيب حسب المخزون أو الوقت المقدر للوصول.

الترشيح المسبق للوجستيات والمستودعات

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

إثراء أزواج الأصل-الوجهة بالجملة في ملفات CSV

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

ما هي صيغة مسافة هافرساين؟

هي صيغة من علم المثلثات الكروية تحوّل خطي عرض وطول إلى الزاوية المركزية بينهما، ثم تضربها في نصف قطر الأرض (هنا 6371 كم) للحصول على طول قوس الدائرة العظمى.

ما نطاقات الإحداثيات المقبولة؟

يجب أن يقع خط العرض بين −90 و90 بما يشمل الطرفين؛ ويجب أن يقع خط الطول بين −180 و180 بما يشمل الطرفين.

هل هذه هي مسافة القيادة نفسها؟

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

كم تبلغ تكلفة الواجهة؟

ولا يُحتسب رسم على فشل التحقق. ولا يلزم أي اشتراك.

لماذا تكون المسافة خاطئة رغم أن الأداة قبلت الإحداثيات؟

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

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

POSThttps://api.kit.forhosting.com/geo/haversine

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

curl -X POST https://api.kit.forhosting.com/geo/haversine \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lat1":40.7128,"lng1":-74.006,"lat2":51.5074,"lng2":-0.1278}'
{
  "lat1": 40.7128,
  "lng1": -74.006,
  "lat2": 51.5074,
  "lng2": -0.1278
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "geo.haversine",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

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

لكل طلب$0.002

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

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

ما الذي تحسبه صيغة هافرساين فعليًا

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

عقد الإدخال، ونطاقات الإحداثيات، والأخطاء الشائعة

أرسل أربعة أرقام: lat1 و lng1 لنقطة الأصل، و lat2 و lng2 للوجهة، جميعها بالدرجات العشرية. تُرفض القيم الخارجة عن تلك النطاقات بالرمز invalid_input ولا يُحتسب عليها أي رسم. التسعير ثابت بمقدار $0.002 لكل عنصر ناجح على الواجهة؛ أما مسار الأداة داخل المتصفح لقدرات parse من الفئة tier A فمصمَّم لتتمكن من التجربة دون توصيل خط معالجة كامل أولًا.

موضع مسافة الدائرة العظمى في خط إنتاج المنتج

استدعِها من Worker، أو مهمة خلفية، أو نص برمجي: مرّر الإحداثيات الأربعة، واقرأ كم/ميل/م من النتيجة JSON، ثم خزّنها أو اعرضها.

ما الوحدات التي تُعيدها geo.haversine؟

تتضمن كل استجابة ناجحة الكيلومترات (كم)، والأميال القانونية الدولية (ميل)، والأمتار (م)، إضافةً إلى ثابت radius_km المستخدم في الحساب.

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