حاسبة أميال المسافر
إذا طرت 2500 ميل بمعدل كسب 100 % ومكافأة حالة 25 %، تكسب 3125 ميلًا. أدخل السعر أو المسافة ومعدل الكسب في برنامجك ومكافأتك لترى الأميال الأساسية والمكافأة والإجمالي. مجانية في متصفحك.
- مجاني
- يعمل في متصفحك
- دون تسجيل
- بياناتك لا تغادر جهازك
شغّل الأداة مجانًا
مثال محلول
- المبلغ الأساسي
- 400
- معدل الكسب
- 5
- مكافأة المستوى (%)
- 50
- وضع الحساب
- spend
- الوحدة الأساسية
- currency
- وحدة المعدل
- miles_per_currency_unit
- الأميال الأساسية
- 2,000
- أميال المكافأة
- 1,000
يبدأ التخطيط لرحلة حول رصيد الولاء بسؤال عملي واحد: كم ميلًا سيُقيَّد فعليًا لهذا التذكرة؟ تضاعف حاسبة أميال المسافر المتكرر هذه أساسًا شفافًا — الأجرة التي دفعتموها أو المسافة التي تطيرونها — في معدل تجميع برنامجكم، ثم تطبق مكافأة اختيارية لحالة النخبة أو البطاقة المشتركة كنسبة مئوية من تلك الأميال الأساسية. استخدموا وضع الإنفاق عندما تعتمد شركة الطيران التجميع على الإيراد (أميال لكل دولار أو يورو)، ووضع المسافة عندما ما زال الجدول يستخدم نسبة من الأميال المقطوعة. لا يوجد استعلام حي لجداول الجوائز ولا مصفوفة فئات مخفية — فقط الأرقام التي تعرفونها مسبقًا من قواعد الأجرة أو دليل النخبة.
أين تظهر حاسبات أميال المسافر المتكرر في العمل الحقيقي
يقارن مسافرو الترفيه أُجرتين منشورتين على نفس المسار ويحتاجون تقديرًا شفافًا لعدد الأميال التي ستقيدها كل تذكرة قبل اختيار الخيار الأرخص بلا حالة أو الأجرة الأعلى قليلًا التي ما زالت تؤهل للتجميع الكامل بالإيراد. يصمم مديرو سفر الشركات الإنفاق المؤهل للنخبة عبر ربع سنة ويريدون صيغة جداول حتمية تطابق أداة المتصفح حتى لا يختلف المالية والمسافرون حول أرصدة نهاية السنة. ينشر المدونون وصانعو الدورات شروح مكافأة الحالة ويحتاجون أرقامًا قابلة لإعادة الإنتاج للقطات الشاشة والاختبارات والواجبات ذات التصحيح الآلي دون اختراع حالات حدّية لفاصلة عائمة.
يمكن لروبوتات الحجز التي تقيّم مسارات نقد زائد أميال إرفاق تقدير أميال مكتسبة بكل تذكرة مرشحة بعد معرفة معدل البرنامج ونسبة حالة المسافر، ورفض المسارات دون حد أدنى من الأميال لكل وحدة عملة. إن احتجتم لاحقًا إلى كشط حي لجداول الجوائز أو مضاعفات تحويل الشركاء أو تسعير جوائز ديناميكي أو تقييم نقاط الفنادق، فاعاملوا ذلك كنوايا بحث وصفحات هبوط منفصلة بدل إثقال صفحة حاسبة أميال المسافر المتكرر هذه.
يستهدف slug تحسين محركات البحث من يبحث عن حاسبة أميال مكتسبة للمسافر المتكرر ويعرف أصلًا أجرته أو مسافته ومعدل برنامجه ويحتاج فقط رياضيات التجميع بدقة وسرعة.
حالات الاستخدام
التخطيط بجدول المسافة
استخدموا وضع المسافة مع الأميال المقطوعة ونسبة التجميع من جدول الفئة لتقدير الرصيد عندما يكون البرنامج ما زال قائمًا على المسافة.
الأسئلة الشائعة
هل تستعلم هذه الأداة جداول برامج شركات الطيران؟
لا. أنتم تزودون معدل التجميع ومكافأة الحالة من دليل برنامجكم. لا يوجد جلب شبكي لجداول حية أو مصفوفات فئات.
كيف تعمل مكافأة الحالة؟
هي نسبة تُضاف فوق أميالك الأساسية: 50 تعني زيادة 50 %. فمع 2000 ميل أساسي تضيف مكافأة 50 % مقدار 1000 ميل، ليصبح الإجمالي 3000. وإذا تركتها فارغة تُحسب صفرًا.
ما معدل الكسب الذي أدخله في وضع المسافة؟
أدخل نسبة الكسب كعدد عشري: 1 تعني 100 % من المسافة المطيرة، و0.5 تعني 50 %، و0.25 تعني 25 %. وإذا كانت درجة حجزك تمنح مكافأة 150 %، فأدرجها في المعدل على أنها 1.5.
ما المبلغ الذي يُحتسب في وضع الإنفاق؟
سعر التذكرة المؤهل، وغالبًا هو السعر الأساسي دون الضرائب أو المبلغ الذي يعتمده البرنامج للكسب. ويكون المعدل حينها عدد الأميال لكل وحدة عملة كما يذكره دليل البرنامج.
هل يغيّر اختيار الوضع طريقة الحساب؟
لا. المعادلة واحدة، والوضع يوضح فقط هل الرقم الأساسي سعر أم مسافة، وهل المعدل أميال لكل وحدة عملة أم نسبة. في الحالتين يُضرب الأساس في المعدل ثم تُضاف المكافأة.
أدوات ذات صلة
للمطوّرين — الوصول عبر API
كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.
الـEndpoint
صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.
استدعِ الخدمة من بيئتك
curl -X POST https://api.kit.forhosting.com/travel/miles-earned \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"base_amount":400,"earning_rate":5}'const res = await fetch("https://api.kit.forhosting.com/travel/miles-earned", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"base_amount": 400,
"earning_rate": 5
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/travel/miles-earned",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"base_amount": 400,
"earning_rate": 5
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/travel/miles-earned", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"base_amount":400,"earning_rate":5}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"base_amount":400,"earning_rate":5}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/travel/miles-earned", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)مثال على الطلب
{
"base_amount": 400,
"earning_rate": 5
}مثال على الاستجابة
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "travel.miles_earned",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.
الأسعار
السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.
الأخطاء
| HTTP | الرمز | المعنى |
|---|---|---|
401 | unauthorized | مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك. |
402 | insufficient_balance | رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة. |
404 | unknown_type | نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب. |
429 | rate_limited | تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة. |
ملاحظات تقنية
المعادلة حتمية ومتطابقة في أداة المتصفح المجانية وفي واجهة API المدفوعة: الأميال الأساسية تساوي المبلغ الأساسي مضروبًا في المعدل؛ أميال المكافأة تساوي الأميال الأساسية مضروبة في نسبة مكافأة الحالة مقسومة على مئة؛ الإجمالي يساوي الأساس زائد المكافأة. سعر طلبات API الناجحة هو الأساس المنشور $0.002 لكل عنصر؛ فشل التحقق لا يُحسب.
كيف تُحسب الأميال المكتسبة من الأجرة والمسافة والمعدل والحالة
ابدؤوا من أجرة منشورة أو مسافة مقطع معروفة ولغة التجميع في دليل برنامج المسافر المتكرر لديكم. في وضع الإنفاق، base_amount هو أجرة التذكرة المؤهلة بوحدات العملة الرئيسية — غالبًا الأجرة الأساسية دون الضرائب، أو المبلغ الذي يعدّه البرنامج إيرادًا للتجميع — وearning_rate أميال لكل وحدة عملة، مثل خمسة أميال لكل دولار على أجرة بطاقة مشتركة أو ميل واحد لكل يورو على تذكرة إيراد أساسية. في وضع المسافة، base_amount هو المسافة المقطوعة بالأميال القانونية أو الكيلومترات (استخدموا وحدة واحدة باتساق) وearning_rate نسبة التجميع كعدد عشري: واحد يعني مئة بالمئة من المسافة، وصفر فاصلة خمسة يعني خمسين بالمئة، وواحد فاصلة خمسة يعني مكافأة فئة بمئة وخمسين بالمئة مدمجة مسبقًا في المعدل. تضرب الحاسبة base_amount في earning_rate لتكوين base_miles. إذا كانت لديكم حالة نخبة أو مكافأة علامة مشتركة تعلن نسبة إضافية فوق الأميال الأساسية، ضعوا ذلك الرقم في status_bonus_percent — مثلًا خمسون لزيادة خمسين بالمئة — فيصبح bonus_miles مساويًا لـ base_miles مضروبًا في النسبة على مئة وtotal_miles مساويًا لـ base_miles زائد bonus_miles. وبالمثل، total_miles يساوي base_amount مضروبًا في earning_rate مضروبًا في واحد زائد status_bonus_percent على مئة. ترك status_bonus_percent يجعله افتراضيًا صفرًا فتبقى تقديرات غير النخبة صادقة. المبالغ السالبة والحقول الإلزامية الناقصة والأعداد غير المنتهية وسلاسل الوضع المجهولة تفشل بـ invalid_input حتى لا يرى العميل NaN أو قصًّا صامتًا. المدخلات المتطابقة تنتج دائمًا JSON متطابقًا: بلا جلب جداول عبر الشبكة، وبلا ضوضاء عشوائية، وبلا اعتماد على الساعة.
ما ترسلونه وما تستلمونه
فحوصات كلاسيكية: أجرة بأربعمئة وحدة عملة بخمسة أميال لكل وحدة مع مكافأة حالة خمسين بالمئة تعطي ألفي ميل أساسي وثلاثة آلاف إجماليًا؛ أو مسافة بألفي وخمسمئة وحدة بتجميع مئة بالمئة ومكافأة خمسة وعشرين بالمئة تعطي ألفين وخمسمئة أساسًا وثلاثة آلاف ومئة وخمسة وعشرين إجمالًا. اربطوا نموذج المتصفح المجاني لتخطيط رحلة فردية، ثم نفس العقد من النصوص البرمجية عند دفع عشرات الأجور المرشحة مقابل جدول معدلات البرنامج نفسه. أرسلوا base_amount وearning_rate كأعداد منتهية إلزامية أكبر من أو تساوي صفرًا. اختياريًا أرسلوا status_bonus_percent كعدد منتهٍ غير سالب، وmode كسلسلة spend أو distance (أسماء بديلة fare أو revenue للإنفاق، وmiles أو km للمسافة). سلاسل JSON التي تُفسَّر كأعداد تُقبل مثل الحرفيات العددية. غياب base_amount أو earning_rate، والسلاسل الفارغة، وNaN، وInfinity، والقيم السالبة، وmode غير الصالح تفشل بـ invalid_input ولا تُحسب. عند النجاح تعيد الاستجابة base_amount وearning_rate وstatus_bonus_percent وmode منظّفة؛ وتُبلغ base_unit كـ currency أو distance وrate_unit كـ miles_per_currency_unit أو accrual_ratio؛ وتعيد base_miles وbonus_miles وtotal_miles وeffective_multiplier مساويًا لواحد زائد نسبة المكافأة على مئة، وسلسلة صيغة مقروءة. سعر طلبات API الناجحة هو الأساس المنشور $0.002 لكل عنصر؛ إخفاقات التحقق لا تستهلك الرصيد المدفوع مسبقًا. يمكن للأدوات اللاحقة وضع عتبة على total_miles وحده، أو حفظ الكائن كاملًا للتدقيق، أو دمج النتائج مع قدرة منفصلة لتقييم السنتات لكل نقطة عند تقرير الحرق أو التجميع على مسار معيّن.
أين تظهر حاسبات أميال المسافر المتكرر في العمل الحقيقي
تستخدم فرق تأهيل الولاء نفس JSON في العروض التجريبية وصناديق اختبار API حتى تبقى أوراق العمل دون اتصال متوافقة مع الإنتاج. ولأن هذه القدرة محرك parse خالص، سعر API هو الأساس المنشور $0.002 لكل عنصر ناجح وفشل التحقق لا يستهلك الرصيد.
حالات التكامل
الموازنة بين الأجرة والحالة
أدخلوا أُجرتين مرشحتين بنفس معدل التجميع ونسبة مكافأة حالتكم، ثم قارنوا total_miles قبل شراء التذكرة الأرخص غير المؤهلة.
تسجيل الرحلات بالجملة
مرّروا الأجور والمعدلات المرشحة إلى API ورتّبوا المسارات حسب total_miles بصيغة حتمية واحدة يشاركها المتصفح والنصوص البرمجية.
أسئلة تقنية
كيف تُحسب الأميال الإجمالية؟
total_miles = base_amount × earning_rate × (1 + status_bonus_percent / 100). الأميال الأساسية هي base_amount مضروبًا في earning_rate؛ ومكافأة الحالة نسبة إضافية من تلك الأميال الأساسية.
ما الفرق بين وضع الإنفاق ووضع المسافة؟
يوسِم mode الوحدات فقط. في الإنفاق، base_amount عملة الأجرة وearning_rate أميال لكل وحدة عملة. في المسافة، base_amount مسافة الرحلة وearning_rate نسبة تجميع مثل 1 لـ 100% من المسافة. الضرب متطابق.
هل status_bonus_percent إلزامي؟
لا. عند حذفه يكون الافتراضي 0، فتحصلون على تقدير أميال أساسية فقط دون اختراع رصيد نخبة.
كم التكلفة؟
أداة المتصفح مجانية وتعمل محليًا. طلبات API تستخدم رصيد KIT المدفوع مسبقًا بسعر $0.002 لكل عنصر ناجح؛ الإدخال غير الصالح لا يُحسب.