Скоро

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

Контент номеров добавляет к каждому стандартному типу номера, возникшему при маппинге (например, HM-1048213-R03), многоязычное описание и структурированные сведения: площадь, максимум взрослых и детей, дополнительная кровать, расположение кроватей, вид и удобства номера. Гость чётко видит, что покупает. Продукт скоро будет запущен; для раннего доступа оставьте заявку на странице запроса предложения.

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

  • Привязан к нужному номеру

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

  • Пять языков контента

    Описания номеров готовятся на турецком, английском, немецком, русском и арабском.

  • Структурированные поля

    Вместимость и расположение кроватей приходят в отдельных полях; их можно сразу использовать в фильтрах и проверках размещения.

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

    Описания быстро создаются ИИ, редакторы их проверяют.

До и после

Сведения об одном номере от трёх поставщиков

supplier_room_info.csv
supplier,hotel_code,room_code,room_info
A,HTL-88213,DBLSV-B,"Sea view room, 28 m2, max 3 pax"
B,40917,DZMB,"Zimmer ca. 28 qm, Meerblick, Balkon, Klimaanlage"
C,TR-ANT-551,STD-DNZ,"Deniz manzaralı balkonlu oda, 2 yetişkin + 1 çocuk, minibar"

Контент номера под стандартным типом номера

Контент номера HM-1048213-R03
{
  "room_id": "HM-1048213-R03",
  "hm_id": "HM-1048213",
  "size_m2": 28,
  "max_adults": 2,
  "max_children": 1,
  "max_occupancy": 3,
  "extra_bed": false,
  "bed": "double",
  "view": "sea",
  "amenities": ["balcony", "air_conditioning", "minibar"],
  "description": {
    "tr": {
      "short": "Deniz manzaralı, balkonlu, 28 m² çift kişilik oda.",
      "long": "Balkondan deniz manzarası sunan oda 28 m²'dir; iki yetişkin ve bir çocuk konaklayabilir. Odada klima ve minibar bulunur."
    }
  },
  "supplier_rooms": { "A": "DBLSV-B", "B": "DZMB", "C": "STD-DNZ" }
}

Это пример данных; отель, сведения о номере и коды не относятся к реальному объекту. Названия полей — черновик API v1.

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

  1. 1

    Сопоставление типа номера

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

  2. 2

    Объединение сведений

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

  3. 3

    Написание описания

    ИИ создаёт краткое и полное описание для конкретного типа номера; редакторы проверяют его.

  4. 4

    Передача с идентификатором номера

    Контент номера приходит вместе со стандартным идентификатором номера в ответе API и в файле для массовой загрузки.

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

На экране выбора номера гость чаще всего видит только название номера и цену. Чтобы понять разницу между «стандартным» и «улучшенным» номером, сколько человек он вмещает и есть ли балкон, ему приходится читать общее описание отеля. Поставщики присылают эти сведения в разных форматах: один пишет «28 m2, max 3 pax», другой прячет площадь внутри немецкого свободного текста, третий не указывает её вовсе.

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

Строится на маппинге номеров

Контент номеров использует стандартные идентификаторы номеров, получаемые в результате маппинга номеров. Поскольку «Dbl Sea View Balcony», «DZ Meerblick Balkon» и «Standart Oda Deniz Manzaralı Balkonlu» привязаны к одному идентификатору, сведения трёх поставщиков объединяются в одном номере. О том, как стандартизируются типы номеров, читайте в руководстве что такое маппинг номеров, а общую картину — в руководстве по маппингу отелей.

Охват

Поле О чём говорит Пример
Описание номера Краткий и полный текст для конкретного типа номера TR, EN, DE, RU, AR
Площадь Размер номера 28 м²
Вместимость Максимум взрослых и детей, дополнительная кровать 2 взрослых + 1 ребёнок
Расположение кроватей Тип кровати Двуспальная, две раздельные
Вид и расположение Что видно из окна, где находится номер Вид на море, этаж с садом
Удобства номера Стандартные коды удобств Балкон, кондиционер, мини-бар

Где используется

  • Экран выбора номера: гость видит разницу между номерами по площади, виду и расположению кроватей.
  • Семейные и групповые запросы: поля вместимости позволяют правильно показать подходящие номера при запросах вроде «2 взрослых 2 ребёнка».
  • Управление ожиданиями: гость заранее видит характеристики купленного номера и не испытывает неприятных сюрпризов по приезде.

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

Ранний доступ

Для раннего доступа, информации об охвате и стоимости запросите предложение.

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

Пример API

Запрос

Черновик API v1: запрос номеров с контентом
curl "https://api.hotelmapping.org/v1/hotels/HM-1048213/rooms?include=content&lang=tr" \
  -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",
      "size_m2": 28,
      "max_adults": 2,
      "max_children": 1,
      "extra_bed": false,
      "bed": "double",
      "view": "sea",
      "amenities": ["balcony", "air_conditioning", "minibar"],
      "description": {
        "short": "Deniz manzaralı, balkonlu, 28 m² çift kişilik oda."
      }
    }
  ]
}

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

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

Когда будет запущен контент номеров?

Контент номеров скоро будет запущен; точная дата пока не объявлена. Для раннего доступа напишите нам на странице запроса предложения.

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

Да. Контент привязывается к стандартному идентификатору номера, который даёт маппинг номеров. Пока типы номеров не стандартизированы, сведения разных поставщиков нельзя объединить в одном номере.

Какие сведения входят в контент номера?

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

Откуда берутся удобства номера?

Удобства номера берутся из того же стандартного словаря, что и в продукте «Удобства отелей». Поэтому удобства типа номера и список удобств отеля используют одни и те же коды.

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

Нет. Контент номеров — это статические данные о номере. Цена и наличие приходят от поставщика в вашу систему.

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

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

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

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