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

تقدير أجرة مشتركة

بأجرة أساسية 2.5 و1.25 لكل ميل و0.3 لكل دقيقة، تبلغ أجرة رحلة طولها 8.4 ميل ومدتها 22 دقيقة 19.6 قبل تسعير الذروة، منها 10.5 للمسافة و6.6 للوقت. مجاني في متصفحك.

مجاني
يعمل في متصفحك
دون تسجيل
بياناتك لا تغادر جهازك

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

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

مثال محلول

إذا أدخلت

الأجرة الأساسية: 2.5
السعر لكل ميل: 1.25
السعر لكل دقيقة: 0.3
المسافة: 8.4
المدة: 22

تحصل على

رسوم المسافة: 10.5
رسوم الوقت: 6.6
الأجرة التقديرية: 19.6

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

كيف تُحسب أجرة الرحلة المشتركة قبل الارتفاع من الأساس والمسافة والوقت

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

المعدلات السالبة أخطاء صارمة في عقد المنتج؛ والمسافة أو المدة السالبتان تُرفضان كذلك.

قراءة حقول الاستجابة واختيار مدخلات واقعية

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

العملة هي وحدة معدلاتكم؛ والمحرك لا يعتمد على الوحدة ولا يحوّل الدولار إلى يورو.

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

ميزانية الرحلة قبل حجز خدمة مشتركة

يُدخل المسافرون الأجرة الأساسية ومعدلات الميل والدقيقة المنشورة مع المسافة والمدة المخططة لتقدير الأجرة قبل الارتفاع قبل اختيار المنصة أو الوسيلة.

أدوات المصروفات والاسترداد

تحوّل تطبيقات المصروفات أميال الرحلة ودقائقها مع جدول أسعار معروف إلى بند أجرة شفاف يتضمن رسوم المسافة والوقت لسجلات التدقيق.

مقارنة جداول الأسعار بين المدن

تقارن فرق المنتج ومخططو الأساطيل جدولَي أسعار على نفس طول المسار والوقت لمعرفة أي مدينة تعطي أجرة تقديرية أقل.

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

هل يشمل ذلك تسعير الارتفاع أو الحد الأدنى للأجرة؟

لا. تحسب هذه الحاسبة الأساس زائد رسوم المسافة زائد رسوم الوقت فقط.

هل يمكنني استخدام الكيلومترات بدل الأميال؟

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

كيف تُحسب الأجرة التقديرية؟

تُجمع الأجرة الأساسية مع سعر الميل مضروبًا في المسافة وسعر الدقيقة مضروبًا في المدة. وبقيم المثال، 2.5 زائد 10.5 زائد 6.6 تساوي 19.6.

من أين أحصل على الأسعار التي أدخلها؟

استخدم جدول الأسعار المنشور للمدينة أو أسعار عقدك الخاص بدل الأرقام التخمينية. تحتاج إلى ثلاث قيم: الأجرة الأساسية، وسعر الميل أو الكيلومتر، وسعر الدقيقة.

هل يمكنني مقارنة جدولي أسعار مدينتين؟

نعم. أدخل المسافة والمدة نفسيهما مع أسعار كل مدينة، ثم قارن بين التقديرين. ويُظهر التفصيل هل يأتي الفرق من أجرة المسافة أم من أجرة الوقت.

أدوات ذات صلة

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/travel/rideshare-fare-estimate

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

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

curl -X POST https://api.kit.forhosting.com/travel/rideshare-fare-estimate \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"base_fare":2.5,"per_mile_rate":1.25,"per_minute_rate":0.3,"distance":8.4,"duration":22}'

const res = await fetch("https://api.kit.forhosting.com/travel/rideshare-fare-estimate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "base_fare": 2.5,
    "per_mile_rate": 1.25,
    "per_minute_rate": 0.3,
    "distance": 8.4,
    "duration": 22
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/travel/rideshare-fare-estimate",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "base_fare": 2.5,
    "per_mile_rate": 1.25,
    "per_minute_rate": 0.3,
    "distance": 8.4,
    "duration": 22
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/travel/rideshare-fare-estimate", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"base_fare":2.5,"per_mile_rate":1.25,"per_minute_rate":0.3,"distance":8.4,"duration":22}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"base_fare":2.5,"per_mile_rate":1.25,"per_minute_rate":0.3,"distance":8.4,"duration":22}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/travel/rideshare-fare-estimate", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "base_fare": 2.5,
  "per_mile_rate": 1.25,
  "per_minute_rate": 0.3,
  "distance": 8.4,
  "duration": 22
}

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

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "travel.rideshare_fare_estimate",
  "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`	تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.

ملاحظات تقنية

تضرب حاسبة تقدير الأجرة هذه مسافة الرحلة في معدلكم لكل ميل ومدتها في معدلكم لكل دقيقة، ثم تضيف الأجرة الأساسية لإنتاج estimated_fare مع تفصيل واضح لـ distance_charge و time_charge. أدخلوا base_fare و per_mile_rate و per_minute_rate و distance و duration كأرقام JSON أو سلاسل رقمية لتحصلوا على نتائج مستقرة وحتمية لتطبيقات السفر وأدوات المصروفات والعروض الصفية. يعمل ودجت المتصفح مجانًا على جهازكم؛ وتفرض واجهة API المدفوعة مسبقًا $0.002 لكل عنصر ناجح عندما تحتاج الخوادم وSDK إلى نفس العقد الحسابي دون كشط خرائط أو واجهات منصات مباشرة.

