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

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

ما الذي تكسبه

  • البحث عن "Belek" يجلب كل فنادق بيليك

    حتى لو أرسل مورّد الفندق تحت بيليك وآخر تحت سيريك وثالث تحت أنطاليا فقط، يظهر الفندق في منطقة المنتجع الصحيحة.

  • تسلسل هرمي يوافق البنية الإدارية المحلية

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

  • رموز الموردين في عقدة واحدة

    يُربط رمز وجهة كل مورّد بالعقدة في التسلسل مع معلومة المستوى الذي يقابله.

  • الربط بالمطارات

    تُربط كل منطقة منتجع برموز IATA لأقرب المطارات؛ فيمكن لعمليات البحث عن باقات الطيران + الفندق استخدام البيانات نفسها.

قبل وبعد

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

supplier_destinations.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)
{
  "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. 1

    جمع الرموز

    تُستلم قائمة وجهات كل مورّد وحقول الموقع في سجلات الفنادق، وتُحفظ بصيغتها الخام.

  2. 2

    تحديد المستوى

    يُحدَّد أي مستوى يقابله رمز كل مورّد: الدولة أو المحافظة أو المنطقة أو منطقة المنتجع. "Antalya Region" بمستوى المحافظة، و"Belek" بمستوى منطقة المنتجع.

  3. 3

    الربط بالتسلسل الهرمي

    يُربط الرمز بعقدة في التسلسل عبر تشابه الاسم والصيغ متعددة اللغات ومعلومات المستوى الأعلى. والروابط غير المؤكدة تذهب إلى مراجعة الخبير.

  4. 4

    تحديد موقع الفندق بدقة

    حتى لو أرسل المورّد المحافظة أو المنطقة فقط، تُحدَّد منطقة المنتجع، وهي أدنى مستوى، بإحداثيات الفندق المختارة من سجلات الموردين (التحقق من الإحداثيات مخطط له).

  5. 5

    التسليم

    يُسلَّم التسلسل الهرمي وتطابقات الرموز عبر API وملف dump يومي. وتعود في سجلات الفنادق هوية الوجهة والمسار الكامل معًا.

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

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

تربط مطابقة الوجهات كل هذه الرموز بتسلسل هرمي واحد، وتمنح كل فندق هوية وجهة واحدة. وللإطار العام راجعوا دليل مطابقة الفنادق.

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

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

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

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

هوية الوجهة جزء من سجل الفندق؛ لذلك تعمل مع مطابقة الفنادق. ولإيجاد HM ID من الاسم والإحداثيات تستخدم واجهة API للمطابقة التسلسل الهرمي نفسه. وتُنشر في صفحة التغطية الدول التي اكتمل فيها التسلسل حتى مستوى المنطقة والمنتجع. وللمصطلحات راجعوا صفحات القاموس HM ID ورمز المورّد والترميز الجغرافي.

ما هي مطابقة الفنادق؟ الدليل الشامل

مثال API

الطلب

GET /v1/destinations/{id}
curl https://api.hotelmapping.org/v1/destinations/TR-07-SERIK-BELEK \
  -H "X-API-Key: $HM_API_KEY"

الاستجابة

200 OK
{
  "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" أو "Side"، بينما يرسل المورّد في الغالب المنطقة الإدارية أو المحافظة.

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

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

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

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

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

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

اطلب عرض سعر

احصل على عرض سعر مخصص

أرسل طلبك في ثلاث خطوات، ونرسل العرض إلى بريدك الإلكتروني للعمل. الطلب غير ملزم.

  1. 1 اختر الحلول
  2. 2 اختر الموردين
  3. 3 اترك بيانات الاتصال