# Решения для удобств отелей

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

Удобства отелей приводят разные названия одного и того же удобства от поставщиков ("Free WiFi", "WLAN", "Ücretsiz kablosuz internet") к одному стандартному коду и привязывают его к HM ID отеля. Удобства объекта, удобства номеров и сведения о доступности хранятся в отдельных полях. Продукт скоро будет запущен; для раннего доступа оставьте заявку на странице запроса предложения.

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

- **Единый словарь:** Удобства всех поставщиков собираются в одном наборе кодов; фильтр «отели с частным пляжем» работает одинаково, из какого бы источника ни пришли данные.
- **Многоязычный ввод:** Названия удобств на турецком, английском, немецком или другом языке привязываются к одному коду.
- **Объект, номер и доступность раздельно:** Удобства объекта, например бассейн, удобства номера, например кондиционер, и сведения о доступности для людей с ограниченными возможностями приходят в отдельных полях.
- **Общий словарь с контентом номеров:** Удобства номеров берутся из того же словаря, что и в продукте «Контент номеров»; удобства типа номера не противоречат списку удобств отеля.
- **На основе сопоставленного отеля:** Удобства будут работать на инфраструктуре HM ID, в которой сопоставлено 3,5 млн отелей по всему миру.

## До и после

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

**supplier_amenities.csv**

```csv
supplier,hotel_code,amenity
A,HTL-88213,Free WiFi
B,40917,WLAN kostenlos
C,TR-ANT-551,Ücretsiz kablosuz internet
A,HTL-88213,Outdoor pool
C,TR-ANT-551,Açık yüzme havuzu
B,40917,Privatstrand
C,TR-ANT-551,Klima (odalarda)
```

Удобства, приведённые к стандартным кодам

**Удобства HM-1048213**

```json
{
  "hm_id": "HM-1048213",
  "amenities_in": 7,
  "amenities_unique": 4,
  "amenities": [
    { "code": "wifi_free", "level": "hotel", "suppliers": ["A", "B", "C"] },
    { "code": "pool_outdoor", "level": "hotel", "suppliers": ["A", "C"] },
    { "code": "beach_private", "level": "hotel", "suppliers": ["B"] },
    { "code": "air_conditioning", "level": "room", "suppliers": ["C"] }
  ]
}
```

_Это пример данных; отель и коды не относятся к реальному объекту. Названия полей и коды удобств — черновик API v1._

## Как это работает

1. **Сбор названий удобств:** Удобства объекта и номеров, присланные поставщиками, собираются под HM ID, определённым при маппинге отелей.
2. **Приведение к стандартному коду:** Разные названия, такие как "Free WiFi", "WLAN kostenlos" и "Ücretsiz kablosuz internet", привязываются к одному коду удобства.
3. **Разделение на объект и номер:** Каждое удобство относится к уровню объекта или номера; сведения о доступности хранятся в отдельных полях.
4. **Проверка и обновление:** Неоднозначные соответствия проверяет команда данных. Удобства возвращаются через API, изменения приходят в delta dump.

## Пример API

**Черновик API v1: запрос удобств отеля**

```bash
curl "https://api.hotelmapping.org/v1/hotels/HM-1048213/content?include=amenities&lang=tr" \
  -H "X-API-Key: $HM_API_KEY"
```

**200 OK (черновик ответа)**

```json
{
  "hm_id": "HM-1048213",
  "amenities": {
    "hotel": [
      { "code": "pool_outdoor", "name": "Açık havuz" },
      { "code": "beach_private", "name": "Özel plaj" },
      { "code": "spa", "name": "Spa" },
      { "code": "wifi_free", "name": "Ücretsiz Wi-Fi" }
    ],
    "room": [
      { "code": "air_conditioning", "name": "Klima" },
      { "code": "minibar", "name": "Minibar" }
    ],
    "accessibility": [
      { "code": "elevator", "name": "Asansör" }
    ]
  }
}
```

_Примеры кода носят иллюстративный характер; названия полей могут измениться в релизе v1._

## Какую задачу решают удобства отелей?

Поставщики присылают одно и то же удобство под разными названиями: в одном файле написано «Free WiFi», в другом «WLAN kostenlos», в третьем «Ücretsiz kablosuz internet». Бассейн приходит то как «Outdoor pool», то просто как «POOL». Без стандартного кода фильтр «отели с частным пляжем» пропускает часть отелей, а список удобств одного и того же отеля зависит от поставщика.

