Решения для фото номеров

Фото номеров привязывает фотографии, которые поставщики присылают для каждого номера, к стандартным типам номеров, созданным при маппинге номеров (например, 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.

Часто задаваемые вопросы

Нужен ли маппинг номеров для фото номеров?

Да. Фотографии привязываются к стандартным идентификаторам номеров, созданным при маппинге номеров. Пока типы номеров не стандартизированы, фотографии, которые разные поставщики присылают для одного номера, невозможно собрать вместе.

Чем фото номеров отличаются от фото отелей?

Фото отелей — это общая галерея отеля: фасад, лобби, бассейн, пляж, ресторан, спа и общие зоны. Фото номеров — это фотографии, которые привязываются отдельно к каждому стандартному типу номера. Это два отдельных сервиса.

Что будет, если поставщик не присылает фотографию номера с кодом номера?

Фото номера привязывается к типу номера по коду номера, с которым поставщик прислал фотографию. Фотографии без кода номера ни к какому типу номера не привязываются; фотографии, пришедшие на уровне отеля, обрабатывает сервис фото отелей.

Приносят ли фото номеров данные о цене или наличии?

Нет. Фото номеров — часть статических данных номера. Цена и наличие приходят от поставщика в вашу систему; мы лишь сообщаем, к какому номеру относится предложение, и отдаём изображения этого номера.

Запросить предложение

Получите индивидуальное предложение

Отправьте запрос в три шага, и мы пришлём предложение на ваш рабочий e-mail. Запрос ни к чему не обязывает.

  1. 1 Выберите решения
  2. 2 Выберите поставщиков
  3. 3 Оставьте контактные данные