حلول صور الغرف

تربط صور الغرف الصور التي يرسلها المورّدون لكل غرفة بأنواع الغرف القياسية الناتجة عن مطابقة الغرف (مثل HM-1048213-R03). وبذلك يظهر كل عرض غرفة بصور تلك الغرفة نفسها بدلًا من المعرض العام للفندق. وتُجمَّع الصورة نفسها القادمة من مورّدين مختلفين في صورة واحدة، وتعود الصور من واجهة API مع بيانات الغرفة.

ما الذي تكسبه

  • الغرفة الصحيحة، الصورة الصحيحة

    يظهر عرض الغرفة المطلة على البحر مع شرفة بصور تلك الغرفة، فلا يضطر النزيل إلى البحث عن غرفته في المعرض العام للفندق.

  • المورّدون يلتقون في نوع غرفة واحد

    تُجمع الصور التي يرسلها ثلاثة مورّدين للغرفة نفسها تحت معرّف الغرفة الواحد الذي أنشأته مطابقة الغرف.

  • النسخ المكررة في صورة واحدة

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

  • مع بيانات الغرفة

    تعود الصور في الاستجابة نفسها مع نوع الغرفة والإطلالة والسرير والسعة، فلا حاجة إلى خطوة مطابقة منفصلة.

قبل وبعد

صور غرف من ثلاثة مورّدين

supplier_room_images.csv
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-1048213
{
  "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 }]
        }
      ]
    }
  ]
}

بيانات تجريبية؛ الفندق وأسماء الغرف والرموز وعناوين الصور لا تخص منشأة حقيقية.

كيف يعمل

  1. 1

    مطابقة الغرف

    تُربط رموز غرف المورّدين عبر مطابقة الغرف بمعرّفات غرف قياسية مرتبطة برقم HM ID الخاص بالفندق.

  2. 2

    الجمع

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

  3. 3

    اكتشاف الصور المكررة

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

  4. 4

    التسليم

    تعود الصور ومجموعات النسخ ورموز غرف المورّدين في استجابة 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، وسيُنشر المخطط النهائي في صفحة المطورين. وللاطلاع على النطاق والسعر يمكنكم طلب عرض سعر.

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

مثال API

الطلب

طلب غرف فندق مع صورها
curl "https://api.hotelmapping.org/v1/hotels/HM-1048213/rooms?include=images" \
  -H "X-API-Key: $HM_API_KEY"

الاستجابة

200 OK
{
  "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.

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

هل مطابقة الغرف مطلوبة لصور الغرف؟

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

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

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

ماذا يحدث إذا لم يرسل المورّد صورة الغرفة برمز غرفة؟

تُربط صورة الغرفة بنوع الغرفة بحسب رمز الغرفة الذي أرسل به المورّد الصورة. ولا تُربط الصور القادمة بلا رمز غرفة بأي نوع غرفة، أما الصور القادمة على مستوى الفندق فتعالجها خدمة صور الفنادق.

هل تجلب صور الغرف بيانات السعر أو التوفر؟

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

اطلب عرض سعر

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

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

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