Решения для маппинга отелей
Постоянный HM ID для каждого объекта; коды поставщиков и перекрёстные ID в одной записи.
Маппинг номеров (сопоставление номеров) разбирает разные названия одного и того же номера, которые присылают поставщики, на теги типа, класса, вида, кровати, особенностей и вместимости и собирает один номер под единым идентификатором, привязанным к HM ID отеля (например, 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"
}
} «DBL SV BLC», «DZ Meerblick Balkon» и «Двухместный номер с видом на море и балконом» привязываются к одному ID номера; цены сравниваются в одной строке.
Сокращения и написания названий номеров на турецком, английском, немецком и русском хранятся в словаре правил; там, где словаря недостаточно, подключается модель разметки.
Каждое название номера разбирается на шесть тегов. Фильтрация и сортировка по виду, типу кровати или вместимости не требуют отдельного разбора.
У номеров с видом на сушу и с видом на море разные теги, поэтому они остаются под разными ID и не показываются в одной строке.
Несколько названий номеров сопоставляются мгновенно одним запросом; для всего инвентаря доступны также пакетная обработка и доставка файлом.
Названия одного номера от трёх поставщиков
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) Одна запись номера, разобранная на теги
{
"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"
}
} Это пример данных; отель, названия номеров и коды не относятся к реальному объекту.
Название номера делится на слова и сокращения. Регистр, пунктуация, вместимость в скобках («2+1») и языковые различия нормализуются.
Каждая часть сопоставляется со словарём сокращений на турецком, английском, немецком и русском: «SV», «Meerblick» и «Deniz Manzaralı» попадают в один тег вида.
Части, которых нет в словаре или которые имеют несколько значений, модель разметки относит к типу, классу, виду, кровати, особенности или вместимости.
Номера, привязанные к одному HM ID, сравниваются по тегам. Названия с совпадающими тегами привязываются к одному ID номера; записи с противоречиями отправляются на ручную проверку.
Результат возвращается в ответе 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 отеля определяется с помощью маппинга отелей. Чтобы сравнение цен было корректным, вместе с номером нужен и маппинг типов питания. Термины см. на страницах глоссария: маппинг номеров и код поставщика.
Запрос
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" }
]
}' Ответ
{
"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. Запрос ни к чему не обязывает.