# حلول مطابقة الوجهات

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

تربط مطابقة الوجهات المواقع التي يرسلها الموردون بمستويات ورموز مختلفة في تسلسل هرمي واحد: الدولة ← المحافظة ← المنطقة ← منطقة المنتجع (تركيا ← أنطاليا ← سيريك ← بيليك). لكل عقدة هوية دائمة (مثل TR-07-SERIK-BELEK) ورموز وجهات الموردين المرتبطة بها ورموز IATA لأقرب المطارات.

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

- **البحث عن "Belek" يجلب كل فنادق بيليك:** حتى لو أرسل مورّد الفندق تحت بيليك وآخر تحت سيريك وثالث تحت أنطاليا فقط، يظهر الفندق في منطقة المنتجع الصحيحة.
- **تسلسل هرمي يوافق البنية الإدارية المحلية:** يجمع التسلسل بين البنية الإدارية للدولة من محافظات ومناطق ومناطق المنتجعات المستخدمة في السياحة. فعلاقات مثل أن كادريه تقع في منطقة بيليك وسيدا في منطقة مانافغات مسجّلة.
- **رموز الموردين في عقدة واحدة:** يُربط رمز وجهة كل مورّد بالعقدة في التسلسل مع معلومة المستوى الذي يقابله.
- **الربط بالمطارات:** تُربط كل منطقة منتجع برموز IATA لأقرب المطارات؛ فيمكن لعمليات البحث عن باقات الطيران + الفندق استخدام البيانات نفسها.

## قبل وبعد

معلومات الوجهة من ثلاثة موردين للفندق نفسه

**supplier_destinations.csv**

```csv
supplier,hotel_code,dest_code,dest_name,country,airport
A,HTL-88213,AYT-BLK,Belek,TR,AYT
B,40917,1452,Serik,Turkey,
C,TR-ANT-551,ANT,Antalya Region,TR,AYT
```

الموقع في تسلسل هرمي واحد

**GET /v1/hotels/HM-1048213 (destination)**

```json
{
  "hm_id": "HM-1048213",
  "destination_id": "TR-07-SERIK-BELEK",
  "path": [
    { "level": "country", "id": "TR", "name": "Türkiye" },
    { "level": "province", "id": "TR-07", "name": "Antalya" },
    { "level": "district", "id": "TR-07-SERIK", "name": "Serik" },
    { "level": "resort", "id": "TR-07-SERIK-BELEK", "name": "Belek" }
  ],
  "airports": ["AYT"],
  "supplier_destinations": {
    "A": { "code": "AYT-BLK", "level": "resort" },
    "B": { "code": "1452", "level": "district" },
    "C": { "code": "ANT", "level": "province" }
  }
}
```

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

## كيف يعمل

1. **جمع الرموز:** تُستلم قائمة وجهات كل مورّد وحقول الموقع في سجلات الفنادق، وتُحفظ بصيغتها الخام.
2. **تحديد المستوى:** يُحدَّد أي مستوى يقابله رمز كل مورّد: الدولة أو المحافظة أو المنطقة أو منطقة المنتجع. "Antalya Region" بمستوى المحافظة، و"Belek" بمستوى منطقة المنتجع.
3. **الربط بالتسلسل الهرمي:** يُربط الرمز بعقدة في التسلسل عبر تشابه الاسم والصيغ متعددة اللغات ومعلومات المستوى الأعلى. والروابط غير المؤكدة تذهب إلى مراجعة الخبير.
4. **تحديد موقع الفندق بدقة:** حتى لو أرسل المورّد المحافظة أو المنطقة فقط، تُحدَّد منطقة المنتجع، وهي أدنى مستوى، بإحداثيات الفندق المختارة من سجلات الموردين (التحقق من الإحداثيات مخطط له).
5. **التسليم:** يُسلَّم التسلسل الهرمي وتطابقات الرموز عبر API وملف dump يومي. وتعود في سجلات الفنادق هوية الوجهة والمسار الكامل معًا.

## مثال API

**GET /v1/destinations/{id}**

```bash
curl https://api.hotelmapping.org/v1/destinations/TR-07-SERIK-BELEK \
  -H "X-API-Key: $HM_API_KEY"
```

**200 OK**

```json
{
  "id": "TR-07-SERIK-BELEK",
  "name": "Belek",
  "level": "resort",
  "parent": "TR-07-SERIK",
  "path": ["TR", "TR-07", "TR-07-SERIK", "TR-07-SERIK-BELEK"],
  "names": { "tr": "Belek", "en": "Belek", "ru": "Белек" },
  "airports": ["AYT"],
  "supplier_codes": [
    { "supplier": "A", "code": "AYT-BLK", "level": "resort" },
    { "supplier": "D", "code": "BELEK-01", "level": "resort" }
  ]
}
```

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

## لماذا لا تتطابق الوجهات؟

