Решения для маппинга номеров

Маппинг номеров (сопоставление номеров) разбирает разные названия одного и того же номера, которые присылают поставщики, на теги типа, класса, вида, кровати, особенностей и вместимости и собирает один номер под единым идентификатором, привязанным к HM ID отеля (например, HM-1048213-R03). Так цены разных поставщиков на один и тот же номер можно сравнивать рядом.

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

  • Один номер — одна строка

    «DBL SV BLC», «DZ Meerblick Balkon» и «Двухместный номер с видом на море и балконом» привязываются к одному ID номера; цены сравниваются в одной строке.

  • Многоязычный словарь сокращений

    Сокращения и написания названий номеров на турецком, английском, немецком и русском хранятся в словаре правил; там, где словаря недостаточно, подключается модель разметки.

  • Структурированные данные о номерах

    Каждое название номера разбирается на шесть тегов. Фильтрация и сортировка по виду, типу кровати или вместимости не требуют отдельного разбора.

  • Различия в виде и вместимости сохраняются

    У номеров с видом на сушу и с видом на море разные теги, поэтому они остаются под разными ID и не показываются в одной строке.

  • Мгновенно или пакетно

    Несколько названий номеров сопоставляются мгновенно одним запросом; для всего инвентаря доступны также пакетная обработка и доставка файлом.

До и после

Названия одного номера от трёх поставщиков

supplier_rooms.csv
supplier,hotel_code,room_code,room_name
A,HTL-88213,DBLSV-B,Dbl Sea View Balcony
B,40917,DZMB,DZ Meerblick Balkon
C,TR-ANT-551,STD-DNZ,Standart Oda Deniz Manzaralı Balkonlu (2+1)

Одна запись номера, разобранная на теги

HM-1048213-R03
{
  "room_id": "HM-1048213-R03",
  "hm_id": "HM-1048213",
  "name": "Standard Double Room, Sea View, Balcony",
  "type": "room",
  "class": "standard",
  "view": "sea",
  "bed": "double",
  "features": ["balcony"],
  "max_occupancy": 3,
  "supplier_rooms": {
    "A": "DBLSV-B",
    "B": "DZMB",
    "C": "STD-DNZ"
  }
}

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

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

  1. 1

    Разбор названия номера

    Название номера делится на слова и сокращения. Регистр, пунктуация, вместимость в скобках («2+1») и языковые различия нормализуются.

  2. 2

    Словарь правил

    Каждая часть сопоставляется со словарём сокращений на турецком, английском, немецком и русском: «SV», «Meerblick» и «Deniz Manzaralı» попадают в один тег вида.

  3. 3

    Модель разметки

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

  4. 4

    Группировка внутри отеля

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

  5. 5

    Доставка

    Результат возвращается в ответе API мгновенно, а при пакетной обработке — файлом. Каждый код номера поставщика хранится вместе с ID номера, к которому он привязан.

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

Каждый поставщик пишет название номера по правилам своей системы. Один использует сокращения («DBL SV BLC»), другой — язык каталогов немецких туроператоров («DZ Meerblick»), третий присылает турецкое название из отеля как есть. Если в отеле 10 типов номеров и 5 поставщиков, число названий для сопоставления вырастает до 50. Ручное сопоставление идёт медленно, а различие в виде или вместимости легко упустить.

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

На какие теги разбирается название номера?

Тег О чём говорит Примеры значений
Тип Категория номера Номер, сюит, джуниор-сюит, студия, семейный номер, вилла, бунгало, апартамент
Класс Уровень комфорта Эконом, стандарт, superior, deluxe
Вид Что видно из окна Море, боковой вид на море, суша, сад, бассейн
Кровать Расположение кроватей Одна кровать (single), двуспальная (double), две отдельные (twin), king, queen
Особенность Дополнительное оснащение Балкон, терраса, джакузи, выход к бассейну, смежные номера
Вместимость Максимальное число гостей SGL = 1, DBL = 2, TRP = 3, QUAD = 4; 2+1, 2+2

Словарь сокращений

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

Понятие EN DE TR RU
Одноместное размещение (вместимость 1) SGL EZ (Einzelzimmer) Tek kişilik одноместный
Двухместное размещение (вместимость 2) DBL DZ (Doppelzimmer) Çift kişilik двухместный
Две отдельные кровати (кровать: twin) TWN 2 Einzelbetten İki ayrı yataklı две кровати
Семейный номер FAM FZ (Familienzimmer) Aile odası семейный номер
Вид на море SV Meerblick Deniz manzaralı вид на море
Балкон BLC Balkon Balkonlu балкон
Сюит STE Suite Süit люкс

У большинства поставщиков DBL означает двухместный номер, но не всегда указывает тип кровати. Поэтому «DBL» сначала читается как вместимость (не менее 2 гостей). Если в названии нет TWN или «twin», тег кровати принимает значение double; если есть более явный признак, например «king», используется он. Тег типа — это категория номера: «DBL Sea View» — это номер (room), «Junior Suite» — джуниор-сюит.

Маппинг номеров работает только между номерами одного отеля, поэтому сначала HM ID отеля определяется с помощью маппинга отелей. Чтобы сравнение цен было корректным, вместе с номером нужен и маппинг типов питания. Термины см. на страницах глоссария: маппинг номеров и код поставщика.

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

Пример API

Запрос

POST /v1/rooms/map
curl -X POST https://api.hotelmapping.org/v1/rooms/map \
  -H "X-API-Key: $HM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "hm_id": "HM-1048213",
    "rooms": [
      { "supplier": "B", "code": "DZMB", "name": "DZ Meerblick Balkon" },
      { "supplier": "B", "code": "FZLS", "name": "FZ Landseite" }
    ]
  }'

Ответ

200 OK
{
  "hm_id": "HM-1048213",
  "groups": [
    {
      "room_id": "HM-1048213-R03",
      "type": "room",
      "class": "standard",
      "view": "sea",
      "bed": "double",
      "features": ["balcony"],
      "max_occupancy": 3,
      "matched": [
        { "supplier": "B", "code": "DZMB", "name": "DZ Meerblick Balkon", "confidence": 0.98, "decision": "auto_match" }
      ]
    },
    {
      "room_id": "HM-1048213-R07",
      "type": "family_room",
      "class": "standard",
      "view": "land",
      "bed": null,
      "features": [],
      "max_occupancy": 4,
      "matched": [
        { "supplier": "B", "code": "FZLS", "name": "FZ Landseite", "confidence": 0.91, "decision": "review" }
      ]
    }
  ]
}

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

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

Маппинг номеров выполняется после маппинга отелей?

Да. Названия номеров сравниваются только с номерами того же отеля. Поэтому сначала определяется HM ID отеля, а затем названия номеров поставщиков, относящиеся к этому отелю, группируются.

Что будет, если поставщик изменит название номера?

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

Что делается, если в тегах нет уверенности?

Пороговую логику маппинга отелей планируется применять и к номерам: при 0,97 и выше привязка автоматическая, диапазон 0,80–0,97 уходит к эксперту, ниже 0,80 создаётся новая запись номера. Решения экспертов возвращаются в словарь и в модель.

Названия номеров на каких языках поддерживаются?

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

Маппинг номеров возвращает данные о ценах или доступности?

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

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

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

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

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