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

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

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

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

- **Один номер — одна строка:** «DBL SV BLC», «DZ Meerblick Balkon» и «Двухместный номер с видом на море и балконом» привязываются к одному ID номера; цены сравниваются в одной строке.
- **Многоязычный словарь сокращений:** Сокращения и написания названий номеров на турецком, английском, немецком и русском хранятся в словаре правил; там, где словаря недостаточно, подключается модель разметки.
- **Структурированные данные о номерах:** Каждое название номера разбирается на шесть тегов. Фильтрация и сортировка по виду, типу кровати или вместимости не требуют отдельного разбора.
- **Различия в виде и вместимости сохраняются:** У номеров с видом на сушу и с видом на море разные теги, поэтому они остаются под разными ID и не показываются в одной строке.
- **Мгновенно или пакетно:** Несколько названий номеров сопоставляются мгновенно одним запросом; для всего инвентаря доступны также пакетная обработка и доставка файлом.

## До и после

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

**supplier_rooms.csv**

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

```json
{
  "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. **Разбор названия номера:** Название номера делится на слова и сокращения. Регистр, пунктуация, вместимость в скобках («2+1») и языковые различия нормализуются.
2. **Словарь правил:** Каждая часть сопоставляется со словарём сокращений на турецком, английском, немецком и русском: «SV», «Meerblick» и «Deniz Manzaralı» попадают в один тег вида.
3. **Модель разметки:** Части, которых нет в словаре или которые имеют несколько значений, модель разметки относит к типу, классу, виду, кровати, особенности или вместимости.
4. **Группировка внутри отеля:** Номера, привязанные к одному HM ID, сравниваются по тегам. Названия с совпадающими тегами привязываются к одному ID номера; записи с противоречиями отправляются на ручную проверку.
5. **Доставка:** Результат возвращается в ответе API мгновенно, а при пакетной обработке — файлом. Каждый код номера поставщика хранится вместе с ID номера, к которому он привязан.

## Пример API

**POST /v1/rooms/map**

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

```json
{
  "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._

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

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

Маппинг номеров разбирает каждое название на одни и те же шесть тегов и выполняет сравнение не по названиям, а по этим тегам. Подробно о теме рассказывает руководство [что такое маппинг номеров](https://hotelmapping.org/ru/rukovodstvo/chto-takoe-mapping-nomerov/), а об общей картине — [руководство по маппингу отелей](https://hotelmapping.org/ru/rukovodstvo/chto-takoe-mapping-otelei/).

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

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

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

Словарь правил связывает написания одного и того же понятия на четырёх языках с одним тегом. Строки ниже приведены для примера; полный список находится в руководстве [сокращения типов номеров](https://hotelmapping.org/ru/rukovodstvo/sokrashcheniya-tipov-nomerov/).

| Понятие | 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 отеля определяется с помощью [маппинга отелей](https://hotelmapping.org/ru/produkty/resheniya-dlya-mappinga-oteley/). Чтобы сравнение цен было корректным, вместе с номером нужен и [маппинг типов питания](https://hotelmapping.org/ru/produkty/resheniya-dlya-mappinga-tipov-pitaniya/). Термины см. на страницах глоссария: [маппинг номеров](https://hotelmapping.org/ru/glossariy/mapping-nomerov/) и [код поставщика](https://hotelmapping.org/ru/glossariy/kod-postavshchika/).

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

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

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

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

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

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

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

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

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

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

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

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

- [Решения для маппинга отелей](https://hotelmapping.org/ru/produkty/resheniya-dlya-mappinga-oteley/)
- [Решения для маппинга типов питания](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-nomerov/)
- [Словарь сокращений типов номеров: SGL, DBL, TWN, TRP, SV, LV, FAM](https://hotelmapping.org/ru/rukovodstvo/sokrashcheniya-tipov-nomerov/)
- [Что такое маппинг отелей (сопоставление отелей) и как он работает? Подробное руководство](https://hotelmapping.org/ru/rukovodstvo/chto-takoe-mapping-otelei/)
