حلول صور الغرف
تربط صور الغرف بأنواع الغرف القياسية؛ يظهر كل عرض غرفة بصوره الخاصة وتُدمج النسخ المكررة في صورة واحدة.
تجمع صور الفنادق من المورّدين صور الواجهة والردهة والمسبح والشاطئ والمطعم والسبا والمرافق المشتركة، وتربطها برقم HM ID الخاص بالفندق. تُجمَّع النسخ المتعددة للصورة نفسها القادمة من مورّدين مختلفين في صورة واحدة، وتُوسَم كل صورة بفئتها، ويُسلَّم المعرض عبر واجهة API وملفات dump.
{
"hm_id": "HM-1048213",
"images_in": 5,
"images_unique": 3,
"images": [
{
"image_id": "HM-1048213-I001",
"tags": ["pool"],
"copies": [
{ "supplier": "A", "width": 1920 },
{ "supplier": "B", "width": 1024 },
{ "supplier": "C", "width": 800 }
]
},
{
"image_id": "HM-1048213-I002",
"tags": ["beach"],
"copies": [{ "supplier": "A", "width": 1920 }]
},
{
"image_id": "HM-1048213-I003",
"tags": ["lobby"],
"copies": [{ "supplier": "C", "width": 800 }]
}
]
} تندمج نسخ الصورة نفسها القادمة بأحجام أو ضغط مختلف في صورة واحدة، فلا يعرض المعرض لقطة المسبح نفسها ثلاث مرات.
تُوسَم كل صورة بفئة مثل الواجهة أو الردهة أو المسبح أو الشاطئ أو المطعم أو السبا أو المرافق المشتركة، وتبنون بهذه الوسوم معرضًا بعلامات تبويب.
ترتبط الصور بسجل الفندق المطابَق، وحتى لو تغيّر مورّد أو أُضيف مورّد جديد يبقى المعرض مع الفندق نفسه.
بدلًا من مقارنة الصور واحدة تلو الأخرى، يتسلم فريق المحتوى مجموعات التكرار والفئات جاهزة.
خمس صور فندقية من ثلاثة مورّدين
supplier,hotel_code,image_url,width
A,HTL-88213,https://img.supplier-a.example/88213/pool.jpg,1920
B,40917,https://cdn.supplier-b.example/40917/pool_main.jpg,1024
C,TR-ANT-551,https://media.supplier-c.example/551/IMG_2231.jpg,800
A,HTL-88213,https://img.supplier-a.example/88213/beach.jpg,1920
C,TR-ANT-551,https://media.supplier-c.example/551/IMG_2240.jpg,800 ثلاث صور بلا تكرار ومصنّفة
{
"hm_id": "HM-1048213",
"images_in": 5,
"images_unique": 3,
"images": [
{
"image_id": "HM-1048213-I001",
"tags": ["pool"],
"copies": [
{ "supplier": "A", "width": 1920 },
{ "supplier": "B", "width": 1024 },
{ "supplier": "C", "width": 800 }
]
},
{
"image_id": "HM-1048213-I002",
"tags": ["beach"],
"copies": [{ "supplier": "A", "width": 1920 }]
},
{
"image_id": "HM-1048213-I003",
"tags": ["lobby"],
"copies": [{ "supplier": "C", "width": 800 }]
}
]
} بيانات تجريبية؛ الفندق والرموز وعناوين الصور غير حقيقية. يُخطَّط لتقييم جودة الصور واختيار صورة الغلاف.
تُجمع صور الفندق التي يرسلها المورّدون تحت رقم HM ID الذي حدّدته مطابقة الفنادق.
تُستخرج لكل صورة بصمة قائمة على المحتوى، وتُجمَّع اللقطة نفسها القادمة بحجم أو ضغط مختلف تحت صورة واحدة.
يمنح نموذج تصنيف الصور كل صورة وسم فئة مثل الواجهة أو الردهة أو المسبح أو الشاطئ أو المطعم أو السبا أو المرافق المشتركة.
تعود الصور بلا تكرار ومجموعات النسخ والوسوم مع رقم HM ID الخاص بالفندق في استجابة API وفي ملفات dump.
تتلقى الوكالة التي تعمل مع عدة مورّدين صورًا كثيرة للفندق نفسه. بعضها نسخ من اللقطة نفسها بأحجام أو ضغط مختلف. وحين تظهر صورة المسبح نفسها ثلاث مرات في المعرض، تبدو الصفحة غير مرتبة وتثقل بلا داعٍ. وإزالة التكرار بين الصور هي الجانب البصري من تنظيف التكرار على مستوى الفندق.
ولكي تُربط الصور بالفندق الصحيح تأتي مطابقة الفنادق أولًا، وتُربط كل صورة برقم HM ID الخاص بالفندق. ستجدون المفاهيم الأساسية في دليل مطابقة الفنادق، وتكلفة السجلات المكررة في مقال تكلفة الفنادق المكررة.
تُوسَم كل صورة برمز فئة. الرموز مستقلة عن اللغة، وتعرضون في الواجهة العنوان بلغتكم.
| الفئة | الرمز | مثال على الاستخدام |
|---|---|---|
| الواجهة | exterior | تبويب «نظرة عامة» |
| الردهة | lobby | تبويب «المرافق المشتركة» |
| المسبح | pool | تبويب «المسبح والشاطئ» |
| الشاطئ | beach | تبويب «المسبح والشاطئ» |
| المطعم | restaurant | تبويب «المأكولات والمشروبات» |
| السبا | spa | تبويب «السبا والعافية» |
| المرافق المشتركة | common_area | تبويب «المرافق المشتركة» |
وتتيح الوسوم أيضًا التحقق من الصور الناقصة: إذا كان لفندق شاطئ في صحيفة بياناته ولا توجد صورة موسومة بالشاطئ، يمكنكم توليد تنبيه لفريق المحتوى.
أما صور الغرف فلا تنتمي إلى هذا المعرض، بل إلى خدمة صور الغرف، وهي تربط الصور بأنواع الغرف القياسية.
| الميزة | الحالة |
|---|---|
| اكتشاف الصور المكررة | متاحة |
| الوسم بالفئات | متاحة |
| درجة جودة الصورة | قيد التخطيط |
| اختيار صورة الغلاف | قيد التخطيط |
| نص بديل متعدد اللغات | قيد التخطيط |
لا نقيّم في هذا الإصدار الصور الضبابية أو منخفضة الدقة، ولا نختار صورة غلاف للفندق، ولا نكتب نصًا بديلًا للصور. وفي هذه المرحلة تختارون صورة الغلاف بأنفسكم.
تعود الصور ومجموعات النسخ والوسوم في واجهة API مع استجابة محتوى الفنادق، وتُسلَّم أيضًا في ملفات dump للمخزون كاملًا. المعاملان include وtag في المثال مسودة لواجهة API v1. وللاطلاع على النطاق والسعر يمكنكم طلب عرض سعر.
الطلب
curl "https://api.hotelmapping.org/v1/hotels/HM-1048213/content?include=images&tag=pool" \
-H "X-API-Key: $HM_API_KEY" الاستجابة
{
"hm_id": "HM-1048213",
"images": [
{
"image_id": "HM-1048213-I001",
"tags": ["pool"],
"url": "https://img.supplier-a.example/88213/pool.jpg",
"width": 1920,
"copy_count": 3
}
]
} أمثلة الشيفرة توضيحية؛ وقد تتغير أسماء الحقول عند إصدار v1.
صور الفنادق هي المعرض العام للفندق: الواجهة والردهة والمسبح والشاطئ والمطعم والسبا والمرافق المشتركة. أما صور الغرف فهي صور ترتبط بكل نوع غرفة قياسي على حدة، وهي خدمة منفصلة.
النسخ القادمة بأحجام وضغط مختلف ضمن النطاق الحالي. أما مدى التقاط النسخ المقصوصة أو التي تحمل علامة مائية فسيُعرض مع نتائج الاختبار.
تُعالَج اليوم الصور القادمة من المورّدين. أما معالجة الصور التي ترفعها الوكالة بنفسها فلا تُقدَّم بعد.
في واجهة API تعود الوسوم برموز مستقلة عن اللغة (مثل pool وbeach)، وتعرضونها في الواجهة بلغتكم. ويُخطَّط لنص بديل متعدد اللغات للصور.
اطلب عرض سعر
أرسل طلبك في ثلاث خطوات، ونرسل العرض إلى بريدك الإلكتروني للعمل. الطلب غير ملزم.