# حلول صور الفنادق

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

تجمع صور الفنادق من المورّدين صور الواجهة والردهة والمسبح والشاطئ والمطعم والسبا والمرافق المشتركة، وتربطها برقم HM ID الخاص بالفندق. تُجمَّع النسخ المتعددة للصورة نفسها القادمة من مورّدين مختلفين في صورة واحدة، وتُوسَم كل صورة بفئتها، ويُسلَّم المعرض عبر واجهة API وملفات dump.

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

- **معرض لا يكرر نفسه:** تندمج نسخ الصورة نفسها القادمة بأحجام أو ضغط مختلف في صورة واحدة، فلا يعرض المعرض لقطة المسبح نفسها ثلاث مرات.
- **معرض منظم حسب الفئة:** تُوسَم كل صورة بفئة مثل الواجهة أو الردهة أو المسبح أو الشاطئ أو المطعم أو السبا أو المرافق المشتركة، وتبنون بهذه الوسوم معرضًا بعلامات تبويب.
- **مرتبط برقم HM ID:** ترتبط الصور بسجل الفندق المطابَق، وحتى لو تغيّر مورّد أو أُضيف مورّد جديد يبقى المعرض مع الفندق نفسه.
- **فرز يدوي أقل:** بدلًا من مقارنة الصور واحدة تلو الأخرى، يتسلم فريق المحتوى مجموعات التكرار والفئات جاهزة.

## قبل وبعد

خمس صور فندقية من ثلاثة مورّدين

**supplier_hotel_images.csv**

```csv
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-1048213**

```json
{
  "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 }]
    }
  ]
}
```

_بيانات تجريبية؛ الفندق والرموز وعناوين الصور غير حقيقية. يُخطَّط لتقييم جودة الصور واختيار صورة الغلاف._

## كيف يعمل

1. **الجمع:** تُجمع صور الفندق التي يرسلها المورّدون تحت رقم HM ID الذي حدّدته مطابقة الفنادق.
2. **اكتشاف الصور المكررة:** تُستخرج لكل صورة بصمة قائمة على المحتوى، وتُجمَّع اللقطة نفسها القادمة بحجم أو ضغط مختلف تحت صورة واحدة.
3. **الوسم بالفئات:** يمنح نموذج تصنيف الصور كل صورة وسم فئة مثل الواجهة أو الردهة أو المسبح أو الشاطئ أو المطعم أو السبا أو المرافق المشتركة.
4. **التسليم:** تعود الصور بلا تكرار ومجموعات النسخ والوسوم مع رقم HM ID الخاص بالفندق في استجابة API وفي ملفات dump.

## مثال API

**طلب صور الفندق الموسومة بـ pool**

```bash
curl "https://api.hotelmapping.org/v1/hotels/HM-1048213/content?include=images&tag=pool" \
  -H "X-API-Key: $HM_API_KEY"
