حلول مطابقة الفنادق
معرّف HM ID دائم لكل منشأة، مع رموز الموردين والمعرّفات المتقاطعة في سجل واحد.
تربط مطابقة الوجهات المواقع التي يرسلها الموردون بمستويات ورموز مختلفة في تسلسل هرمي واحد: الدولة ← المحافظة ← المنطقة ← منطقة المنتجع (تركيا ← أنطاليا ← سيريك ← بيليك). لكل عقدة هوية دائمة (مثل TR-07-SERIK-BELEK) ورموز وجهات الموردين المرتبطة بها ورموز IATA لأقرب المطارات.
{
"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" }
}
} حتى لو أرسل مورّد الفندق تحت بيليك وآخر تحت سيريك وثالث تحت أنطاليا فقط، يظهر الفندق في منطقة المنتجع الصحيحة.
يجمع التسلسل بين البنية الإدارية للدولة من محافظات ومناطق ومناطق المنتجعات المستخدمة في السياحة. فعلاقات مثل أن كادريه تقع في منطقة بيليك وسيدا في منطقة مانافغات مسجّلة.
يُربط رمز وجهة كل مورّد بالعقدة في التسلسل مع معلومة المستوى الذي يقابله.
تُربط كل منطقة منتجع برموز IATA لأقرب المطارات؛ فيمكن لعمليات البحث عن باقات الطيران + الفندق استخدام البيانات نفسها.
معلومات الوجهة من ثلاثة موردين للفندق نفسه
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 الموقع في تسلسل هرمي واحد
{
"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" }
}
} هذه بيانات توضيحية؛ الفندق ورموز الموردين وهمية. أما أسماء المناطق والمطارات فحقيقية.
تُستلم قائمة وجهات كل مورّد وحقول الموقع في سجلات الفنادق، وتُحفظ بصيغتها الخام.
يُحدَّد أي مستوى يقابله رمز كل مورّد: الدولة أو المحافظة أو المنطقة أو منطقة المنتجع. "Antalya Region" بمستوى المحافظة، و"Belek" بمستوى منطقة المنتجع.
يُربط الرمز بعقدة في التسلسل عبر تشابه الاسم والصيغ متعددة اللغات ومعلومات المستوى الأعلى. والروابط غير المؤكدة تذهب إلى مراجعة الخبير.
حتى لو أرسل المورّد المحافظة أو المنطقة فقط، تُحدَّد منطقة المنتجع، وهي أدنى مستوى، بإحداثيات الفندق المختارة من سجلات الموردين (التحقق من الإحداثيات مخطط له).
يُسلَّم التسلسل الهرمي وتطابقات الرموز عبر 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 ورمز المورّد والترميز الجغرافي.
الطلب
curl https://api.hotelmapping.org/v1/destinations/TR-07-SERIK-BELEK \
-H "X-API-Key: $HM_API_KEY" الاستجابة
{
"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 عبر مطابقة الفنادق. ثم تُحدَّد المنطقة الإدارية ومنطقة المنتجع باستخدام الإحداثيات المختارة من سجلات الموردين؛ والتحقق من الإحداثيات مخطط له. ويُحفظ رمز محافظة المورّد أيضًا في السجل بشكل منفصل.
تبدأ عمليات البحث عن باقات الطيران + الفندق بمطار الوصول. وقد تخدم منطقة منتجع واحدة أكثر من مطار؛ فمثلًا يمكن استخدام AYT وGZP معًا لألانيا. وبهذا الربط يصل البحث من المطار إلى الفنادق في تلك المنطقة.
يُخطَّط لاستكمال مستوى المنطقة ومنطقة المنتجع أولًا لتركيا (أنطاليا وموغلا وإسطنبول) والإمارات ومصر. وتُنشر في صفحة التغطية الحالة الراهنة للدول التي اكتملت فيها هذه التفاصيل.
اطلب عرض سعر
أرسل طلبك في ثلاث خطوات، ونرسل العرض إلى بريدك الإلكتروني للعمل. الطلب غير ملزم.