# Решения для фото отелей

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

Фото отелей собирает у поставщиков фотографии фасада, лобби, бассейна, пляжа, ресторана, спа и общих зон и привязывает их к 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/ru/glossariy/udalenie-dublikatov/) на уровне отелей.

Чтобы изображения попадали к нужному отелю, сначала нужен [маппинг отелей](https://hotelmapping.org/ru/produkty/resheniya-dlya-mappinga-oteley/); каждая фотография привязывается к [HM ID](https://hotelmapping.org/ru/glossariy/hm-id/) отеля. Основные понятия описаны в [руководстве по маппингу отелей](https://hotelmapping.org/ru/rukovodstvo/chto-takoe-mapping-otelei/), а стоимость дублирующихся записей — в статье [стоимость дублей отелей](https://hotelmapping.org/ru/rukovodstvo/stoimost-dublikatov-otelei/).

## Теги категорий

Каждое изображение размечается кодом категории. Коды не зависят от языка; в интерфейсе вы показываете название на своём языке.

| Категория | Код | Пример использования |
| --- | --- | --- |
| Фасад | exterior | Вкладка «Общий вид» |
| Лобби | lobby | Вкладка «Общие зоны» |
| Бассейн | pool | Вкладка «Бассейн и пляж» |
| Пляж | beach | Вкладка «Бассейн и пляж» |
| Ресторан | restaurant | Вкладка «Питание» |
| Спа | spa | Вкладка «Спа и здоровье» |
| Общая зона | common_area | Вкладка «Общие зоны» |

С помощью тегов можно также проверять нехватку изображений: если в factsheet у отеля есть пляж, а изображений с тегом пляжа нет, вы можете создать оповещение для контент-команды.

Фотографии номеров относятся не к этой галерее, а к сервису [фото номеров](https://hotelmapping.org/ru/produkty/resheniya-dlya-foto-nomerov/). Он привязывает фотографии к стандартным типам номеров.

## Что есть сегодня, что запланировано

| Функция | Статус |
| --- | --- |
| Обнаружение дублей изображений | Доступно |
| Разметка по категориям | Доступно |
| Оценка качества изображения | Запланировано |
| Выбор обложки | Запланировано |
| Многоязычный альтернативный текст | Запланировано |

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

## Передача

Изображения, группы копий и теги возвращаются в API вместе с ответом [контента отелей](https://hotelmapping.org/ru/produkty/resheniya-dlya-opisaniy-oteley/); для всего массива данных они также передаются в dump-файлах. Параметры `include` и `tag` в примере — черновик API v1. Об объёме и стоимости можно [запросить предложение](https://hotelmapping.org/ru/zaprosit-predlozhenie/).

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

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

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

### Обнаруживаются ли обрезанные копии или копии с водяным знаком?

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

### Можете ли вы обрабатывать и наши собственные изображения?

Сегодня обрабатываются изображения, полученные от поставщиков. Обработка изображений, которые загружает само агентство, пока не предлагается.

### На каком языке возвращаются теги?

В API теги возвращаются как не зависящие от языка коды (например, pool, beach); в интерфейсе вы показываете их на своём языке. Многоязычный альтернативный текст для изображений запланирован.

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

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

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

- [Стоимость дубликатов отелей для агентства: конверсия, отмены и жалобы клиентов](https://hotelmapping.org/ru/rukovodstvo/stoimost-dublikatov-otelei/)
- [Что такое маппинг отелей (сопоставление отелей) и как он работает? Подробное руководство](https://hotelmapping.org/ru/rukovodstvo/chto-takoe-mapping-otelei/)
- [Что такое XML-интеграция отелей? Статические и динамические данные](https://hotelmapping.org/ru/rukovodstvo/chto-takoe-xml-integratsiya-otelei/)
