Решения для контента номеров
Добавляет к каждому стандартному типу номера многоязычное описание, площадь, вместимость, кровати и вид.
Удобства отелей приводят разные названия одного и того же удобства от поставщиков ("Free WiFi", "WLAN", "Ücretsiz kablosuz internet") к одному стандартному коду и привязывают его к HM ID отеля. Удобства объекта, удобства номеров и сведения о доступности хранятся в отдельных полях. Продукт скоро будет запущен; для раннего доступа оставьте заявку на странице запроса предложения.
{
"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"] }
]
} Удобства всех поставщиков собираются в одном наборе кодов; фильтр «отели с частным пляжем» работает одинаково, из какого бы источника ни пришли данные.
Названия удобств на турецком, английском, немецком или другом языке привязываются к одному коду.
Удобства объекта, например бассейн, удобства номера, например кондиционер, и сведения о доступности для людей с ограниченными возможностями приходят в отдельных полях.
Удобства номеров берутся из того же словаря, что и в продукте «Контент номеров»; удобства типа номера не противоречат списку удобств отеля.
Удобства будут работать на инфраструктуре HM ID, в которой сопоставлено 3,5 млн отелей по всему миру.
Названия удобств одного отеля от трёх поставщиков
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_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.
Удобства объекта и номеров, присланные поставщиками, собираются под HM ID, определённым при маппинге отелей.
Разные названия, такие как "Free WiFi", "WLAN kostenlos" и "Ücretsiz kablosuz internet", привязываются к одному коду удобства.
Каждое удобство относится к уровню объекта или номера; сведения о доступности хранятся в отдельных полях.
Неоднозначные соответствия проверяет команда данных. Удобства возвращаются через 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-файлах. Для раннего доступа, информации об охвате и стоимости запросите предложение.
Запрос
curl "https://api.hotelmapping.org/v1/hotels/HM-1048213/content?include=amenities&lang=tr" \
-H "X-API-Key: $HM_API_KEY" Ответ
{
"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. Запрос ни к чему не обязывает.