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

حساب المسافة بين محطات الوقود وعدد التوقفات

خططوا للتزود بالوقود في الرحلات الطويلة بالجمع بين المسافة الكلية، والمدى الواقعي للمركبة بخزان ممتلئ، ونسبة احتياط للسلامة.

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

شغّل الأداة مجانًا اطّلع على الـAPI

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

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

اختاروا مسافة ومدى واقعيين

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

اجعلوا هامش السلامة احتياطيا

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

حولوا المسافة إلى خطة توقف فعلية

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

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

تخطيط رحلة طويلة بالسيارة

قدروا مسافة محافظة وأقل عدد من التوقفات قبل اختيار المحطات على طريق طويل.

مقارنة خيارات المركبات

تعرفوا على أثر اختلاف مدى الخزان في تكرار التزود بالوقود للمسار والاحتياط نفسيهما.

الاستعداد للطرق النائية

استخدموا احتياطا أكبر لتقصير المقاطع عندما تكون محطات الوقود قليلة أو غير مؤكدة.

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

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

سعر API هو $0.002 لكل طلب.

هل يمكن استعمال الأميال أو الكيلومترات؟

نعم. استعملوا أي وحدة، لكن يجب توحيدها في total_distance وrange_per_tank. تعاد المسافة الفاصلة بالوحدة نفسها.

هل يشمل العدد الخزان الممتلئ عند البداية؟

لا. يحسب التزود أثناء الطريق فقط، ويفترض أن المركبة تنطلق بخزان ممتلئ.

لماذا نستخدم هامش سلامة؟

إنه يحفظ جزءا من المدى للتحويلات ومشكلات المحطات واختلاف الاستهلاك بدلا من التخطيط للوصول بخزان فارغ.

هل تختار الأداة محطات الوقود؟

لا. إنها تحسب المسافة والعدد، وعليكم تحديد المحطات الفعلية والتحقق من توفرها.

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/travel2/road-trip-fuel-stops

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

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

curl -X POST https://api.kit.forhosting.com/travel2/road-trip-fuel-stops \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"total_distance":1000,"range_per_tank":400,"safety_margin_percent":20}'

const res = await fetch("https://api.kit.forhosting.com/travel2/road-trip-fuel-stops", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "total_distance": 1000,
    "range_per_tank": 400,
    "safety_margin_percent": 20
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/travel2/road-trip-fuel-stops",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "total_distance": 1000,
    "range_per_tank": 400,
    "safety_margin_percent": 20
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/travel2/road-trip-fuel-stops", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"total_distance":1000,"range_per_tank":400,"safety_margin_percent":20}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"total_distance":1000,"range_per_tank":400,"safety_margin_percent":20}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/travel2/road-trip-fuel-stops", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "total_distance": 1000,
  "range_per_tank": 400,
  "safety_margin_percent": 20
}

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

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

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

الأسعار

لكل طلب$0.002

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

الأخطاء

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

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