# 12 вопросов, которые нужно задать при выборе API маппинга отелей

> URL: https://hotelmapping.org/ru/rukovodstvo/vybor-api-mappinga-otelei-12-voprosov/ · Язык: Русский · Последнее обновление: 2026-11-15

**При выборе API маппинга отелей спрашивайте, как измеряется точность, действует ли охват для ваших регионов, как обрабатываются неоднозначные совпадения, насколько постоянны ID, как поддерживаются номера и типы питания, какие есть способы поставки, как исправляются ошибки и каковы условия выхода. Каждый ответ проверяйте пробой на собственных данных поставщиков.**

## Как пользоваться этим списком?

Большинство поставщиков маппинга отелей обещают высокую точность, широкий охват и простую интеграцию. Когда обещания похожи, выбор легко сводится к цене и впечатлению от демонстрации. Между тем различия кроются в деталях: как измеряется точность, что происходит с неоднозначными записями, как ведёт себя ID, когда отель закрывается, входят ли номера и типы питания в охват.

Приведённые ниже 12 вопросов объединяют темы, которые стоит задать при оценке API маппинга отелей, в пять разделов. Для каждого вопроса мы написали, **почему он важен** и **как проверить ответ**. Список нейтрален; он применим к любому поставщику, включая hotelmapping.org.