Удобства отелей связывают эти названия с единым словарём кодов. Подробнее о понятии — на странице словаря [маппинг удобств](https://hotelmapping.org/ru/glossariy/mapping-udobstv/). Удобства — часть [статических данных отелей](https://hotelmapping.org/ru/glossariy/staticheskie-dannye-oteley/); чтобы они объединялись правильно, записи одного отеля сначала должны быть собраны под одним [HM ID](https://hotelmapping.org/ru/glossariy/hm-id/) с помощью [маппинга отелей](https://hotelmapping.org/ru/produkty/resheniya-dlya-mappinga-oteley/). Общая картина — в [руководстве по маппингу отелей](https://hotelmapping.org/ru/rukovodstvo/chto-takoe-mapping-otelei/).

## Статус продукта

Удобства отелей скоро будут запущены. Эта страница описывает, как продукт будет работать; названия полей, коды удобств и эндпоинты в примерах — черновик API v1 и могут измениться.

## Охват

| Группа | Примеры удобств | Пример кода |
| --- | --- | --- |
| Удобства объекта | Бассейн, спа, частный пляж, аквапарк, фитнес, парковка, конференц-зал | `pool_outdoor`, `beach_private` |
| Удобства номера | Кондиционер, балкон, мини-бар, сейф, кофемашина, ванна | `air_conditioning`, `minibar` |
| Доступность | Доступ для людей с ограниченными возможностями, лифт, доступный номер | `elevator` |

Коды не зависят от языка; в интерфейсе вы показываете название на своём языке.

## Где используется

- **Фильтры поиска:** фильтры «с частным пляжем», «с аквапарком» или «принимает животных» работают по одним и тем же данным во всех источниках.
- **Сравнение отелей:** пользователи сравнивают отели по одному и тому же списку удобств.
- **Сведения о доступности:** отели и номера, подходящие для людей с ограниченными возможностями, показываются чётко, из отдельных полей.

Удобства, специфичные для типа номера, придут из того же словаря, что и продукт [контент номеров](https://hotelmapping.org/ru/produkty/resheniya-dlya-kontenta-nomerov/). А такие объекты рядом с отелем, как пляж или аэропорт, — это не удобства, а данные [локации и POI](https://hotelmapping.org/ru/produkty/resheniya-dlya-lokatsii-i-poi/).

## Ранний доступ

После запуска продукта удобства будут передаваться в API вместе с ответом о контенте отеля, а для всего фонда — в dump-файлах. Для раннего доступа, информации об охвате и стоимости [запросите предложение](https://hotelmapping.org/ru/zaprosit-predlozhenie/).

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

### Когда будут запущены удобства отелей?

Удобства отелей скоро будут запущены; точная дата пока не объявлена. Для раннего доступа напишите нам на странице запроса предложения.

### Какие удобства охвачены?

Удобства объекта, такие как бассейн, спа, частный пляж, аквапарк, фитнес, парковка и конференц-зал; удобства номера, такие как кондиционер, балкон, мини-бар, сейф, кофемашина и ванна; а также сведения о доступности, лифте и номерах для людей с ограниченными возможностями.

### Зачем нужен маппинг удобств?

Поставщики присылают одно и то же удобство под разными названиями. Без стандартного кода фильтры пропускают одни отели или показывают не те.

### Удобства номеров привязываются к каждому типу номера отдельно?

Удобства, специфичные для типа номера, придут в продукте «Контент номеров» вместе со стандартным идентификатором номера. Оба продукта используют один словарь удобств.

### Нужен ли для удобств маппинг отелей?

Да. Удобства от разных поставщиков можно объединить только после того, как записи одного отеля собраны под одним HM ID.

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

- [Решения для контента номеров](https://hotelmapping.org/ru/produkty/resheniya-dlya-kontenta-nomerov/)
- [Решения для маппинга отелей](https://hotelmapping.org/ru/produkty/resheniya-dlya-mappinga-oteley/)
- [Решения для локации и POI](https://hotelmapping.org/ru/produkty/resheniya-dlya-lokatsii-i-poi/)

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

- [Что такое маппинг отелей (сопоставление отелей) и как он работает? Подробное руководство](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/)
