# حلول مطابقة الفنادق

> URL: https://hotelmapping.org/ar/products/hotel-mapping-solutions/ · اللغة: العربية

تجمع مطابقة الفنادق الأسماء والرموز والعناوين المختلفة التي يرسلها الموردون للفندق الواحد في هوية دائمة واحدة (HM ID). ترتبط رموز الموردين ومعرّف Google Place والإحداثيات بهذه الهوية، كما نحتفظ بمعرّفات الفنادق لدى مزوّد المطابقة الحالي أو في نظامكم الخاص كمراجع متقاطعة. وهكذا يظهر كل فندق في قائمتكم مرة واحدة فقط.

## ما الذي تكسبه

- **كل فندق مرة واحدة في القائمة:** تُجمع سجلات الفندق الواحد من موردين مختلفين في بطاقة واحدة، فيظهر أفضل عرض في مكان واحد.
- **هوية دائمة:** لا يُعاد إسناد معرّف HM ID إلى فندق آخر أبدًا. وعند دمج فندقين يُحوَّل المعرّف القديم إلى المعرّف الجديد.
- **معرّفاتكم الحالية محفوظة:** نحتفظ بمعرّفات الفنادق لدى مزوّد المطابقة الحالي أو في نظامكم الخاص كمراجع متقاطعة، فلا تفقدون ما أنجزتموه من مطابقة حتى اليوم.
- **تشغيل سريع للمورد الجديد:** يمر ملف المورد الجديد بالتطبيع وحساب الدرجات، ثم يُربط بمعرّفات HM ID خلال وقت قصير.

## قبل وبعد

سجل خام قادم من ثلاثة موردين

**supplier_static.csv**

```csv
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 واحد

**GET /v1/hotels/HM-1048213**

```json
{
  "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"
}
```

_هذه بيانات توضيحية؛ اسم الفندق والرموز لا تخص منشأة حقيقية._

## كيف يعمل

1. **استلام البيانات:** نستلم البيانات الثابتة للمورد عبر API أو CSV أو FTP. يُحفظ كل سجل بصيغته الخام وتُدار التغييرات بالإصدارات.
2. **التطبيع:** تُفصل اللواحق مثل "Hotel" و"Resort & Spa" عن اسم الفندق، وتُحوَّل الأسماء الروسية والعربية إلى أحرف لاتينية، وتُوحَّد صيغ العنوان والهاتف وعنوان الموقع الإلكتروني.
3. **توليد المرشحين وحساب الدرجات:** يُقارن كل سجل بالفنادق القريبة منه فقط. يجتمع تشابه الاسم والتضمين (embedding) متعدد اللغات والمسافة وتطابق الهاتف والموقع الإلكتروني لتعطي درجة احتمال بين 0 و1.
4. **القرار والمراجعة البشرية:** إذا بلغت الدرجة 0.97 فأكثر تتم المطابقة تلقائيًا؛ وتصل السجلات بين 0.80 و0.97 إلى خبير على شاشة مراجعة مدعومة بالخريطة؛ وما دون 0.80 يفتح معرّف HM ID جديدًا.
5. **التسليم:** تصلكم النتيجة عبر REST API وملف dump يومي كامل وآخر تفاضلي (delta) بصيغ CSV وJSON وParquet؛ أما webhook فمخطط له.

## مثال API

**من رمز المورد إلى HM ID**

```bash
curl https://api.hotelmapping.org/v1/suppliers/B/codes/40917 \
  -H "X-API-Key: $HM_API_KEY"
```

**200 OK**

```json
{
  "supplier": "B",
  "code": "40917",
  "hm_id": "HM-1048213",
  "confidence": 0.998,
  "matched_at": "2026-11-02T08:14:00Z"
}
```

_أمثلة الشيفرة توضيحية؛ وقد تتغير أسماء الحقول عند إصدار v1._

## لماذا نحتاج إلى مطابقة الفنادق؟

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

يعمل hotelmapping.org مع 3.5 مليون فندق حول العالم، ويجمع هذه السجلات في هوية دائمة واحدة هي **HM ID**. تعملون أنتم بمعرّف HM ID وحده، ونحن نتتبع الرمز الذي يستخدمه كل مورّد.

## ما الذي نربطه؟

| الحقل | الوصف |
| --- | --- |
| رموز الموردين | رمز الفندق لدى كل مورّد، مرتبط بمعرّف HM ID |
| معرّفات الفنادق الخارجية | معرّفات مزوّد المطابقة الحالي أو نظامكم الخاص؛ تُحفظ كمراجع متقاطعة إن وُجدت |
| Google Place ID | مرجع إضافي للموقع والهوية |
| الإحداثيات | خط العرض وخط الطول المختاران من سجلات الموردين (التحقق من الإحداثيات مخطط له) |
| الوجهة | تسلسل هرمي: الدولة ← المحافظة ← المنطقة ← منطقة المنتجع |

## كيف تُقاس الجودة؟

تُقاس جودة المطابقة في كل إصدار بمجموعة اختبار موسومة يدويًا. ننشر على الموقع فقط الأرقام التي تأكدت بهذا القياس؛ وتجدون القيم الحالية في [صفحة التغطية](https://hotelmapping.org/ar/coverage/).

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

### ما الفرق بين معرّف HM ID ورمز المورّد؟

رمز المورّد صالح داخل نظام ذلك المورّد فقط ويختلف من مورّد إلى آخر. أما HM ID فهو الهوية الدائمة التي نمنحها، وتجمع كل رموز الموردين للفندق نفسه.

### ماذا يحدث إذا حدثت مطابقة خاطئة؟

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

### ماذا يحدث لمعرّف HM ID إذا أُغلق الفندق أو اندمج فندقان؟

لا يُمنح HM ID لفندق آخر أبدًا. تصبح حالة الفندق المغلق "closed". وعند الدمج تصبح حالة المعرّف القديم "merged" ويشير الحقل merged_into إلى المعرّف الجديد.

### عند الانتقال من مزوّد مطابقة آخر، هل يمكننا الاستمرار في استخدام معرّفات فنادقنا الحالية؟

نعم. نحتفظ بمعرّفات الفنادق لدى مزوّد المطابقة الحالي أو في نظامكم الخاص كمراجع متقاطعة، وتعود هذه المعرّفات في استجابة API ضمن الحقل external_ids مع HM ID. وهكذا تنتقلون إلى HM ID دون التخلي عن مطابقتكم الحالية.

## منتجات ذات صلة

- [حلول مطابقة الغرف](https://hotelmapping.org/ar/products/room-mapping-solutions/)
- [حلول مطابقة أنظمة الوجبات](https://hotelmapping.org/ar/products/board-mapping-solutions/)
- [حلول Find Match API](https://hotelmapping.org/ar/products/match-api-solutions/)

## مقالات ذات صلة

- [ما هي مطابقة الفنادق (hotel mapping) وكيف تعمل؟ دليل شامل](https://hotelmapping.org/ar/guide/what-is-hotel-mapping/)
- [كلفة تكرار إدراج الفنادق على الوكالة: التحويل والإلغاء وشكاوى العملاء](https://hotelmapping.org/ar/guide/cost-of-duplicate-hotel-listings/)
- [12 سؤالًا ينبغي طرحها عند اختيار Hotel Mapping API](https://hotelmapping.org/ar/guide/12-questions-hotel-mapping-api/)
