Решения для маппинга отелей
Постоянный HM ID для каждого объекта; коды поставщиков и перекрёстные ID в одной записи.
Find Match API берёт одну имеющуюся у вас запись об отеле (название, адрес, координаты, при наличии телефон и веб-адрес) и находит её соответствие в базе hotelmapping.org. В ответе возвращаются подходящий HM ID, оценка уверенности от 0 до 1 и решение, принятое по этой оценке. Работает и для записей без кода поставщика.
{
"reference": "K-0192",
"normalized_name": "lara palm",
"decision": "auto_match",
"hm_id": "HM-1052207",
"name": "Lara Palm Hotel",
"confidence": 0.973,
"signals": {
"name_similarity": 0.95,
"distance_m": 63,
"phone_match": true
}
} Для ваших контрактных отелей, записей экстранета или названия отеля в свободном тексте достаточно названия и данных о местоположении.
В каждом ответе возвращаются оценка уверенности и поле решения. Какие записи принимать автоматически, можно также ограничить собственным бизнес-правилом.
Сокращения, отсутствующие приставки, названия кириллицей и арабской вязью проходят нормализацию. Различия вроде «Rsrt.» и «Resort» сравниваются при оценке сходства названий на уровне символов и слов.
Наиболее вероятные кандидаты возвращаются вместе с расстоянием и оценками; принимать решение по записям, требующим проверки, становится проще.
Запись из собственной системы агентства без кода поставщика
internal_id,name,city,lat,lng,phone
K-0192,Отель Лара Палм,Анталья,36.8567,30.7969,0242 000 00 00 Результат Find Match API
{
"reference": "K-0192",
"normalized_name": "lara palm",
"decision": "auto_match",
"hm_id": "HM-1052207",
"name": "Lara Palm Hotel",
"confidence": 0.973,
"signals": {
"name_similarity": 0.95,
"distance_m": 63,
"phone_match": true
}
} Это пример данных; название отеля, телефон и коды не относятся к реальному объекту. Русское название транслитерируется в латиницу, и после выделения слова «отель» выполняется сравнение.
На конечную точку POST /v1/match отправляются название отеля и данные о местоположении. Чем больше добавлено координат, адреса, телефона и веб-адреса, тем увереннее совпадение.
Из названия выделяются приставки и суффиксы вроде «Hotel», «Resort & Spa», «Otel»; русские и арабские названия транслитерируются в латиницу; телефон приводится к международному формату, веб-адрес сводится к доменному имени.
Запись сравнивается только с ближайшими отелями: географическая ячейка около 500 метров, сходство названий, тот же телефон или домен.
Сходство названий, сходство многоязычных эмбеддингов, расстояние, совпадение телефона и сайта, звёздность и почтовый индекс объединяются в оценку вероятности от 0 до 1.
При оценке 0,97 и выше возвращается auto_match, в диапазоне 0,80–0,97 — review, ниже 0,80 — no_match; при no_match hm_id равен null. В ответ также входят наиболее вероятные кандидаты.
Продукт маппинг отелей пакетно привязывает файлы поставщиков к HM ID. Find Match API предназначен для мгновенного запроса по одной записи. Типичные сценарии:
Общую логику сопоставления мы описываем в руководстве по маппингу отелей.
| Оценка уверенности | decision |
Что делать? |
|---|---|---|
| 0,97 и выше | auto_match |
HM ID можно использовать напрямую |
| 0,80–0,97 | review |
Проверьте кандидатов; посмотрите на различия в названии, расстоянии и телефоне |
| Ниже 0,80 | no_match |
hm_id возвращается как null. Объекта может ещё не быть в базе; проверьте название и местоположение |
Пороги настраиваются по вручную размеченному тестовому набору и могут меняться между версиями. Из каких сигналов складывается оценка, поясняется в термине оценка совпадения.
reference. Ваш собственный идентификатор записи возвращается в ответе без изменений; результаты проще привязать к вашей таблице.Вместо того чтобы запрашивать тысячи записей по одной, передайте файл в процесс маппинга отелей; результат вернётся в ежедневных полных и дельта-dump. Для записей с оценкой ниже 0,80 Find Match API новый идентификатор не создаёт; при пакетном приёме для таких записей создаётся новый HM ID (решение new_id). По найденному HM ID вы также получаете доступ к данным о направлении и к контенту об отелях.
Поля ответа соответствуют API v1; точная схема публикуется на странице для разработчиков.
Запрос
curl -X POST https://api.hotelmapping.org/v1/match \
-H "X-API-Key: $HM_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"reference": "res-55821",
"name": "Sunset Bay Rsrt. & Spa - Adults",
"city": "Belek",
"country": "TR",
"lat": 36.8539,
"lng": 31.0556
}' Ответ
{
"reference": "res-55821",
"decision": "auto_match",
"hm_id": "HM-1048213",
"name": "Sunset Bay Resort & Spa",
"confidence": 0.984,
"candidates": [
{ "hm_id": "HM-1048213", "confidence": 0.984, "distance_m": 42 },
{ "hm_id": "HM-1048390", "confidence": 0.412, "distance_m": 310 }
]
} Примеры кода носят иллюстративный характер; названия полей могут измениться в релизе v1.
Запрос по коду поставщика (GET /v1/suppliers/{supplier}/codes/{code}) сразу возвращает HM ID ранее сопоставленного кода. Find Match API ищет запись, у которой нет кода или которая неизвестна в системе, по названию, адресу и координатам и рассчитывает новую оценку.
Нужны название отеля и данные о местоположении (координаты либо страна, город и адрес). Телефон, веб-адрес и почтовый индекс необязательны, но повышают оценку.
Сравните кандидатов из ответа по названию, расстоянию и оценке. Способ отправить записи, по которым вы не можете принять решение, на проверку эксперту (портал или API) пока не определён. Решения экспертов добавляются в обучающие данные модели.
Да. Названия кириллицей и арабской вязью при нормализации транслитерируются в латиницу; в оценку входит и сходство многоязычных эмбеддингов. Переводить название отдельно не нужно.
Вы можете попробовать его на примерах данных в sandbox-аккаунте.
Запросить предложение
Отправьте запрос в три шага, и мы пришлём предложение на ваш рабочий e-mail. Запрос ни к чему не обязывает.