```

**200 OK**

```json
{
  "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._

## ما المشكلة التي تحلها صور الفنادق؟

تتلقى الوكالة التي تعمل مع عدة مورّدين صورًا كثيرة للفندق نفسه. بعضها نسخ من اللقطة نفسها بأحجام أو ضغط مختلف. وحين تظهر صورة المسبح نفسها ثلاث مرات في المعرض، تبدو الصفحة غير مرتبة وتثقل بلا داعٍ. وإزالة التكرار بين الصور هي الجانب البصري من [تنظيف التكرار](https://hotelmapping.org/ar/glossary/deduplication/) على مستوى الفندق.

ولكي تُربط الصور بالفندق الصحيح تأتي [مطابقة الفنادق](https://hotelmapping.org/ar/products/hotel-mapping-solutions/) أولًا، وتُربط كل صورة برقم [HM ID](https://hotelmapping.org/ar/glossary/hm-id/) الخاص بالفندق. ستجدون المفاهيم الأساسية في [دليل مطابقة الفنادق](https://hotelmapping.org/ar/guide/what-is-hotel-mapping/)، وتكلفة السجلات المكررة في مقال [تكلفة الفنادق المكررة](https://hotelmapping.org/ar/guide/cost-of-duplicate-hotel-listings/).

## وسوم الفئات

تُوسَم كل صورة برمز فئة. الرموز مستقلة عن اللغة، وتعرضون في الواجهة العنوان بلغتكم.

| الفئة | الرمز | مثال على الاستخدام |
| --- | --- | --- |
| الواجهة | exterior | تبويب «نظرة عامة» |
| الردهة | lobby | تبويب «المرافق المشتركة» |
| المسبح | pool | تبويب «المسبح والشاطئ» |
| الشاطئ | beach | تبويب «المسبح والشاطئ» |
| المطعم | restaurant | تبويب «المأكولات والمشروبات» |
| السبا | spa | تبويب «السبا والعافية» |
| المرافق المشتركة | common_area | تبويب «المرافق المشتركة» |

وتتيح الوسوم أيضًا التحقق من الصور الناقصة: إذا كان لفندق شاطئ في صحيفة بياناته ولا توجد صورة موسومة بالشاطئ، يمكنكم توليد تنبيه لفريق المحتوى.

أما صور الغرف فلا تنتمي إلى هذا المعرض، بل إلى خدمة [صور الغرف](https://hotelmapping.org/ar/products/room-images-solutions/)، وهي تربط الصور بأنواع الغرف القياسية.

## ما المتاح اليوم وما المخطَّط له؟

| الميزة | الحالة |
| --- | --- |
| اكتشاف الصور المكررة | متاحة |
| الوسم بالفئات | متاحة |
| درجة جودة الصورة | قيد التخطيط |
| اختيار صورة الغلاف | قيد التخطيط |
| نص بديل متعدد اللغات | قيد التخطيط |

لا نقيّم في هذا الإصدار الصور الضبابية أو منخفضة الدقة، ولا نختار صورة غلاف للفندق، ولا نكتب نصًا بديلًا للصور. وفي هذه المرحلة تختارون صورة الغلاف بأنفسكم.

## التسليم

تعود الصور ومجموعات النسخ والوسوم في واجهة API مع استجابة [محتوى الفنادق](https://hotelmapping.org/ar/products/hotel-descriptions-solutions/)، وتُسلَّم أيضًا في ملفات dump للمخزون كاملًا. المعاملان `include` و`tag` في المثال مسودة لواجهة API v1. وللاطلاع على النطاق والسعر يمكنكم [طلب عرض سعر](https://hotelmapping.org/ar/get-a-quote/).

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

### ما الفرق بين صور الفنادق وصور الغرف؟

صور الفنادق هي المعرض العام للفندق: الواجهة والردهة والمسبح والشاطئ والمطعم والسبا والمرافق المشتركة. أما صور الغرف فهي صور ترتبط بكل نوع غرفة قياسي على حدة، وهي خدمة منفصلة.

### هل تُكتشف النسخ المقصوصة أو التي تحمل علامة مائية؟

النسخ القادمة بأحجام وضغط مختلف ضمن النطاق الحالي. أما مدى التقاط النسخ المقصوصة أو التي تحمل علامة مائية فسيُعرض مع نتائج الاختبار.

### هل يمكنكم معالجة صورنا الخاصة أيضًا؟

تُعالَج اليوم الصور القادمة من المورّدين. أما معالجة الصور التي ترفعها الوكالة بنفسها فلا تُقدَّم بعد.

### بأي لغة تعود الوسوم؟

في واجهة API تعود الوسوم برموز مستقلة عن اللغة (مثل pool وbeach)، وتعرضونها في الواجهة بلغتكم. ويُخطَّط لنص بديل متعدد اللغات للصور.

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

- [حلول صور الغرف](https://hotelmapping.org/ar/products/room-images-solutions/)
- [حلول أوصاف الفنادق](https://hotelmapping.org/ar/products/hotel-descriptions-solutions/)
- [حلول مطابقة الفنادق](https://hotelmapping.org/ar/products/hotel-mapping-solutions/)

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

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