# Решения для маппинга отелей для тревел-тех компаний

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

Компаниям в сфере тревел-технологий и ИИ для поиска, рекомендаций и моделей искусственного интеллекта нужны чистые, без дубликатов и структурированные данные об отелях. hotelmapping.org идентифицирует каждый отель единым HM ID, с помощью Find Match API привязывает к этому идентификатору любую запись и предлагает многоязычный контент через API и ежедневный dump.

## Проблемы, с которыми вы сталкиваетесь

- **Дубликаты вводят модель в заблуждение:** Если один и тот же отель встречается в наборе данных несколько раз, результаты поиска повторяются, система рекомендаций подаёт один отель как разные варианты, а ИИ-ассистент даёт противоречащие друг другу сведения.
- **Поля — это свободный текст:** Название номера, тип питания и зона в большинстве источников приходят свободным текстом. Если «UAI», «Ultra AI» и «Ultra Her Şey Dahil» остаются разными значениями, фильтрация и структурированный поиск не работают.
- **Строить собственное сопоставление дорого:** Нормализация, транслитерация, поиск кандидатов, оценка, размеченный тестовый набор и ручная проверка требуют отдельной команды и постоянного сопровождения. Для большинства продуктовых команд это не основное направление.

## Рекомендуемый пакет: Find Match API + маппинг отелей + контент и dump

Find Match API привязывает любую запись к HM ID; маппинг отелей даёт справочный список без дубликатов; контент об отелях даёт многоязычные описания и factsheet. Полные данные забираются через ежедневный dump. Данные, готовые для ИИ, с schema.org JSON-LD, эмбеддингами и API семантического поиска, планируются на более позднем этапе.

- [Решение 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-opisaniy-oteley/)

## Пример процесса

1. **Доступ к sandbox:** С ключом API вы пробуете конечные точки в среде sandbox. Аутентификация выполняется через заголовок X-API-Key.
2. **Сопоставление имеющихся записей:** Вы отправляете имеющиеся у вас записи об отелях с названием, адресом и координатами на конечную точку POST /v1/match; на каждую запись возвращаются HM ID и оценка уверенности.
3. **Получение справочных данных:** Через GET /v1/dumps/latest вы скачиваете ежедневный полный или дельта-dump в формате CSV, JSON или Parquet.
4. **Привязка к продукту:** Ваш поисковый индекс, система рекомендаций или база знаний модели используют HM ID как ключ; поля питания и зоны приходят в виде стандартных кодов.

## Почему важны структурированные данные об отелях?

Чтобы корректно отвечать об отеле, поисковый движок, система рекомендаций или ИИ-ассистент в первую очередь должны решить вопрос «что это за отель?». Если записи одного отеля из разных источников не объединены, модель порекомендует один и тот же отель несколько раз или смешает сведения о двух разных отелях. Основы темы изложены в руководстве [что такое маппинг отелей](https://hotelmapping.org/ru/rukovodstvo/chto-takoe-mapping-otelei/).

Команда, которая строит собственный конвейер сопоставления, вынуждена по отдельности разрабатывать и поддерживать нормализацию, транслитерацию русских и арабских названий, географический поиск кандидатов, модель оценки, вручную размеченный тестовый набор и экран ручной проверки. hotelmapping.org предлагает всё это как единый сервис; вы работаете только с HM ID.

## Пример Find Match API

[Find Match API](https://hotelmapping.org/ru/produkty/reshenie-find-match-api/) привязывает имеющуюся у вас запись к HM ID. Запрос:

```bash
curl -X POST https://api.hotelmapping.org/v1/match \
  -H "X-API-Key: $HM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Sunset Bay Rsrt. & Spa", "city": "Belek", "country": "TR", "lat": 36.8539, "lng": 31.0556 }'
```

Ответ:

```json
{
  "decision": "auto_match",
  "hm_id": "HM-1048213",
  "name": "Sunset Bay Resort & Spa",
  "confidence": 0.984
}
```

Это пример данных; название отеля и коды не относятся к реальному объекту. Поле `decision` показывает решение, принятое по оценке: `auto_match`, `review` или `no_match`. В свой индекс вы можете брать напрямую только записи `auto_match`, а записи `review` оставлять для отдельного шага проверки.

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

| Данные | Продукт или формат | Статус |
| --- | --- | --- |
| Постоянный идентификатор отеля | [Маппинг отелей](https://hotelmapping.org/ru/produkty/resheniya-dlya-mappinga-oteley/) | Доступно |
| Сопоставление записи с HM ID | Find Match API | Доступно |
| Многоязычные описания и factsheet | [Контент об отелях](https://hotelmapping.org/ru/produkty/resheniya-dlya-opisaniy-oteley/) | Доступно |
| Полный и [дельта-dump](https://hotelmapping.org/ru/glossariy/delta-dump/) | CSV, JSON, Parquet | Доступно |
| JSON-LD, эмбеддинги, семантический поиск | Данные, готовые для ИИ | Планируется (позже) |

## Частота обновления

Статические данные об отелях постоянно меняются: отели открываются, закрываются, меняют название. Ежедневный дельта-dump приносит только изменённые записи; полный dump используется для пересборки индекса с нуля. Webhook для уведомлений об изменениях планируется. Подробнее см. термин [статические данные об отелях](https://hotelmapping.org/ru/glossariy/staticheskie-dannye-oteley/).

Как сопоставляются русские и арабские названия, мы объясняем в термине [транслитерация](https://hotelmapping.org/ru/glossariy/transliteratsiya/). Полный список конечных точек приведён на [странице для разработчиков](https://hotelmapping.org/ru/razrabotchikam/); при выборе провайдера посмотрите также список [12 вопросов при выборе API маппинга отелей](https://hotelmapping.org/ru/rukovodstvo/vybor-api-mappinga-otelei-12-voprosov/).

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

### Можно ли использовать ваши данные для обучения моделей?

Условия использования и лицензирования определяются договором. Мы рекомендуем указать цель использования на этапе запроса предложения.

### На каких языках есть контент?

Первые языки контента об отелях планируются как TR, EN, DE, RU и AR. Русские и арабские названия отелей при сопоставлении также транслитерируются в латиницу.

### Когда появятся данные, готовые для ИИ?

schema.org Hotel JSON-LD, эмбеддинги и API семантического поиска планируются на более позднем этапе. Уже сегодня вы можете использовать структурированные данные с HM ID, стандартными кодами и файлами dump.

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

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