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

> URL: https://hotelmapping.org/ru/produkty/resheniya-dlya-mappinga-oteley/ · Язык: Русский

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

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

- **Каждый отель в выдаче один раз:** Записи одного отеля от разных поставщиков собираются в одну карточку; лучшее предложение видно в одном месте.
- **Постоянный идентификатор:** HM ID никогда не присваивается другому отелю повторно. При слиянии отелей старый ID перенаправляется на новый.
- **Ваши текущие ID сохраняются:** Мы храним ID отелей вашего текущего провайдера маппинга или собственной системы как перекрёстные ссылки, поэтому проделанная ранее работа по сопоставлению не теряется.
- **Быстрое подключение нового поставщика:** Файл нового поставщика проходит нормализацию и оценку и в короткий срок привязывается к HM ID.

## До и после

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

**supplier_static.csv**

```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**

```json
{
  "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. **Получение данных:** Мы получаем статические данные поставщика через API, CSV или FTP. Каждая запись хранится в исходном виде, изменения версионируются.
2. **Нормализация:** Из названия отеля выделяются приставки и суффиксы вроде «Hotel» и «Resort & Spa»; русские и арабские названия транслитерируются в латиницу; адрес, телефон и веб-адрес приводятся к стандартному формату.
3. **Поиск кандидатов и оценка:** Каждая запись сравнивается только с ближайшими отелями. Сходство названий, многоязычные эмбеддинги, расстояние, совпадение телефона и сайта объединяются в оценку вероятности от 0 до 1.
4. **Решение и ручная проверка:** При оценке 0,97 и выше совпадение подтверждается автоматически; записи в диапазоне 0,80–0,97 попадают к эксперту на экран проверки с картой; при оценке ниже 0,80 создаётся новый HM ID.
5. **Доставка:** Результат доступен через REST API, ежедневные полные и дельта-dump (CSV, JSON, Parquet); webhook планируется.

## Пример API

**От кода поставщика к HM ID**

```bash
curl https://api.hotelmapping.org/v1/suppliers/B/codes/40917 \
  -H "X-API-Key: $HM_API_KEY"
```

**200 OK**

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

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

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

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

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

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

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

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

Качество сопоставления измеряется в каждой версии на вручную размеченном тестовом наборе. На сайте мы публикуем только те цифры, которые подтверждены таким измерением; актуальные значения приведены на [странице покрытия](https://hotelmapping.org/ru/pokrytie/).

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

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

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

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

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

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

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

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

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

## Связанные продукты

- [Решения для маппинга номеров](https://hotelmapping.org/ru/produkty/resheniya-dlya-mappinga-nomerov/)
- [Решения для маппинга типов питания](https://hotelmapping.org/ru/produkty/resheniya-dlya-mappinga-tipov-pitaniya/)
- [Решение Find Match API](https://hotelmapping.org/ru/produkty/reshenie-find-match-api/)

## Связанные статьи

- [Что такое маппинг отелей (сопоставление отелей) и как он работает? Подробное руководство](https://hotelmapping.org/ru/rukovodstvo/chto-takoe-mapping-otelei/)
- [Стоимость дубликатов отелей для агентства: конверсия, отмены и жалобы клиентов](https://hotelmapping.org/ru/rukovodstvo/stoimost-dublikatov-otelei/)
- [12 вопросов, которые нужно задать при выборе API маппинга отелей](https://hotelmapping.org/ru/rukovodstvo/vybor-api-mappinga-otelei-12-voprosov/)
