حلول مطابقة الفنادق
معرّف HM ID دائم لكل منشأة، مع رموز الموردين والمعرّفات المتقاطعة في سجل واحد.
تأخذ Find Match API سجل فندق واحدًا لديكم (الاسم والعنوان والإحداثيات، وإن وُجد الهاتف وعنوان الموقع الإلكتروني) وتبحث عن مقابله في قاعدة بيانات hotelmapping.org. تعود في الاستجابة معرّف HM ID المطابق ودرجة ثقة بين 0 و1 والقرار الصادر بحسب هذه الدرجة. وتعمل أيضًا مع السجلات التي لا تملك رمز مورّد.
{
"reference": "K-0192",
"normalized_name": "lara palm",
"decision": "auto_match",
"hm_id": "HM-1052207",
"name": "Lara Palm Hotel",
"confidence": 0.973,
"signals": {
"name_similarity": 0.95,
"distance_m": 63,
"phone_match": true
}
} يكفي الاسم ومعلومات الموقع لفنادقكم المتعاقد معها أو سجلات الإكسترانت أو اسم فندق مكتوب كنص حر.
تعود في كل استجابة درجة الثقة وحقل القرار. ويمكنكم أيضًا تقييد ما تقبلونه تلقائيًا بقاعدة العمل الخاصة بكم.
تمر الاختصارات واللواحق الناقصة والأسماء بالأحرف السيريلية والعربية بالتطبيع. وتُقارن فروق مثل "Rsrt." و"Resort" على مستوى الحرف والكلمة في تشابه الاسم.
تعود أكثر المرشحين احتمالًا مع مسافاتهم ودرجاتهم؛ فيسهل اتخاذ القرار في السجلات التي تحتاج إلى مراجعة.
سجل من نظام الوكالة نفسه دون رمز مورّد
internal_id,name,city,lat,lng,phone
K-0192,Отель Лара Палм,Анталья,36.8567,30.7969,0242 000 00 00 نتيجة Find Match API
{
"reference": "K-0192",
"normalized_name": "lara palm",
"decision": "auto_match",
"hm_id": "HM-1052207",
"name": "Lara Palm Hotel",
"confidence": 0.973,
"signals": {
"name_similarity": 0.95,
"distance_m": 63,
"phone_match": true
}
} هذه بيانات توضيحية؛ اسم الفندق والهاتف والرموز لا تخص منشأة حقيقية. يُحوَّل الاسم الروسي إلى أحرف لاتينية وتُفصل لاحقة "فندق" ثم تتم المقارنة.
يُرسَل اسم الفندق ومعلومات الموقع إلى نقطة النهاية POST /v1/match. وكلما أُضيفت الإحداثيات والعنوان والهاتف وعنوان الموقع الإلكتروني ازدادت قوة المطابقة.
تُفصل عن الاسم لواحق مثل "Hotel" و"Resort & Spa" و"Otel"، وتُحوَّل الأسماء الروسية والعربية إلى أحرف لاتينية، ويُحوَّل الهاتف إلى الصيغة الدولية ويُختزل عنوان الموقع إلى اسم النطاق.
يُقارن السجل بالفنادق القريبة منه فقط: خلية جغرافية بنحو 500 متر، وتشابه الاسم، ونفس الهاتف أو النطاق.
يجتمع تشابه الاسم وتشابه التضمين (embedding) متعدد اللغات والمسافة وتطابق الهاتف والموقع الإلكتروني وعدد النجوم والرمز البريدي لإنتاج درجة احتمال بين 0 و1.
إذا بلغت الدرجة 0.97 فأكثر يعود auto_match، وبين 0.80 و0.97 يعود review، وما دون 0.80 يعود no_match؛ وفي استجابة no_match تكون قيمة hm_id هي null. وتتضمن الاستجابة أيضًا أكثر المرشحين احتمالًا.
يربط منتج مطابقة الفنادق ملفات الموردين بمعرّف HM ID دفعةً واحدة. أما Find Match API فمخصصة للاستعلام الفوري عن سجل واحد. من مجالات الاستخدام النموذجية:
نشرح المنطق العام للمطابقة في دليل مطابقة الفنادق.
| درجة الثقة | decision |
ماذا أفعل؟ |
|---|---|---|
| 0.97 فأكثر | auto_match |
يمكنكم استخدام HM ID مباشرةً |
| 0.80–0.97 | review |
راجعوا المرشحين؛ وانظروا إلى فروق الاسم والمسافة والهاتف |
| دون 0.80 | no_match |
تعود hm_id بقيمة null. قد لا تكون المنشأة في قاعدة البيانات بعد؛ تحققوا من الاسم والموقع |
تُضبط العتبات بحسب مجموعة اختبار موسومة يدويًا وقد تتغير بين الإصدارات. نشرح الإشارات التي تتكون منها الدرجة في مصطلح درجة المطابقة.
reference. يعود معرّف سجلكم الخاص في الاستجابة كما هو؛ فيسهل ربط النتائج بجدولكم.بدلًا من الاستعلام عن آلاف السجلات واحدًا واحدًا، مرّروا ملفكم إلى مسار مطابقة الفنادق؛ وتعود النتيجة بملف dump يومي كامل وآخر تفاضلي. لا تفتح Find Match API هوية جديدة للسجل الذي تقل درجته عن 0.80؛ أما في مسار الاستلام الدفعي فيُفتح لهذه السجلات معرّف HM ID جديد (قرار new_id). وبمعرّف HM ID الذي تجدونه تصلون أيضًا إلى بيانات الوجهة ومحتوى الفنادق.
حقول الاستجابة تتبع API v1؛ ويُنشر المخطط القاطع في صفحة المطورين.
الطلب
curl -X POST https://api.hotelmapping.org/v1/match \
-H "X-API-Key: $HM_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"reference": "res-55821",
"name": "Sunset Bay Rsrt. & Spa - Adults",
"city": "Belek",
"country": "TR",
"lat": 36.8539,
"lng": 31.0556
}' الاستجابة
{
"reference": "res-55821",
"decision": "auto_match",
"hm_id": "HM-1048213",
"name": "Sunset Bay Resort & Spa",
"confidence": 0.984,
"candidates": [
{ "hm_id": "HM-1048213", "confidence": 0.984, "distance_m": 42 },
{ "hm_id": "HM-1048390", "confidence": 0.412, "distance_m": 310 }
]
} أمثلة الشيفرة توضيحية؛ وقد تتغير أسماء الحقول عند إصدار v1.
الاستعلام برمز المورّد (GET /v1/suppliers/{supplier}/codes/{code}) يجلب مباشرةً معرّف HM ID لرمز سبقت مطابقته. أما Find Match API فتبحث بالاسم والعنوان والإحداثيات عن سجل لا رمز له أو غير معروف في النظام، وتحسب درجة جديدة.
يلزم اسم الفندق ومعلومات الموقع (الإحداثيات أو الدولة والمدينة والعنوان). الهاتف وعنوان الموقع الإلكتروني والرمز البريدي اختيارية لكنها تقوّي الدرجة.
قارنوا المرشحين في الاستجابة بحسب الاسم والمسافة والدرجة. ولم تُحسم بعد طريقة إرسال السجلات التي لا تستطيعون البت فيها إلى مراجعة الخبير (البوابة أو API). وتُضاف قرارات الخبراء إلى النموذج كبيانات تدريب.
نعم. تُحوَّل الأسماء بالأحرف السيريلية والعربية إلى أحرف لاتينية أثناء التطبيع، ويدخل تشابه التضمين متعدد اللغات في الدرجة. ولا حاجة إلى ترجمة الاسم بأنفسكم.
يمكنكم التجربة على بيانات توضيحية بحساب sandbox.
اطلب عرض سعر
أرسل طلبك في ثلاث خطوات، ونرسل العرض إلى بريدك الإلكتروني للعمل. الطلب غير ملزم.