يرسل الموردون الموقع بمستويات مختلفة. أحدهم يدرج فندقًا في بيليك تحت "Belek"، وآخر تحت "Serik"، وثالث تحت "Antalya" فقط. وبعضهم يستخدم رمز المطار مباشرة كوجهة. وبلا مطابقة لا يجلب البحث عن "Belek" جزءًا من الفنادق، وتعمل مرشحات المنطقة بشكل ناقص، ويظهر الفندق نفسه في مناطق مختلفة.

تربط مطابقة الوجهات كل هذه الرموز بتسلسل هرمي واحد، وتمنح كل فندق هوية وجهة واحدة. وللإطار العام راجعوا [دليل مطابقة الفنادق](https://hotelmapping.org/ar/guide/what-is-hotel-mapping/).

## التسلسل الهرمي

| المستوى | مثال | الهوية | ملاحظة |
| --- | --- | --- | --- |
| الدولة | تركيا | TR | رمز الدولة وفق ISO 3166-1 |
| المحافظة | أنطاليا | TR-07 | رمز المحافظة وفق ISO 3166-2 (رقم اللوحة) |
| المنطقة | سيريك | TR-07-SERIK | المنطقة الإدارية |
| منطقة المنتجع | بيليك | TR-07-SERIK-BELEK | اسم المنطقة المستخدم في السياحة |

## حالات صعبة شائعة

| الحالة | مثال | كيف تُحل |
| --- | --- | --- |
| اسم المنتجع يختلف عن اسم المنطقة | سيدا تقع في منطقة مانافغات | تُربط منطقة المنتجع تحت المنطقة الصحيحة |
| تجمّع سكني فرعي داخل المنطقة | كادريه تقع في منطقة بيليك | يُربط رمز "Kadriye" لدى المورّد بعقدة بيليك |
| المنطقة والمنتجع بالاسم نفسه | كمر؛ وفيها بلديبي وغوينوك وتكيروفا | تُحفظ كمر كمنطقة وكمنتجع معًا، وتُفصل المناطق الفرعية |
| أكثر من مطار لمنطقة واحدة | ألانيا: AYT وGZP | تُربط المنطقة برمزي IATA معًا |
| الرمز بمستوى المحافظة فقط | "Antalya Region" | يُحدَّد المستوى الأدنى بإحداثيات الفندق |

هوية الوجهة جزء من سجل الفندق؛ لذلك تعمل مع [مطابقة الفنادق](https://hotelmapping.org/ar/products/hotel-mapping-solutions/). ولإيجاد HM ID من الاسم والإحداثيات تستخدم [واجهة API للمطابقة](https://hotelmapping.org/ar/products/match-api-solutions/) التسلسل الهرمي نفسه. وتُنشر في [صفحة التغطية](https://hotelmapping.org/ar/coverage/) الدول التي اكتمل فيها التسلسل حتى مستوى المنطقة والمنتجع. وللمصطلحات راجعوا صفحات القاموس [HM ID](https://hotelmapping.org/ar/glossary/hm-id/) و[رمز المورّد](https://hotelmapping.org/ar/glossary/supplier-code/) و[الترميز الجغرافي](https://hotelmapping.org/ar/glossary/geocoding/).

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

### ما الفرق بين منطقة المنتجع والمنطقة الإدارية؟

المنطقة وحدة إدارية؛ أما منطقة المنتجع فهي اسم منطقة مستخدم في السياحة. بيليك منطقة منتجع تقع في منطقة سيريك الإدارية؛ وسيدا في منطقة مانافغات. يبحث الضيف عن "Belek" أو "Side"، بينما يرسل المورّد في الغالب المنطقة الإدارية أو المحافظة.

### إلى أي منطقة يقع الفندق إذا أرسل المورّد المحافظة فقط؟

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

### لماذا تُربط رموز IATA بالوجهة؟

تبدأ عمليات البحث عن باقات الطيران + الفندق بمطار الوصول. وقد تخدم منطقة منتجع واحدة أكثر من مطار؛ فمثلًا يمكن استخدام AYT وGZP معًا لألانيا. وبهذا الربط يصل البحث من المطار إلى الفنادق في تلك المنطقة.

### في أي الدول جاهزة تفاصيل المنطقة ومنطقة المنتجع؟

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

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

- [حلول مطابقة الفنادق](https://hotelmapping.org/ar/products/hotel-mapping-solutions/)
- [حلول Find Match API](https://hotelmapping.org/ar/products/match-api-solutions/)
- [حلول أوصاف الفنادق](https://hotelmapping.org/ar/products/hotel-descriptions-solutions/)

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

- [ما هي مطابقة الفنادق (hotel mapping) وكيف تعمل؟ دليل شامل](https://hotelmapping.org/ar/guide/what-is-hotel-mapping/)
- [ما هو تكامل XML للفنادق؟ الفرق بين البيانات الثابتة والديناميكية](https://hotelmapping.org/ar/guide/what-is-hotel-xml-integration/)
- [كلفة تكرار إدراج الفنادق على الوكالة: التحويل والإلغاء وشكاوى العملاء](https://hotelmapping.org/ar/guide/cost-of-duplicate-hotel-listings/)