Если вы только знакомитесь с темой, рекомендуем сначала прочитать руководство [что такое маппинг отелей](https://hotelmapping.org/ru/rukovodstvo/chto-takoe-mapping-otelei/). Статическую и динамическую стороны подключений к поставщикам мы описали в статье [XML-интеграция отелей](https://hotelmapping.org/ru/rukovodstvo/chto-takoe-xml-integratsiya-otelei/).

## Качество данных

### 1. Как измеряется точность и какова доля ложных совпадений?

**Почему это важно:** Ложное совпадение чаще всего обходится дороже, чем пропущенное. Если два разных отеля объединены в одну запись, клиент может забронировать не тот отель; это означает отмены, жалобы и дополнительные расходы. Слово «точность» у разных поставщиков может означать разное: доля может считаться только по автоматическим совпадениям или с учётом записей, прошедших ручную проверку.

**Как проверить:** Спросите, на каком тестовом наборе проведено измерение: сколько пар отелей, из каких регионов, кто размечал, когда измерялось в последний раз? Запросите долю ложных совпадений (false positive) и долю пропущенных совпадений (false negative) отдельно. Затем отправьте выборку из ваших собственных данных поставщиков и проверьте результаты вручную силами вашей команды.

### 2. Для каких регионов и поставщиков действует показатель охвата?

**Почему это важно:** Глобальный показатель охвата может не отражать положение в регионах, где вы продаёте. Средиземноморские курортные регионы с множеством объектов с одинаковыми названиями и близким расположением — сложная область. Кроме того, охват зависит от того, обрабатывает ли поставщик данные ваших поставщиков уже сейчас.

**Как проверить:** Передайте список поставщиков, с которыми вы работаете, и запросите показатель охвата по каждому отдельно. Запросите результаты по регионам для самых продаваемых направлений (например, Анталья, Мугла, Стамбул). Спросите, считается ли охват от общего числа записей или от активных и доступных для продажи записей.

### 3. Как обрабатываются неоднозначные совпадения?

**Почему это важно:** Большинство систем сопоставления вычисляют [оценку совпадения](https://hotelmapping.org/ru/glossariy/otsenka-sovpadeniya/) и используют пороговые значения. То, что делают с записями, оценка которых не однозначна, напрямую определяет качество: они всё равно сопоставляются автоматически, их проверяет специалист или открывается новая запись?

**Как проверить:** Спросите о значениях порогов и о том, что происходит в каждом диапазоне. Запросите долю записей, попадающих на ручную проверку, и среднее время принятия решения. Посмотрите, возвращается ли оценка вам в ответе API; если возвращается, вы можете применить у себя более строгий порог.

## Идентификаторы и жизненный цикл

### 4. Постоянен ли ID; что происходит с закрывшимися, объединёнными и разделёнными отелями?

**Почему это важно:** Идентификатор сопоставления записывается в вашу историю бронирований, таблицы контента и отчёты. Если ID повторно выдан другому отелю или тихо удалён, ваши исторические данные портятся.

**Как проверить:** Письменно спросите, выдаётся ли ID повторно другому отелю. Запросите пример ответа, показывающий, перенаправляется ли старый ID на новый при объединении двух отелей и как это выглядит в API (например, поле `status` или `merged_into`). Посмотрите, помечаются ли закрывшиеся отели как неактивные.

### 5. Можно ли перенести ваши существующие ID и коды?

**Почему это важно:** Большинство команд начинают не с нуля. У вас могут быть собственные коды отелей или идентификаторы сервиса сопоставления, которым вы пользовались раньше. Если новый поставщик не может хранить их как перекрёстные ссылки, стоимость перехода растёт.

**Как проверить:** Отправьте пример из вашей действующей таблицы сопоставления и посмотрите, возвращаются ли вместе с новыми ID и прежние идентификаторы. Спросите, что берётся за основу при расхождении (когда ваша таблица и результат поставщика различаются) и сообщаются ли вам эти различия.

### 6. Как сообщается об изменениях кодов поставщиков?

**Почему это важно:** Поставщики удаляют коды, выдают новые, заново публикуют отель под другим кодом. Если эти изменения до вас не доходят, ваша таблица сопоставления тихо устаревает, и в поиске появляются потерянные отели или [дубликаты](https://hotelmapping.org/ru/glossariy/udalenie-dublikatov/).

**Как проверить:** Спросите, по какому каналу сообщаются изменения: [delta dump](https://hotelmapping.org/ru/glossariy/delta-dump/), webhook или конечная точка истории изменений. Посмотрите, явно ли присутствуют в delta удалённые и объединённые записи. Запросите пример delta-файла за последний месяц.

## Глубина охвата

### 7. Есть ли маппинг номеров и как он работает?

**Почему это важно:** Одного маппинга отелей недостаточно для сравнения цен. Если «DBL SV», «Double Room Sea View» и «Deniz Manzaralı Çift Kişilik Oda» — один и тот же номер, их тоже нужно привязать к одному идентификатору. Иначе в одной карточке отеля один и тот же номер появится несколько раз.

**Как проверить:** Спросите, является ли маппинг номеров отдельным продуктом или входит в маппинг отелей. Выясните, работает он мгновенно (по запросу) или пакетно. Отправьте из своих данных сложные названия номеров (с сокращениями, многоязычные, семейные номера, смежные номера) и посмотрите на результаты. Подробности смотрите на нашей странице [маппинг номеров](https://hotelmapping.org/ru/produkty/resheniya-dlya-mappinga-nomerov/).

### 8. Поддерживаются ли маппинг типов питания и направлений?

**Почему это важно:** На курортном рынке тип питания — один из главных факторов, определяющих цену. Если написания вроде «AI», «All Inclusive», «Ультра всё включено», «Soft AI» не преобразуются в стандартный код, разные типы питания могут сравниваться в одной ценовой строке. Что касается направлений, поставщики передают один и тот же регион с разной иерархией (например, один поставщик указывает «Antalya», другой — «Belek»).

**Как проверить:** Запросите список поддерживаемых стандартных кодов питания. Отправьте написания питания от ваших поставщиков и посмотрите, в какой код они преобразуются. Спросите, хранятся ли для направлений отдельно уровни страны, области, района и курортной зоны.

### 9. Как обрабатываются многоязычные названия и адреса?

**Почему это важно:** Один и тот же отель может прийти от одного поставщика латиницей, а от другого кириллицей или арабской вязью. Турецкие буквы (ç, ğ, ı, ö, ş, ü) в некоторых системах искажаются или пропадают. Эти различия затрудняют сопоставление, основанное на сходстве названий.

**Как проверить:** Спросите, как выполняются транслитерация и нормализация символов. Включите в выборку отели, приходящие с русскими или арабскими названиями, и записи с искажёнными турецкими символами. Оцените результаты по этой подгруппе отдельно.

## Техническая интеграция и эксплуатация

### 10. Каковы способы поставки, лимиты и актуальность?

**Почему это важно:** Результат сопоставления используется в момент поиска. Обращение к удалённому API при каждом поиске может создавать задержку; большинство команд хранят результаты у себя в виде таблицы. Поэтому поставка массовым файлом (dump) важна не меньше, чем API.

**Как проверить:** Запросите письменно следующие подробности:

- Конечные точки API и пример запроса/ответа
- Лимиты вызовов (в минуту, день, месяц) и что происходит при их превышении
- Форматы полного и delta dump (CSV, JSON, Parquet и т. д.) и частота публикации
- Поддержка webhook
- Срок сопоставления нового файла поставщика
- Есть ли тестовая среда (sandbox) и открыта ли документация для всех

В тестовой среде в течение нескольких дней запустите поток, близкий к вашей реальной нагрузке.

### 11. Что происходит, когда сообщают о ложном совпадении?

**Почему это важно:** Безошибочных систем не бывает. Разница в том, как быстро исправляется ошибка и повторяется ли она. Если процесс исправления неясен, вашей команде приходится вручную латать неверные записи на своей стороне.

**Как проверить:** Спросите о канале сообщения об ошибках (API, портал, e-mail) и целевом сроке исправления. Выясните, применяется ли исправление только в вашей учётной записи или для всех клиентов. Посмотрите, есть ли в договоре уровень обслуживания (SLA) и подходит ли вашей команде язык поддержки. Во время пробы намеренно сообщите об ошибке и проследите процесс от начала до конца.

## Коммерческие условия

### 12. Какие ценовая модель, условия пробного периода и выхода?

**Почему это важно:** Сервисы маппинга могут оцениваться по числу поставщиков, числу отелей, числу вызовов или по модулям продукта. Если модель не согласуется с вашим планом роста, затраты неожиданно увеличиваются. Кроме того, возможность продолжать пользоваться результатами сопоставления после окончания договора определяет стоимость перехода.

**Как проверить:** Посмотрите, указана ли цена открыто, какие модули входят и есть ли плата за дополнительного поставщика. Спросите, есть ли бесплатный пробный период или тестовая среда (sandbox). Письменно запросите, в каком формате можно экспортировать данные при окончании договора, и условия лицензии.

## 12 вопросов с первого взгляда

| # | Вопрос | Какое доказательство запросить | На какой признак обратить внимание |
| --- | --- | --- | --- |
| 1 | Как измеряется точность? | Описание тестового набора, результат на вашей выборке | Единственная цифра без описания метода |
| 2 | Каков охват в ваших регионах? | Показатель по поставщикам и регионам | Только глобальный показатель |
| 3 | Что происходит с неоднозначными совпадениями? | Значения порогов, доля ручной проверки | Оценка не возвращается в API |
| 4 | Постоянен ли ID? | Пример ответа при объединении и закрытии | Возможность повторного использования ID |
| 5 | Переносятся ли существующие ID? | Пример вывода с перекрёстными ссылками | Потеря старых кодов |
| 6 | Сообщается ли об изменениях кодов? | Пример delta-файла | Удалённых записей нет в delta |
| 7 | Есть ли маппинг номеров? | Результат теста на сложных названиях номеров | Возврат только свободного текста |
| 8 | Есть ли питание и направления? | Список стандартных кодов, пример иерархии | Типы питания вне охвата |
| 9 | Обрабатываются ли многоязычные названия? | Тест на записях кириллицей и арабской вязью | Заметное падение в этой подгруппе |
| 10 | Каковы поставка и лимиты? | Документация, sandbox, пример dump | Нет варианта массовой поставки |
| 11 | Как исправляются ошибки? | Канал сообщения, целевой срок, SLA | Неясный процесс исправления |
| 12 | Каковы цена и условия выхода? | Письменная цена, право экспорта | Невозможность использовать данные после окончания договора |

## Пример: на что смотреть в ответе сопоставления?

Ответы API, полученные при оценке, одним взглядом отвечают на многие из вышеперечисленных вопросов. Ниже в качестве примера показан ответ `POST /v1/match` API v1 hotelmapping.org для вымышленного отеля; названия полей у других поставщиков могут отличаться.

Запрос:

```json
{
  "reference": "res-20417",
  "name": "Kemer Pine Garden Hotel",
  "address": "Göynük Mah. Atatürk Cad. No:45, Kemer, Antalya",
  "lat": 36.6515,
  "lng": 30.5601,
  "supplier": "C",
  "supplier_code": "KPG-7781"
}
```

Ответ:

```json
{
  "reference": "res-20417",
  "hm_id": "HM-1061590",
  "confidence": 0.984,
  "decision": "auto_match",
  "status": "active",
  "merged_into": null,
  "destination_id": "TR-07-KEMER-GOYNUK",
  "external_ids": { "client": "OTL-2231" },
  "supplier_codes": { "A": "KPGH-1102", "C": "KPG-7781" },
  "matched_at": "2026-11-15T09:20:00Z"
}
```

Это примерные данные; название отеля, адрес и коды не принадлежат реальному объекту. Названия полей соответствуют API v1 и могут измениться. В этом ответе обратите внимание на следующее:

- `confidence` и `decision`: возвращаются ли оценка и тип решения? (Вопрос 3)
- `status` и `merged_into`: видны ли статусы закрытия и объединения? (Вопрос 4)
- `external_ids`: переносятся ли ваши собственные коды отелей или идентификаторы вашего действующего поставщика? (Вопрос 5)
- `supplier_codes`: находятся ли другие коды поставщиков того же отеля в одной записи? (Вопрос 6)
- `destination_id`: приходит ли иерархия направлений в виде стандартного идентификатора? (Вопрос 8)

Подробности Find Match API — на страницах [API сопоставления](https://hotelmapping.org/ru/produkty/reshenie-find-match-api/) и [маппинг отелей](https://hotelmapping.org/ru/produkty/resheniya-dlya-mappinga-oteley/), список конечных точек — на странице [для разработчиков](https://hotelmapping.org/ru/razrabotchikam/).

## Как выстроить пробный процесс?

Чтобы получать ответы на вопросы не из презентации, а из данных, достаточно короткого плана пробы:

1. **Подготовьте выборку:** составьте список записей от всех ваших поставщиков, из регионов, где вы продаёте больше всего, и со сложными случаями (отели с одинаковыми названиями, объекты рядом друг с другом, многоязычные названия).
2. **Заранее определите правильные ответы:** сопоставьте часть этого списка вручную силами команды. Это эталон, с которым вы будете сравнивать результаты поставщика.
3. **Отправьте одни и те же данные всем кандидатам:** чтобы сравнение было честным, каждый поставщик должен получить один и тот же файл.
4. **Измеряйте результаты по отдельности:** получите отдельные числа для ложных совпадений, пропущенных совпадений, записей, попавших на ручную проверку, и времени поставки.
5. **Проверьте эксплуатацию:** сообщите об ошибке, запросите delta-файл, опробуйте лимиты API.
6. **Получите условия договора в письменном виде:** цена, SLA и право экспорта данных должны быть явно указаны в предложении.

Расчёт того, во сколько вашему бизнесу обходятся дубликаты, помогает перевести результаты пробы в бизнес-эффект. Для этого можно обратиться к статье [стоимость дубликатов отелей](https://hotelmapping.org/ru/rukovodstvo/stoimost-dublikatov-otelei/).

## Задайте эти вопросы и hotelmapping.org

Мы не составляли этот список в пользу какого-либо поставщика; мы ожидаем, что вы зададите те же вопросы и hotelmapping.org. Наши измеренные значения точности и охвата будут опубликованы на странице [покрытия](https://hotelmapping.org/ru/pokrytie/) после завершения тестового набора. О том, как цена определяется по числу модулей и поставщиков, мы рассказали на [странице предложения](https://hotelmapping.org/ru/zaprosit-predlozhenie/). Если вы сравниваете нескольких поставщиков, измеряйте результаты на одном и том же наборе данных; как читать показатели точности и охвата вместе, мы рассказали в статье [точность или охват?](https://hotelmapping.org/ru/rukovodstvo/tochnost-ili-okhvat-mappinga/).

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

### В чём разница между точностью и охватом?

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

### Сколько данных достаточно для пробы?

Точного числа нет. Важно, чтобы выборка представляла ваш реальный номерной фонд: в ней должны быть регионы, где вы продаёте больше всего, сложные случаи (отели с одинаковыми названиями, названия кириллицей или арабской вязью, объекты рядом друг с другом) и все ваши поставщики.

### Пропадут ли мои сопоставления, если я сменю поставщика?

Это зависит от условий договора и прав на данные. До выбора письменно спросите, в каком формате вы можете экспортировать результаты сопоставления и можно ли продолжать пользоваться этими данными после окончания договора.

### Можно ли задавать эти вопросы и hotelmapping.org?

Да. Список составлен нейтрально и применим к любому поставщику, включая hotelmapping.org. Проба на собственных данных — самый надёжный способ сравнения.

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

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

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

- [Что такое маппинг отелей (сопоставление отелей) и как он работает? Подробное руководство](https://hotelmapping.org/ru/rukovodstvo/chto-takoe-mapping-otelei/)
- [Точность или охват в маппинге? Что на самом деле означает 99,99 %](https://hotelmapping.org/ru/rukovodstvo/tochnost-ili-okhvat-mappinga/)
- [Стоимость дубликатов отелей для агентства: конверсия, отмены и жалобы клиентов](https://hotelmapping.org/ru/rukovodstvo/stoimost-dublikatov-otelei/)
- [Что такое XML-интеграция отелей? Статические и динамические данные](https://hotelmapping.org/ru/rukovodstvo/chto-takoe-xml-integratsiya-otelei/)

## Связанные термины

- [Оценка совпадения](https://hotelmapping.org/ru/glossariy/otsenka-sovpadeniya/)
- [HM ID](https://hotelmapping.org/ru/glossariy/hm-id/)
- [Удаление дубликатов](https://hotelmapping.org/ru/glossariy/udalenie-dublikatov/)
- [Delta dump](https://hotelmapping.org/ru/glossariy/delta-dump/)
- [Код поставщика](https://hotelmapping.org/ru/glossariy/kod-postavshchika/)
