Скоро

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

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

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

  • Единый словарь

    Удобства всех поставщиков собираются в одном наборе кодов; фильтр «отели с частным пляжем» работает одинаково, из какого бы источника ни пришли данные.

  • Многоязычный ввод

    Названия удобств на турецком, английском, немецком или другом языке привязываются к одному коду.

  • Объект, номер и доступность раздельно

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

  • Общий словарь с контентом номеров

    Удобства номеров берутся из того же словаря, что и в продукте «Контент номеров»; удобства типа номера не противоречат списку удобств отеля.

  • На основе сопоставленного отеля

    Удобства будут работать на инфраструктуре HM ID, в которой сопоставлено 3,5 млн отелей по всему миру.

До и после

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

supplier_amenities.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
{
  "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. 1

    Сбор названий удобств

    Удобства объекта и номеров, присланные поставщиками, собираются под HM ID, определённым при маппинге отелей.

  2. 2

    Приведение к стандартному коду

    Разные названия, такие как "Free WiFi", "WLAN kostenlos" и "Ücretsiz kablosuz internet", привязываются к одному коду удобства.

  3. 3

    Разделение на объект и номер

    Каждое удобство относится к уровню объекта или номера; сведения о доступности хранятся в отдельных полях.

  4. 4

    Проверка и обновление

    Неоднозначные соответствия проверяет команда данных. Удобства возвращаются через API, изменения приходят в delta dump.

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

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

Удобства отелей связывают эти названия с единым словарём кодов. Подробнее о понятии — на странице словаря маппинг удобств. Удобства — часть статических данных отелей; чтобы они объединялись правильно, записи одного отеля сначала должны быть собраны под одним HM ID с помощью маппинга отелей. Общая картина — в руководстве по маппингу отелей.

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

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

Охват

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

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

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

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

Удобства, специфичные для типа номера, придут из того же словаря, что и продукт контент номеров. А такие объекты рядом с отелем, как пляж или аэропорт, — это не удобства, а данные локации и POI.

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

После запуска продукта удобства будут передаваться в API вместе с ответом о контенте отеля, а для всего фонда — в dump-файлах. Для раннего доступа, информации об охвате и стоимости запросите предложение.

Что такое маппинг отелей? Подробное руководство

Пример API

Запрос

Черновик API v1: запрос удобств отеля
curl "https://api.hotelmapping.org/v1/hotels/HM-1048213/content?include=amenities&lang=tr" \
  -H "X-API-Key: $HM_API_KEY"

Ответ

200 OK (черновик ответа)
{
  "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.

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

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

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

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

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

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

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

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

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

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

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

Запросить предложение

Получите индивидуальное предложение

Отправьте запрос в три шага, и мы пришлём предложение на ваш рабочий e-mail. Запрос ни к чему не обязывает.

  1. 1 Выберите решения
  2. 2 Выберите поставщиков
  3. 3 Оставьте контактные данные