# Решения для описаний отелей

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

Описания отелей дают для каждого HM ID многоязычный текст, готовый к продаже. Для каждого отеля есть три версии: краткая, средняя и полная; первые языки — турецкий, английский, немецкий, русский и арабский. Тексты создаются на основе factsheet отеля и текстов поставщиков, проходят проверку редактором и передаются через API и dump-файлы.

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

- **Текст трёх длин:** Краткий текст подходит для карточки в результатах поиска, средний — для верха страницы отеля, полный — для раздела с подробностями. Обрезать текст под каждый экран отдельно не нужно.
- **Одна информация на пяти языках:** Описания на турецком, английском, немецком, русском и арабском основаны на одних и тех же проверенных данных. При выходе на новый рынок текст не нужно заказывать заново.
- **ИИ и редактор:** Черновик создаёт ИИ, редакторы проверяют точность и стиль. Время, числа и правила берутся из полей factsheet.
- **Привязка к сопоставленному отелю:** Каждое описание привязано к одному HM ID. Даже если вы смените поставщика или добавите нового, текст останется у того же отеля.

## До и после

Текст об отеле от трёх поставщиков

**supplier_descriptions.txt**

```text
[A / HTL-88213]  lang=en
Nice hotel near the beach. Great pools!! Check-in 14:00.
Great pools and great food. Close to the beach.

[B / 40917]  lang=tr
Belek'te 5 yıldızlı otel.

[C / TR-ANT-551]  lang=de
(açıklama yok)
```

Описание трёх длин под одним HM ID

**Описания отеля HM-1048213 (tr)**

```json
{
  "hm_id": "HM-1048213",
  "lang": "tr",
  "available_langs": ["tr", "en", "de", "ru", "ar"],
  "descriptions": {
    "short": "Belek'te, otele ait kum plaja 250 metre mesafede, üç açık havuzlu resort otel.",
    "medium": "Sunset Bay Resort & Spa, Antalya'nın Belek bölgesinde, otele ait kum plaja 250 metre uzaklıktadır. 412 odalı tesiste üç açık ve bir kapalı havuz bulunur.",
    "long": "Sunset Bay Resort & Spa, Belek'in sahil şeridinde yer alır. (Örnekte kısaltıldı.)"
  }
}
```

_Это пример данных; отель и коды не относятся к реальному объекту. Повторы и преувеличения убираются; расстояния и числа в тексте берутся из полей factsheet._

## Как это работает

1. **Начало с правильного отеля:** Все тексты поставщиков и данные factsheet отеля, объединённого в один HM ID при маппинге, собираются вместе.
2. **Создание черновика:** ИИ создаёт краткое, среднее и полное описание на основе данных factsheet и текстов поставщиков; повторяющиеся и противоречащие формулировки убираются.
3. **Проверка редактором:** Редакторы проверяют текст на точность и стиль. Все языки основаны на одной и той же информации.
4. **Обновление:** При изменении сведений об объекте обновляется и описание; текст не расходится с factsheet.
5. **Передача:** Описания возвращаются с эндпоинта GET /v1/hotels/{hm_id}/content по параметру языка; весь фонд поступает в ежедневных полных и delta dump-файлах.

## Пример API

**Запрос описаний на английском**

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

**200 OK**

```json
{
  "hm_id": "HM-1048213",
  "lang": "en",
  "available_langs": ["tr", "en", "de", "ru", "ar"],
  "descriptions": {
    "short": "Resort hotel in Belek, 250 m from its private sandy beach, with three outdoor pools.",
    "medium": "Sunset Bay Resort & Spa is in Belek, Antalya, 250 metres from the hotel's private sandy beach. The 412-room property has three outdoor pools and one indoor pool.",
    "long": "Sunset Bay Resort & Spa sits on the Belek coastline. (Shortened in this example.)"
  },
  "updated_at": "2026-11-02T08:14:00Z"
}
```

_Примеры кода носят иллюстративный характер; названия полей могут измениться в релизе v1._

## Какую задачу решают описания отелей?

Маппинг объединяет один и тот же отель в одном HM ID, но рекламный текст по-прежнему различается столько раз, сколько у вас поставщиков. Один поставщик присылает только английский текст с повторяющимися фразами, другой — однострочную заметку на турецком, третий вообще не присылает текст. Страница отеля меняется в зависимости от того, чей контент использован; при выходе на немецкоязычный или русскоязычный рынок текст приходится заказывать заново.

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

## Три длины, три сценария

| Версия | Формат | Где используется |
| --- | --- | --- |
| Краткая | Одно предложение | Карточка в результатах поиска, карточка на карте |
| Средняя | Один абзац | Верхняя часть страницы отеля |
| Полная | Несколько абзацев | Вкладка с подробностями: расположение, номера, питание, удобства |

Каждая версия основана на одной и той же информации. Краткий текст — не обрезанная версия полного; он пишется отдельно для своего места.

## Как готовятся тексты

Описание основано на проверенных данных, собранных из всех записей отеля у поставщиков. Время, числа, расстояния и правила берутся из полей [factsheet отеля](https://hotelmapping.org/ru/produkty/resheniya-dlya-faktshitov-oteley/). Поэтому время заезда или расстояние до пляжа в тексте не расходятся со значением в factsheet.

Черновик создаёт ИИ; повторяющиеся, преувеличенные и противоречащие друг другу формулировки убираются. Затем редакторы проверяют текст на точность и стиль. При изменении сведений об объекте обновляется и описание.

## Языки и передача

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

Описания передаются по отелям через REST API, а для всего фонда — ежедневными полными и [delta dump](https://hotelmapping.org/ru/glossariy/delta-dump/) файлами. Параметры `include` и `lang` в примере — черновик API v1; точная схема публикуется на [странице для разработчиков](https://hotelmapping.org/ru/razrabotchikam/).

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

Структурированные сведения для фильтрации и сравнения находятся в продукте [factsheet отеля](https://hotelmapping.org/ru/produkty/resheniya-dlya-faktshitov-oteley/). Фотогалерея отеля очищается от дубликатов и размечается по категориям в сервисе [фото отелей](https://hotelmapping.org/ru/produkty/resheniya-dlya-foto-oteley/). Для информации об охвате и стоимости [запросите предложение](https://hotelmapping.org/ru/zaprosit-predlozhenie/).

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

### На каких языках доступны описания отелей?

Первые языки — турецкий, английский, немецкий, русский и арабский. Все языки основаны на одних и тех же проверенных данных. График новых языков пока не определён.

### Кто пишет описания?

Текст создаёт ИИ, редакторы проверяют точность и стиль. Время, числа и правила берутся из структурированных данных factsheet.

### Чем описание отличается от factsheet?

Описание — это текст, написанный для чтения. Factsheet же передаёт время заезда и выезда, пляж, бассейн, правила для детей и другие сведения в отдельных полях для фильтрации и сравнения. Оба основаны на одних и тех же данных.

### Как передаются описания?

По отелям — через REST API, для всего фонда — ежедневными полными и delta dump-файлами. Для уведомлений об изменениях планируется webhook.

### Можно ли публиковать описания на моём сайте и в приложении?

Условия использования и лицензии на контент определяются в договоре.

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

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

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

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