حلول مطابقة الفنادق
معرّف HM ID دائم لكل منشأة، مع رموز الموردين والمعرّفات المتقاطعة في سجل واحد.
تحوّل مطابقة أنظمة الوجبات الصيغ المختلفة التي يرسلها الموردون لمفهوم الطعام والشراب نفسه ("ALL INCLUSIVE ULTRA" و"Ultra Herşey Dahil" و"Ультра всё включено") إلى رمز قياسي واحد: RO أو BB أو HB أو HB+ أو FB أو FB+ أو AI أو AI+ أو UAI أو SAI. وهكذا لا يُقارَن عرض شامل كليًا بعرض شامل كليًا ألترا كأنهما المنتج نفسه.
{
"hm_id": "HM-1048213",
"boards": [
{ "supplier": "A", "input": "ALL INCLUSIVE ULTRA", "code": "UAI" },
{ "supplier": "B", "input": "Ultra Herşey Dahil", "code": "UAI" },
{ "supplier": "C", "input": "Ультра всё включено", "code": "UAI" },
{ "supplier": "A", "input": "Half Board Plus", "code": "HB+" },
{ "supplier": "B", "input": "Yarım Pansiyon + İçecek", "code": "HB+" },
{ "supplier": "C", "input": "Soft All Inc.", "code": "SAI" }
]
} تبقى عروض AI وUAI في رمزين منفصلين. ويظهر في القائمة بوضوح أن العرض الأرخص في الظاهر هو في الحقيقة مفهوم أدنى.
RO وBB وHB وHB+ وFB وFB+ وAI وAI+ وUAI وSAI. تُربط كل صيغ الموردين بهذه القائمة القصيرة، فتعمل المرشحات والتقارير بقائمة واحدة.
تُحفظ في القاموس الصيغ بالتركية والإنجليزية والألمانية والروسية والأخطاء الإملائية والاختصارات: "Herşey Dahil" و"Halbpension" و"Полупансион".
تُقترح الصيغة غير الموجودة في القاموس لرمز ما بدرجة تشابه، وتُضاف إلى القاموس بعد موافقة خبير. والصيغة المعتمدة مرة واحدة لا يُسأل عنها ثانية.
تُغطى المفاهيم الشائعة خصوصًا في منتجعات تركيا والمتوسط، مثل الشامل كليًا ألترا والشامل كليًا الخفيف ونصف الإقامة مع المشروبات، برموز مستقلة.
صيغ أنظمة الوجبات القادمة من ثلاثة موردين للفندق نفسه
supplier,hotel_code,rate_code,board
A,HTL-88213,R1,ALL INCLUSIVE ULTRA
B,40917,UAI,Ultra Herşey Dahil
C,TR-ANT-551,UAI-1,Ультра всё включено
A,HTL-88213,R2,Half Board Plus
B,40917,HBP,Yarım Pansiyon + İçecek
C,TR-ANT-551,SAI,Soft All Inc. رموز قياسية لأنظمة الوجبات
{
"hm_id": "HM-1048213",
"boards": [
{ "supplier": "A", "input": "ALL INCLUSIVE ULTRA", "code": "UAI" },
{ "supplier": "B", "input": "Ultra Herşey Dahil", "code": "UAI" },
{ "supplier": "C", "input": "Ультра всё включено", "code": "UAI" },
{ "supplier": "A", "input": "Half Board Plus", "code": "HB+" },
{ "supplier": "B", "input": "Yarım Pansiyon + İçecek", "code": "HB+" },
{ "supplier": "C", "input": "Soft All Inc.", "code": "SAI" }
]
} هذه بيانات توضيحية؛ الفندق والرموز لا تخص منشأة حقيقية.
تُحوَّل الصيغة الواردة إلى أحرف صغيرة، وتُزال علامات الترقيم والمسافات الزائدة، وتُفكّ اختصارات مثل "Inc." و"Incl.". وتُوحَّد "Herşey" و"Her Şey" في صيغة واحدة.
يُبحث عن الصيغة المطبَّعة في قاموس المرادفات لكل لغة. وإذا وُجدت رُبطت مباشرة بالرمز القياسي.
للصيغ غير الموجودة في القاموس يُقترح أقرب رمز بدرجة تشابه. وتعود الدرجة والأسلوب (القاموس أو التشابه) معًا في الاستجابة.
الاقتراحات غير المؤكدة تدخل قائمة المراجعة. وتُضاف الصيغة المعتمدة إلى القاموس وتُطابَق مباشرة في الطلب التالي.
يعود الرمز القياسي فورًا في استجابة API. ويُحفظ أيضًا النص الأصلي الذي أرسله المورّد، فيمكن إجراء فحص رجعي عند الحاجة.
نظام الوجبات من أكثر الحقول تأثيرًا في سعر الفندق. ومع ذلك يرسله الموردون غالبًا كنص حر وبلغاتهم الخاصة. وتظهر المشكلة بأوضح صورها في أسواق المنتجعات التي تنتشر فيها مفاهيم الشامل كليًا، مثل تركيا والمتوسط، وتتخذ أربعة أشكال:
| الرمز | المعنى | الصيغ التي تظهر لدى الموردين |
|---|---|---|
| RO | غرفة فقط | Room Only, Sadece Oda, Ohne Verpflegung, Без питания |
| BB | غرفة وفطور | Bed & Breakfast, Oda Kahvaltı, Frühstück, Завтрак |
| HB | نصف إقامة | Half Board, Yarım Pansiyon, Halbpension, Полупансион |
| HB+ | نصف إقامة مع المشروبات | Half Board Plus, HB Plus, Yarım Pansiyon + İçecek |
| FB | إقامة كاملة | Full Board, Tam Pansiyon, Vollpension, Полный пансион |
| FB+ | إقامة كاملة مع المشروبات | Full Board Plus, Tam Pansiyon Plus |
| AI | شامل كليًا | All Inclusive, Her Şey Dahil, Herşey Dahil, Всё включено |
| AI+ | شامل كليًا موسّع | All Inclusive Plus, AI Plus, Her Şey Dahil Plus |
| UAI | شامل كليًا ألترا | Ultra All Inclusive, Ultra Herşey Dahil, Ультра всё включено |
| SAI | شامل كليًا محدود | Soft All Inclusive, Soft AI, Soft Her Şey Dahil |
تجدون شرح الرموز بالتفصيل في دليل أنظمة الوجبات، والفرق بين AI وUAI في مقال الفرق بين الشامل كليًا والشامل كليًا ألترا. وللمصطلح راجعوا صفحة القاموس نظام الوجبات.
في كثير من مزوّدي المطابقة لا يُقدَّم نظام الوجبات كمنتج مستقل. أما في hotelmapping.org فمطابقة أنظمة الوجبات منتج مستقل له قاموسه وقائمة مراجعته؛ ويمكنكم اختياره كوحدة منفصلة عند طلب عرض السعر.
تحوّل مطابقة أنظمة الوجبات الصيغة إلى الرمز القياسي. أما المشروبات التي يقدمها الفندق في مفهومه ألترا وفي أي ساعات فهو تعريف الفندق نفسه؛ وهو شأن وصف الفندق لا رمز نظام الوجبات. وللاطلاع على أوصاف الفنادق راجعوا منتج محتوى الفنادق. ولمقارنة أسعار صحيحة يعمل رمز نظام الوجبات مع مطابقة الفنادق ومطابقة الغرف. وللإطار العام راجعوا دليل مطابقة الفنادق، ولتجربة صيغة واحدة راجعوا محوّل رموز أنظمة الوجبات.
الطلب
curl -X POST https://api.hotelmapping.org/v1/boards/map \
-H "X-API-Key: $HM_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"hm_id": "HM-1048213",
"values": ["Soft All Inc.", "Ultra Herşey Dahil Plus"]
}' الاستجابة
{
"results": [
{
"input": "Soft All Inc.",
"code": "SAI",
"score": 0.99,
"decision": "auto_match",
"method": "dictionary"
},
{
"input": "Ultra Herşey Dahil Plus",
"code": "UAI",
"score": 0.88,
"decision": "review",
"method": "similarity"
}
]
} أمثلة الشيفرة توضيحية؛ وقد تتغير أسماء الحقول عند إصدار v1.
يشمل AI (شامل كليًا) عادةً الوجبات والمشروبات المحلية. أما UAI (شامل كليًا ألترا) فيضيف إليه عادةً خدمات إضافية مثل المشروبات المستوردة أو مطاعم à la carte. يختلف النطاق من فندق إلى آخر؛ نحن نحوّل المفهوم إلى الرمز القياسي، ويحدد الفندق محتوى المفهوم.
يُطابَق Soft AI برمز مستقل هو SAI. وهو عادةً صيغة أكثر تحديدًا من الشامل كليًا؛ كأن لا تُقدَّم المشروبات الكحولية إطلاقًا أو تقتصر على ساعات معينة. وتسجيله على أنه AI أو FB+ يفسد مقارنة الأسعار.
يضيف Half Board Plus (HB+) المشروبات إلى نصف الإقامة؛ وعادةً تكون المشروبات المحلية مشمولة في العشاء، ويختلف النطاق من فندق إلى آخر. وإذا أرسله مورّد على أنه HB فقط ضاعت معلومة المشروبات؛ أما الرمز القياسي فيحفظ هذا الفرق.
في كثير من مزوّدي المطابقة لا يُقدَّم نظام الوجبات كمنتج مستقل. أما في hotelmapping.org فمطابقة أنظمة الوجبات منتج مستقل يعمل مع مطابقة الفنادق والغرف.
نعم. يمكنكم إدخال صيغة مثل "Ultra Herşey Dahil Plus" في أداة تحويل رموز أنظمة الوجبات المجانية ومعرفة الرمز القياسي الذي تُطابَق به.
اطلب عرض سعر
أرسل طلبك في ثلاث خطوات، ونرسل العرض إلى بريدك الإلكتروني للعمل. الطلب غير ملزم.