حلول مطابقة الغرف
تفكّك أسماء الغرف إلى النوع والفئة والإطلالة والسرير والسعة، وتجمع الغرفة الواحدة في معرّف واحد.
تربط صور الغرف الصور التي يرسلها المورّدون لكل غرفة بأنواع الغرف القياسية الناتجة عن مطابقة الغرف (مثل HM-1048213-R03). وبذلك يظهر كل عرض غرفة بصور تلك الغرفة نفسها بدلًا من المعرض العام للفندق. وتُجمَّع الصورة نفسها القادمة من مورّدين مختلفين في صورة واحدة، وتعود الصور من واجهة API مع بيانات الغرفة.
{
"hm_id": "HM-1048213",
"rooms": [
{
"room_id": "HM-1048213-R03",
"name": "Standard Double Room, Sea View, Balcony",
"images": [
{
"image_id": "HM-1048213-R03-I001",
"copies": [
{ "supplier": "A", "room_code": "DBLSV-B", "width": 1920 },
{ "supplier": "B", "room_code": "DZMB", "width": 1024 }
]
},
{
"image_id": "HM-1048213-R03-I002",
"copies": [{ "supplier": "C", "room_code": "STD-DNZ", "width": 800 }]
}
]
},
{
"room_id": "HM-1048213-R07",
"name": "Standard Family Room, Land View",
"images": [
{
"image_id": "HM-1048213-R07-I001",
"copies": [{ "supplier": "B", "room_code": "FZLS", "width": 1024 }]
}
]
}
]
} يظهر عرض الغرفة المطلة على البحر مع شرفة بصور تلك الغرفة، فلا يضطر النزيل إلى البحث عن غرفته في المعرض العام للفندق.
تُجمع الصور التي يرسلها ثلاثة مورّدين للغرفة نفسها تحت معرّف الغرفة الواحد الذي أنشأته مطابقة الغرف.
تُجمَّع نسخ صورة الغرفة نفسها القادمة من مورّدين مختلفين وبأحجام مختلفة تحت صورة واحدة.
تعود الصور في الاستجابة نفسها مع نوع الغرفة والإطلالة والسرير والسعة، فلا حاجة إلى خطوة مطابقة منفصلة.
صور غرف من ثلاثة مورّدين
supplier,hotel_code,room_code,room_name,image_url,width
A,HTL-88213,DBLSV-B,Dbl Sea View Balcony,https://img.supplier-a.example/88213/rooms/dblsv-1.jpg,1920
B,40917,DZMB,DZ Meerblick Balkon,https://cdn.supplier-b.example/40917/zimmer/dzmb_01.jpg,1024
C,TR-ANT-551,STD-DNZ,Standart Oda Deniz Manzaralı Balkonlu (2+1),https://media.supplier-c.example/551/IMG_3101.jpg,800
B,40917,FZLS,FZ Landseite,https://cdn.supplier-b.example/40917/zimmer/fzls_01.jpg,1024 صور مرتبطة بأنواع الغرف القياسية
{
"hm_id": "HM-1048213",
"rooms": [
{
"room_id": "HM-1048213-R03",
"name": "Standard Double Room, Sea View, Balcony",
"images": [
{
"image_id": "HM-1048213-R03-I001",
"copies": [
{ "supplier": "A", "room_code": "DBLSV-B", "width": 1920 },
{ "supplier": "B", "room_code": "DZMB", "width": 1024 }
]
},
{
"image_id": "HM-1048213-R03-I002",
"copies": [{ "supplier": "C", "room_code": "STD-DNZ", "width": 800 }]
}
]
},
{
"room_id": "HM-1048213-R07",
"name": "Standard Family Room, Land View",
"images": [
{
"image_id": "HM-1048213-R07-I001",
"copies": [{ "supplier": "B", "room_code": "FZLS", "width": 1024 }]
}
]
}
]
} بيانات تجريبية؛ الفندق وأسماء الغرف والرموز وعناوين الصور لا تخص منشأة حقيقية.
تُربط رموز غرف المورّدين عبر مطابقة الغرف بمعرّفات غرف قياسية مرتبطة برقم HM ID الخاص بالفندق.
تُجمع الصور التي يرسلها المورّد برمز غرفة تحت معرّف الغرفة القياسي المرتبط بذلك الرمز.
تُستخرج لكل صورة بصمة قائمة على المحتوى، وتُجمَّع نسخ صورة الغرفة نفسها القادمة من مورّدين مختلفين في صورة واحدة.
تعود الصور ومجموعات النسخ ورموز غرف المورّدين في استجابة API مع بيانات الغرفة.
حين تُعرض خمسة عروض غرف في صفحة فندق، تعرض معظم الأنظمة المعرض العام نفسه بجوار كل عرض. وبينما يختار النزيل غرفة مطلة على البحر مع شرفة يرى صورة مسبح أو ردهة، ولكي يفهم شكل الغرفة العائلية عليه أن يتصفح المعرض كله. غالبًا ما يرسل المورّدون صور الغرف برموز الغرف الخاصة بهم، لكن هذه الرموز تختلف من مورّد إلى آخر.
تربط صور الغرف هذه الصور بأنواع الغرف القياسية الناتجة عن مطابقة الغرف. ولأن “Dbl Sea View Balcony” و“DZ Meerblick Balkon” و“Standart Oda Deniz Manzaralı Balkonlu” مرتبطة بمعرّف الغرفة نفسه، تُجمع صور المورّدين الثلاثة في الغرفة نفسها. وتجدون كيفية توحيد أنواع الغرف في دليل ما هي مطابقة الغرف، والإطار العام في دليل مطابقة الفنادق.
| صور الفنادق | صور الغرف | |
|---|---|---|
| ترتبط بـ | رقم HM ID الخاص بالفندق | معرّف الغرفة القياسي (مثل HM-1048213-R03) |
| ما تتضمنه | الواجهة والردهة والمسبح والشاطئ والمطعم والسبا والمرافق المشتركة | صور نوع الغرفة ذلك |
| الشرط المسبق | مطابقة الفنادق | مطابقة الفنادق ومطابقة الغرف |
| اكتشاف التكرار | داخل معرض الفندق | داخل نوع الغرفة |
| التسليم | استجابة محتوى الفندق وملف dump | استجابة بيانات الغرف |
وللاطلاع على المعرض العام للفندق راجعوا خدمة صور الفنادق. وعند استخدام الخدمتين معًا تعرض صفحة الفندق المعرض العام، ويعرض كل عرض غرفة صوره الخاصة.
قد يرسل عدة مورّدين صورة الغرفة نفسها بأحجام أو ضغط مختلف. تُستخرج لكل صورة بصمة قائمة على المحتوى، وتُجمَّع اللقطات المتطابقة داخل نوع الغرفة نفسه تحت صورة واحدة. وتتضمن الاستجابة لكل صورة عدد نسخها ورمز غرفة المورّد الذي جاءت منه.
تعمل الصور على رقم HM ID ومعرّفات الغرف نفسها المستخدمة في محتوى الفنادق وبيانات مطابقة الغرف. ونقطة النهاية GET /v1/hotels/{hm_id}/rooms?include=images وحقول الاستجابة في المثال مسودة لواجهة API v1، وسيُنشر المخطط النهائي في صفحة المطورين. وللاطلاع على النطاق والسعر يمكنكم طلب عرض سعر.
الطلب
curl "https://api.hotelmapping.org/v1/hotels/HM-1048213/rooms?include=images" \
-H "X-API-Key: $HM_API_KEY" الاستجابة
{
"hm_id": "HM-1048213",
"rooms": [
{
"room_id": "HM-1048213-R03",
"name": "Standard Double Room, Sea View, Balcony",
"view": "sea",
"bed": "double",
"max_occupancy": 3,
"supplier_rooms": { "A": "DBLSV-B", "B": "DZMB", "C": "STD-DNZ" },
"images": [
{
"image_id": "HM-1048213-R03-I001",
"url": "https://img.supplier-a.example/88213/rooms/dblsv-1.jpg",
"width": 1920,
"copy_count": 2
},
{
"image_id": "HM-1048213-R03-I002",
"url": "https://media.supplier-c.example/551/IMG_3101.jpg",
"width": 800,
"copy_count": 1
}
]
}
]
} أمثلة الشيفرة توضيحية؛ وقد تتغير أسماء الحقول عند إصدار v1.
نعم. تُربط الصور بمعرّفات الغرف القياسية التي تنشئها مطابقة الغرف. وما لم تُوحَّد أنواع الغرف لا يمكن جمع الصور التي يرسلها مورّدون مختلفون للغرفة نفسها.
صور الفنادق هي المعرض العام للفندق: الواجهة والردهة والمسبح والشاطئ والمطعم والسبا والمرافق المشتركة. أما صور الغرف فهي صور ترتبط بكل نوع غرفة قياسي على حدة. وهما خدمتان منفصلتان.
تُربط صورة الغرفة بنوع الغرفة بحسب رمز الغرفة الذي أرسل به المورّد الصورة. ولا تُربط الصور القادمة بلا رمز غرفة بأي نوع غرفة، أما الصور القادمة على مستوى الفندق فتعالجها خدمة صور الفنادق.
لا. صور الغرف جزء من بيانات الغرف الثابتة. ويصل السعر والتوفر من المورّد إلى نظامكم، ونحن نحدد فقط الغرفة التي يخصها العرض ونقدم صور تلك الغرفة.
اطلب عرض سعر
أرسل طلبك في ثلاث خطوات، ونرسل العرض إلى بريدك الإلكتروني للعمل. الطلب غير ملزم.