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

Маппинг отелей (сопоставление) объединяет разные названия, коды и адреса, которые поставщики присылают об одном и том же отеле, в единый постоянный идентификатор (HM ID). К этому идентификатору привязываются коды поставщиков, Google Place ID и координаты; ID отелей вашего текущего провайдера маппинга или собственной системы хранятся как перекрёстные ссылки. Так каждый отель появляется в вашей выдаче только один раз.

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

  • Каждый отель в выдаче один раз

    Записи одного отеля от разных поставщиков собираются в одну карточку; лучшее предложение видно в одном месте.

  • Постоянный идентификатор

    HM ID никогда не присваивается другому отелю повторно. При слиянии отелей старый ID перенаправляется на новый.

  • Ваши текущие ID сохраняются

    Мы храним ID отелей вашего текущего провайдера маппинга или собственной системы как перекрёстные ссылки, поэтому проделанная ранее работа по сопоставлению не теряется.

  • Быстрое подключение нового поставщика

    Файл нового поставщика проходит нормализацию и оценку и в короткий срок привязывается к HM ID.

До и после

Сырые записи от трёх поставщиков

supplier_static.csv
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

GET /v1/hotels/HM-1048213
{
  "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"
}

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

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

  1. 1

    Получение данных

    Мы получаем статические данные поставщика через API, CSV или FTP. Каждая запись хранится в исходном виде, изменения версионируются.

  2. 2

    Нормализация

    Из названия отеля выделяются приставки и суффиксы вроде «Hotel» и «Resort & Spa»; русские и арабские названия транслитерируются в латиницу; адрес, телефон и веб-адрес приводятся к стандартному формату.

  3. 3

    Поиск кандидатов и оценка

    Каждая запись сравнивается только с ближайшими отелями. Сходство названий, многоязычные эмбеддинги, расстояние, совпадение телефона и сайта объединяются в оценку вероятности от 0 до 1.

  4. 4

    Решение и ручная проверка

    При оценке 0,97 и выше совпадение подтверждается автоматически; записи в диапазоне 0,80–0,97 попадают к эксперту на экран проверки с картой; при оценке ниже 0,80 создаётся новый HM ID.

  5. 5

    Доставка

    Результат доступен через REST API, ежедневные полные и дельта-dump (CSV, JSON, Parquet); webhook планируется.

Зачем нужен маппинг отелей?

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

hotelmapping.org работает с 3,5 млн отелей по всему миру и объединяет эти записи в единый постоянный идентификатор — HM ID. Вы работаете только с HM ID, а какой поставщик какой код использует, отслеживаем мы.

Что мы связываем?

Поле Описание
Коды поставщиков Код отеля у каждого поставщика, привязанный к HM ID
Внешние ID отелей ID вашего текущего провайдера маппинга или собственной системы; при наличии хранятся как перекрёстные ссылки
Google Place ID Дополнительная ссылка для определения местоположения и идентификации
Координаты Широта и долгота, выбранные из записей поставщиков (проверка координат планируется)
Направление Иерархия страна → провинция → район → курортная зона

Как измеряется качество?

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

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

Пример API

Запрос

От кода поставщика к HM ID
curl https://api.hotelmapping.org/v1/suppliers/B/codes/40917 \
  -H "X-API-Key: $HM_API_KEY"

Ответ

200 OK
{
  "supplier": "B",
  "code": "40917",
  "hm_id": "HM-1048213",
  "confidence": 0.998,
  "matched_at": "2026-11-02T08:14:00Z"
}

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

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

Чем HM ID отличается от кода поставщика?

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

Что происходит при ошибочном сопоставлении?

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

Что станет с HM ID, если отель закроется или два отеля объединятся?

HM ID никогда не присваивается другому отелю. Статус закрывшегося отеля меняется на «closed». При слиянии у старого ID статус становится «merged», а поле merged_into указывает на новый ID.

Можем ли мы продолжать использовать наши ID отелей при переходе от другого провайдера маппинга?

Да. Мы храним ID отелей вашего текущего провайдера маппинга или собственной системы как перекрёстные ссылки; они возвращаются в ответе API в поле external_ids вместе с HM ID. Так вы можете перейти на HM ID, не отказываясь от уже выполненного сопоставления.

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

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

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

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