حلول مطابقة الغرف
تفكّك أسماء الغرف إلى النوع والفئة والإطلالة والسرير والسعة، وتجمع الغرفة الواحدة في معرّف واحد.
تجمع مطابقة الفنادق الأسماء والرموز والعناوين المختلفة التي يرسلها الموردون للفندق الواحد في هوية دائمة واحدة (HM ID). ترتبط رموز الموردين ومعرّف Google Place والإحداثيات بهذه الهوية، كما نحتفظ بمعرّفات الفنادق لدى مزوّد المطابقة الحالي أو في نظامكم الخاص كمراجع متقاطعة. وهكذا يظهر كل فندق في قائمتكم مرة واحدة فقط.
{
"hm_id": "HM-1048213",
"name": "Sunset Bay Resort & Spa",
"destination_id": "TR-07-SERIK-BELEK",
"destination": ["TR", "Antalya", "Serik", "Belek"],
"geo": { "lat": 36.8541, "lng": 31.0552 },
"supplier_codes": {
"A": "HTL-88213",
"B": "40917",
"C": "TR-ANT-551"
},
"external_ids": { "client": "OTL-2231" },
"status": "active"
} تُجمع سجلات الفندق الواحد من موردين مختلفين في بطاقة واحدة، فيظهر أفضل عرض في مكان واحد.
لا يُعاد إسناد معرّف HM ID إلى فندق آخر أبدًا. وعند دمج فندقين يُحوَّل المعرّف القديم إلى المعرّف الجديد.
نحتفظ بمعرّفات الفنادق لدى مزوّد المطابقة الحالي أو في نظامكم الخاص كمراجع متقاطعة، فلا تفقدون ما أنجزتموه من مطابقة حتى اليوم.
يمر ملف المورد الجديد بالتطبيع وحساب الدرجات، ثم يُربط بمعرّفات HM ID خلال وقت قصير.
سجل خام قادم من ثلاثة موردين
supplier,code,name,city,lat,lng
A,HTL-88213,Sunset Bay Resort & Spa,Belek,36.8541,31.0552
B,40917,SUNSET BAY RESORT SPA,Serik,36.8543,31.0549
C,TR-ANT-551,Sunset Bay Rsrt. & Spa - Adults,Antalya,36.8539,31.0556 سجل قياسي واحد تحت معرّف HM ID واحد
{
"hm_id": "HM-1048213",
"name": "Sunset Bay Resort & Spa",
"destination_id": "TR-07-SERIK-BELEK",
"destination": ["TR", "Antalya", "Serik", "Belek"],
"geo": { "lat": 36.8541, "lng": 31.0552 },
"supplier_codes": {
"A": "HTL-88213",
"B": "40917",
"C": "TR-ANT-551"
},
"external_ids": { "client": "OTL-2231" },
"status": "active"
} هذه بيانات توضيحية؛ اسم الفندق والرموز لا تخص منشأة حقيقية.
نستلم البيانات الثابتة للمورد عبر API أو CSV أو FTP. يُحفظ كل سجل بصيغته الخام وتُدار التغييرات بالإصدارات.
تُفصل اللواحق مثل "Hotel" و"Resort & Spa" عن اسم الفندق، وتُحوَّل الأسماء الروسية والعربية إلى أحرف لاتينية، وتُوحَّد صيغ العنوان والهاتف وعنوان الموقع الإلكتروني.
يُقارن كل سجل بالفنادق القريبة منه فقط. يجتمع تشابه الاسم والتضمين (embedding) متعدد اللغات والمسافة وتطابق الهاتف والموقع الإلكتروني لتعطي درجة احتمال بين 0 و1.
إذا بلغت الدرجة 0.97 فأكثر تتم المطابقة تلقائيًا؛ وتصل السجلات بين 0.80 و0.97 إلى خبير على شاشة مراجعة مدعومة بالخريطة؛ وما دون 0.80 يفتح معرّف HM ID جديدًا.
تصلكم النتيجة عبر REST API وملف dump يومي كامل وآخر تفاضلي (delta) بصيغ CSV وJSON وParquet؛ أما webhook فمخطط له.
تعمل الوكالة عادةً مع عدة موردين، ويرسل كل مورّد الفندق نفسه باسمه ورمزه وإحداثياته الخاصة. وإذا لم تُجرَ المطابقة يظهر الفندق الواحد أكثر من مرة في القائمة، وتختلّ مقارنة الأسعار، ولا يعرف العميل أي بطاقة هي الصحيحة.
يعمل hotelmapping.org مع 3.5 مليون فندق حول العالم، ويجمع هذه السجلات في هوية دائمة واحدة هي HM ID. تعملون أنتم بمعرّف HM ID وحده، ونحن نتتبع الرمز الذي يستخدمه كل مورّد.
| الحقل | الوصف |
|---|---|
| رموز الموردين | رمز الفندق لدى كل مورّد، مرتبط بمعرّف HM ID |
| معرّفات الفنادق الخارجية | معرّفات مزوّد المطابقة الحالي أو نظامكم الخاص؛ تُحفظ كمراجع متقاطعة إن وُجدت |
| Google Place ID | مرجع إضافي للموقع والهوية |
| الإحداثيات | خط العرض وخط الطول المختاران من سجلات الموردين (التحقق من الإحداثيات مخطط له) |
| الوجهة | تسلسل هرمي: الدولة ← المحافظة ← المنطقة ← منطقة المنتجع |
تُقاس جودة المطابقة في كل إصدار بمجموعة اختبار موسومة يدويًا. ننشر على الموقع فقط الأرقام التي تأكدت بهذا القياس؛ وتجدون القيم الحالية في صفحة التغطية.
الطلب
curl https://api.hotelmapping.org/v1/suppliers/B/codes/40917 \
-H "X-API-Key: $HM_API_KEY" الاستجابة
{
"supplier": "B",
"code": "40917",
"hm_id": "HM-1048213",
"confidence": 0.998,
"matched_at": "2026-11-02T08:14:00Z"
} أمثلة الشيفرة توضيحية؛ وقد تتغير أسماء الحقول عند إصدار v1.
رمز المورّد صالح داخل نظام ذلك المورّد فقط ويختلف من مورّد إلى آخر. أما HM ID فهو الهوية الدائمة التي نمنحها، وتجمع كل رموز الموردين للفندق نفسه.
الدرجات غير المؤكدة لا تُطابَق تلقائيًا بل تذهب إلى المراجعة البشرية. ومع ذلك إذا أبلغتم عن خطأ فسيُصحَّح السجل ويُضاف القرار إلى النموذج كبيانات تدريب.
لا يُمنح HM ID لفندق آخر أبدًا. تصبح حالة الفندق المغلق "closed". وعند الدمج تصبح حالة المعرّف القديم "merged" ويشير الحقل merged_into إلى المعرّف الجديد.
نعم. نحتفظ بمعرّفات الفنادق لدى مزوّد المطابقة الحالي أو في نظامكم الخاص كمراجع متقاطعة، وتعود هذه المعرّفات في استجابة API ضمن الحقل external_ids مع HM ID. وهكذا تنتقلون إلى HM ID دون التخلي عن مطابقتكم الحالية.
اطلب عرض سعر
أرسل طلبك في ثلاث خطوات، ونرسل العرض إلى بريدك الإلكتروني للعمل. الطلب غير ملزم.