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

> URL: https://hotelmapping.org/ru/produkty/resheniya-dlya-foto-nomerov/ · Язык: Русский

Фото номеров привязывает фотографии, которые поставщики присылают для каждого номера, к стандартным типам номеров, созданным при маппинге номеров (например, HM-1048213-R03). Так каждое предложение номера показывается со снимками именно этого номера, а не с общей галереей отеля. Одна и та же фотография от разных поставщиков группируется в одно изображение, а изображения возвращаются из API вместе с данными номера.

## Что вы получаете

- **Нужный номер — нужная фотография:** Предложение номера с видом на море и балконом показывается с фотографиями этого номера; гостю не нужно искать свой номер в общей галерее отеля.
- **Поставщики сходятся в одном типе номера:** Фотографии, которые три поставщика присылают для одного номера, собираются под единым идентификатором номера, созданным при маппинге номеров.
- **Дубли в одном изображении:** Копии одной фотографии номера, пришедшие от разных поставщиков и разных размеров, группируются под одним изображением.
- **Вместе с данными номера:** Изображения приходят в том же ответе, что и тип номера, вид, кровать и вместимость; отдельный шаг сопоставления не нужен.

## До и после

Фотографии номеров от трёх поставщиков

**supplier_room_images.csv**

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

```json
{
  "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. **Маппинг номеров:** Коды номеров поставщиков связываются через маппинг номеров со стандартными идентификаторами номеров, привязанными к HM ID отеля.
2. **Сбор:** Фотографии, которые поставщик присылает с кодом номера, собираются под стандартным идентификатором номера, с которым связан этот код.
3. **Обнаружение дублей изображений:** Для каждого изображения вычисляется отпечаток по содержимому; копии одной фотографии номера от разных поставщиков группируются в одно изображение.
4. **Передача:** Изображения, группы копий и коды номеров поставщиков возвращаются в ответе API вместе с данными номера.

## Пример API

**Запрос номеров отеля вместе с их изображениями**

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

**200 OK**

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

## Какую задачу решают фото номеров?

Когда на странице отеля перечислено пять предложений номеров, большинство систем показывает рядом с каждым одну и ту же общую галерею. Выбирая номер с видом на море и балконом, гость видит фотографию бассейна или лобби; чтобы понять, как выглядит семейный номер, ему приходится листать галерею целиком. Поставщики чаще всего присылают фотографии номеров со своими кодами номеров, но у каждого поставщика эти коды разные.

Фото номеров привязывает эти фотографии к стандартным типам номеров, которые получаются в результате [маппинга номеров](https://hotelmapping.org/ru/produkty/resheniya-dlya-mappinga-nomerov/). Поскольку «Dbl Sea View Balcony», «DZ Meerblick Balkon» и «Standart Oda Deniz Manzaralı Balkonlu» привязаны к одному идентификатору номера, фотографии всех трёх поставщиков собираются в одном номере. О том, как стандартизируются типы номеров, читайте в руководстве [что такое маппинг номеров](https://hotelmapping.org/ru/rukovodstvo/chto-takoe-mapping-nomerov/), а об общей картине — в [руководстве по маппингу отелей](https://hotelmapping.org/ru/rukovodstvo/chto-takoe-mapping-otelei/).

## Фото отелей и фото номеров

| | Фото отелей | Фото номеров |
| --- | --- | --- |
| К чему привязываются | HM ID отеля | Стандартный идентификатор номера (например, HM-1048213-R03) |
| Что включают | Фасад, лобби, бассейн, пляж, ресторан, спа, общие зоны | Фотографии этого типа номера |
| Предварительное условие | [Маппинг отелей](https://hotelmapping.org/ru/produkty/resheniya-dlya-mappinga-oteley/) | Маппинг отелей и маппинг номеров |
| Обнаружение дублей | Внутри галереи отеля | Внутри типа номера |
| Передача | Ответ с контентом отеля и dump | Ответ с данными номера |

Об общей галерее отеля см. сервис [фото отелей](https://hotelmapping.org/ru/produkty/resheniya-dlya-foto-oteley/). Когда оба сервиса используются вместе, страница отеля показывает общую галерею, а каждое предложение номера — собственные фотографии.

## Как убираются дубли?

Несколько поставщиков могут прислать одну и ту же фотографию номера другого размера или сжатия. Для каждого изображения вычисляется отпечаток по содержимому, и одинаковые кадры внутри одного типа номера группируются под одним изображением. В ответе для каждого изображения указаны число копий и код номера поставщика, от которого они пришли.

## Передача

Изображения работают на тех же HM ID и идентификаторах номеров, что и [контент отелей](https://hotelmapping.org/ru/produkty/resheniya-dlya-opisaniy-oteley/) и данные маппинга номеров. Конечная точка `GET /v1/hotels/{hm_id}/rooms?include=images` и поля ответа в примере — черновик API v1; окончательная схема будет опубликована на [странице для разработчиков](https://hotelmapping.org/ru/razrabotchikam/). Об объёме и стоимости можно [запросить предложение](https://hotelmapping.org/ru/zaprosit-predlozhenie/).

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

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

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

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

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

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

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

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

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

## Связанные продукты

- [Решения для маппинга номеров](https://hotelmapping.org/ru/produkty/resheniya-dlya-mappinga-nomerov/)
- [Решения для фото отелей](https://hotelmapping.org/ru/produkty/resheniya-dlya-foto-oteley/)
- [Решения для описаний отелей](https://hotelmapping.org/ru/produkty/resheniya-dlya-opisaniy-oteley/)

## Связанные статьи

- [Что такое маппинг номеров (сопоставление номеров)? Почему названия номеров так запутаны](https://hotelmapping.org/ru/rukovodstvo/chto-takoe-mapping-nomerov/)
- [Словарь сокращений типов номеров: SGL, DBL, TWN, TRP, SV, LV, FAM](https://hotelmapping.org/ru/rukovodstvo/sokrashcheniya-tipov-nomerov/)
- [Что такое маппинг отелей (сопоставление отелей) и как он работает? Подробное руководство](https://hotelmapping.org/ru/rukovodstvo/chto-takoe-mapping-otelei/)
