Решения для маппинга номеров
Разбирает названия номеров на тип, класс, вид, кровать и вместимость; один номер — один ID.
Маппинг отелей (сопоставление) объединяет разные названия, коды и адреса, которые поставщики присылают об одном и том же отеле, в единый постоянный идентификатор (HM ID). К этому идентификатору привязываются коды поставщиков, Google Place ID и координаты; ID отелей вашего текущего провайдера маппинга или собственной системы хранятся как перекрёстные ссылки. Так каждый отель появляется в вашей выдаче только один раз.
{
"hm_id": "HM-1048213",
"name": "Sunset Bay Resort & Spa",
"destination_id": "TR-07-SERIK-BELEK",
"destination": ["TR", "Antalya", "Serik", "Belek"],
"geo": { "lat": 36.8541, "lng": 31.0552 },
"supplier_codes": {
"A": "HTL-88213",
"B": "40917",
"C": "TR-ANT-551"
},
"external_ids": { "client": "OTL-2231" },
"status": "active"
} Записи одного отеля от разных поставщиков собираются в одну карточку; лучшее предложение видно в одном месте.
HM ID никогда не присваивается другому отелю повторно. При слиянии отелей старый ID перенаправляется на новый.
Мы храним ID отелей вашего текущего провайдера маппинга или собственной системы как перекрёстные ссылки, поэтому проделанная ранее работа по сопоставлению не теряется.
Файл нового поставщика проходит нормализацию и оценку и в короткий срок привязывается к HM ID.
Сырые записи от трёх поставщиков
supplier,code,name,city,lat,lng
A,HTL-88213,Sunset Bay Resort & Spa,Belek,36.8541,31.0552
B,40917,SUNSET BAY RESORT SPA,Serik,36.8543,31.0549
C,TR-ANT-551,Sunset Bay Rsrt. & Spa - Adults,Antalya,36.8539,31.0556 Стандартная запись под единым HM ID
{
"hm_id": "HM-1048213",
"name": "Sunset Bay Resort & Spa",
"destination_id": "TR-07-SERIK-BELEK",
"destination": ["TR", "Antalya", "Serik", "Belek"],
"geo": { "lat": 36.8541, "lng": 31.0552 },
"supplier_codes": {
"A": "HTL-88213",
"B": "40917",
"C": "TR-ANT-551"
},
"external_ids": { "client": "OTL-2231" },
"status": "active"
} Это пример данных; название отеля и коды не относятся к реальному объекту.
Мы получаем статические данные поставщика через API, CSV или FTP. Каждая запись хранится в исходном виде, изменения версионируются.
Из названия отеля выделяются приставки и суффиксы вроде «Hotel» и «Resort & Spa»; русские и арабские названия транслитерируются в латиницу; адрес, телефон и веб-адрес приводятся к стандартному формату.
Каждая запись сравнивается только с ближайшими отелями. Сходство названий, многоязычные эмбеддинги, расстояние, совпадение телефона и сайта объединяются в оценку вероятности от 0 до 1.
При оценке 0,97 и выше совпадение подтверждается автоматически; записи в диапазоне 0,80–0,97 попадают к эксперту на экран проверки с картой; при оценке ниже 0,80 создаётся новый HM ID.
Результат доступен через REST API, ежедневные полные и дельта-dump (CSV, JSON, Parquet); webhook планируется.
Типичное агентство работает сразу с несколькими поставщиками, и каждый поставщик присылает один и тот же отель под своим названием, своим кодом и своими координатами. Без сопоставления один отель несколько раз попадает в выдачу, сравнение цен нарушается, а клиент не понимает, какая карточка верна.
hotelmapping.org работает с 3,5 млн отелей по всему миру и объединяет эти записи в единый постоянный идентификатор — HM ID. Вы работаете только с HM ID, а какой поставщик какой код использует, отслеживаем мы.
| Поле | Описание |
|---|---|
| Коды поставщиков | Код отеля у каждого поставщика, привязанный к HM ID |
| Внешние ID отелей | ID вашего текущего провайдера маппинга или собственной системы; при наличии хранятся как перекрёстные ссылки |
| Google Place ID | Дополнительная ссылка для определения местоположения и идентификации |
| Координаты | Широта и долгота, выбранные из записей поставщиков (проверка координат планируется) |
| Направление | Иерархия страна → провинция → район → курортная зона |
Качество сопоставления измеряется в каждой версии на вручную размеченном тестовом наборе. На сайте мы публикуем только те цифры, которые подтверждены таким измерением; актуальные значения приведены на странице покрытия.
Запрос
curl https://api.hotelmapping.org/v1/suppliers/B/codes/40917 \
-H "X-API-Key: $HM_API_KEY" Ответ
{
"supplier": "B",
"code": "40917",
"hm_id": "HM-1048213",
"confidence": 0.998,
"matched_at": "2026-11-02T08:14:00Z"
} Примеры кода носят иллюстративный характер; названия полей могут измениться в релизе v1.
Код поставщика действует только в системе этого поставщика и у каждого свой. HM ID — это постоянный идентификатор, который присваиваем мы и который объединяет все коды поставщиков одного и того же отеля.
Оценки, в которых нет уверенности, не подтверждаются автоматически, а передаются на ручную проверку. Если вы сообщите об ошибке, запись будет исправлена, а это решение добавится в обучающие данные модели.
HM ID никогда не присваивается другому отелю. Статус закрывшегося отеля меняется на «closed». При слиянии у старого ID статус становится «merged», а поле merged_into указывает на новый ID.
Да. Мы храним ID отелей вашего текущего провайдера маппинга или собственной системы как перекрёстные ссылки; они возвращаются в ответе API в поле external_ids вместе с HM ID. Так вы можете перейти на HM ID, не отказываясь от уже выполненного сопоставления.
Запросить предложение
Отправьте запрос в три шага, и мы пришлём предложение на ваш рабочий e-mail. Запрос ни к чему не обязывает.