Покупка

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

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

Автор
Редакция hotelmapping.org
Последнее обновление:
10 мин чтения

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

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

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

Если вы только знакомитесь с темой, рекомендуем сначала прочитать руководство что такое маппинг отелей. Статическую и динамическую стороны подключений к поставщикам мы описали в статье XML-интеграция отелей.

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

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

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

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

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

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

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

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

Почему это важно: Большинство систем сопоставления вычисляют оценку совпадения и используют пороговые значения. То, что делают с записями, оценка которых не однозначна, напрямую определяет качество: они всё равно сопоставляются автоматически, их проверяет специалист или открывается новая запись?

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

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

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

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

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

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

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

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

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

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

Как проверить: Спросите, по какому каналу сообщаются изменения: delta dump, webhook или конечная точка истории изменений. Посмотрите, явно ли присутствуют в delta удалённые и объединённые записи. Запросите пример delta-файла за последний месяц.

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

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

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

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

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 для вымышленного отеля; названия полей у других поставщиков могут отличаться.

Запрос:

{
  "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"
}

Ответ:

{
  "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 сопоставления и маппинг отелей, список конечных точек — на странице для разработчиков.

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

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

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

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

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

Мы не составляли этот список в пользу какого-либо поставщика; мы ожидаем, что вы зададите те же вопросы и hotelmapping.org. Наши измеренные значения точности и охвата будут опубликованы на странице покрытия после завершения тестового набора. О том, как цена определяется по числу модулей и поставщиков, мы рассказали на странице предложения. Если вы сравниваете нескольких поставщиков, измеряйте результаты на одном и том же наборе данных; как читать показатели точности и охвата вместе, мы рассказали в статье точность или охват?.

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

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

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

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

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

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

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

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

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

Редакция hotelmapping.org

Команда отельных данных DIJI.TECH

Команда DIJI.TECH, работающая в области маппинга отелей, интеграции поставщиков и туристического программного обеспечения.

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

  • Решение Find Match API

    Отправьте название, адрес и координаты, получите HM ID и оценку уверенности. Код поставщика не нужен.

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