كيف تُحسب أجرة الرحلة المشتركة قبل الارتفاع من الأساس والمسافة والوقت

أرسلوا الحقول المطلوبة base_fare و per_mile_rate و per_minute_rate و distance و duration كأرقام JSON أو سلاسل رقمية. الأسماء البديلة base و flat_fare و booking_fee تُقابل base_fare؛ و mile_rate و per_km_rate و distance_rate و rate_per_mile تُقابل per_mile_rate؛ و minute_rate و time_rate و rate_per_minute تُقابل per_minute_rate؛ و miles و km و trip_distance و d تُقابل distance؛ و minutes و time و trip_minutes و t تُقابل duration. حدود المقدار تُبقي النتائج منتهية على عزل Worker. المدخلات المتطابقة تنتج دائمًا نفس JSON: حساب خالص بلا شبكة ولا بذرة عشوائية ولا ساعة حائط.

قراءة حقول الاستجابة واختيار مدخلات واقعية

عند النجاح تعيد الاستجابة base_fare و per_mile_rate و per_minute_rate و distance و duration بعد تقريب مستقر، بالإضافة إلى distance_charge و time_charge و estimated_fare وسلسلة صيغة مقروءة و method يساوي base_plus_distance_plus_time. استخدموا distance_charge و time_charge عندما تحتاجون تفصيلًا قابلًا للتدقيق للركاب أو تقارير المصروفات؛ واستخدموا estimated_fare عند إعداد ميزانية رحلة أو مقارنة جداول أسعار بين المدن. الحقول المطلوبة الناقصة والقيم غير المنتهية وأي معدل سالب تفشل بـ invalid_input ولا تُحسب بعد رفض المحرك.

استخدام API والتسعير وسير عمل السفر والحدود العملية

استخدموا الحاسبة المجانية في المتصفح لتخطيط الرحلات والعروض الصفية ومقارنات سريعة لجداول الأسعار دون تثبيت جدول بيانات. اربطوا هذا المسار بحاسبة مسافة المسار أو وقت الوصول المتوقع عندما تعرفون فقط نقطة الانطلاق والوصول وتحتاجون أولًا الأميال والدقائق، ثم استدعوا هنا بوحدات معدل متطابقة. تخضع المدخلات لقواعد الاحتفاظ نفسها لعناصر parse الأخرى في KIT، والنتائج آمنة في تثبيتات التكامل المستمر لأن الخوارزمية حتمية بالكامل. أرسلوا جسم JSON يتضمن base_fare و per_mile_rate و per_minute_rate و distance و duration (أو الأسماء البديلة الموثقة). استخدموا واجهة API المدفوعة مسبقًا عندما يحتاج بوابة سفر أو تطبيق مصروفات أو أداة أسطول أو تدفق حجز عقدًا مستقرًا تحت رصيد KIT بسعر $0.002 لكل عنصر ناجح؛ وفشل التحقق لا يستهلك الرصيد أبدًا. للمسارات متعددة المقاطع اجمعوا estimated_fare من جهة العميل أو استدعوا مرة لكل مقطع ليبقى كل جزء قابلًا للتدقيق. يمكن لمؤلفي SDK تعيين distance_charge و time_charge و estimated_fare في جداول بنفس شكل إيصال أجرة بسيط قبل الارتفاع.

أسئلة تقنية

كيف أقدّر أجرة رحلة مشتركة بهذه الحاسبة؟

أرسلوا JSON يتضمن base_fare و per_mile_rate و per_minute_rate و distance و duration. تتضمن الاستجابة distance_charge و time_charge و estimated_fare قبل الارتفاع.

ماذا يحدث إذا كان المعدل سالبًا؟

يفشل الطلب بـ invalid_input. يُرفض أي base_fare أو per_mile_rate أو per_minute_rate سالب حتى لا يعيد المحرك رصيدًا عبثيًا.

هل حاسبة تقدير أجرة الرحلة المشتركة مجانية؟

تعمل أداة المتصفح مجانًا على جهازكم. تستخدم استدعاءات API رصيد KIT المدفوع مسبقًا بسعر $0.002 لكل عنصر ناجح؛ وفشل التحقق لا يُحسب.

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

شغّل الأداة مجانًا

مثال محلول

كيف تُحسب أجرة الرحلة المشتركة قبل الارتفاع من الأساس والمسافة والوقت

قراءة حقول الاستجابة واختيار مدخلات واقعية

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

ميزانية الرحلة قبل حجز خدمة مشتركة

أدوات المصروفات والاسترداد

مقارنة جداول الأسعار بين المدن

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

أدوات ذات صلة

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

الـEndpoint

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

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

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

الأسعار

الأخطاء

ملاحظات تقنية

كيف تُحسب أجرة الرحلة المشتركة قبل الارتفاع من الأساس والمسافة والوقت

قراءة حقول الاستجابة واختيار مدخلات واقعية

استخدام API والتسعير وسير عمل السفر والحدود العملية

أسئلة تقنية

شكرًا