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

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

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

  • Текст трёх длин

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

  • Одна информация на пяти языках

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

  • ИИ и редактор

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

  • Привязка к сопоставленному отелю

    Каждое описание привязано к одному HM ID. Даже если вы смените поставщика или добавите нового, текст останется у того же отеля.

До и после

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

supplier_descriptions.txt
[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)
{
  "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. 1

    Начало с правильного отеля

    Все тексты поставщиков и данные factsheet отеля, объединённого в один HM ID при маппинге, собираются вместе.

  2. 2

    Создание черновика

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

  3. 3

    Проверка редактором

    Редакторы проверяют текст на точность и стиль. Все языки основаны на одной и той же информации.

  4. 4

    Обновление

    При изменении сведений об объекте обновляется и описание; текст не расходится с factsheet.

  5. 5

    Передача

    Описания возвращаются с эндпоинта GET /v1/hotels/{hm_id}/content по параметру языка; весь фонд поступает в ежедневных полных и delta dump-файлах.

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

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

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

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

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

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

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

Описание основано на проверенных данных, собранных из всех записей отеля у поставщиков. Время, числа, расстояния и правила берутся из полей factsheet отеля. Поэтому время заезда или расстояние до пляжа в тексте не расходятся со значением в factsheet.

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

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

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

Описания передаются по отелям через REST API, а для всего фонда — ежедневными полными и delta dump файлами. Параметры include и lang в примере — черновик API v1; точная схема публикуется на странице для разработчиков.

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

Структурированные сведения для фильтрации и сравнения находятся в продукте factsheet отеля. Фотогалерея отеля очищается от дубликатов и размечается по категориям в сервисе фото отелей. Для информации об охвате и стоимости запросите предложение.

Что такое маппинг отелей? Подробное руководство

Пример API

Запрос

Запрос описаний на английском
curl "https://api.hotelmapping.org/v1/hotels/HM-1048213/content?include=descriptions&lang=en" \
  -H "X-API-Key: $HM_API_KEY"

Ответ

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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