Oda içerikleri çözümü
Her standart oda tipine çok dilli açıklama, metrekare, kapasite, yatak düzeni ve manzara bilgisi ekler.
Otel olanakları, tedarikçilerin aynı olanak için gönderdiği farklı adları ("Free WiFi", "WLAN", "Ücretsiz kablosuz internet") tek bir standart koda çevirir ve otelin HM ID'sine bağlar. Tesis olanakları, oda olanakları ve erişilebilirlik bilgileri ayrı alanlarda tutulur. Ürün yakında kullanıma açılacak; erken erişim için teklif sayfasından başvurabilirsiniz.
{
"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"] }
]
} Tüm tedarikçilerin olanakları aynı kod setinde toplanır; "özel plajı olan oteller" filtresi hangi kaynaktan gelirse gelsin aynı çalışır.
Türkçe, İngilizce, Almanca veya başka bir dilde gelen olanak adları aynı koda bağlanır.
Havuz gibi tesis olanakları, klima gibi oda olanakları ve engelli erişimi bilgileri ayrı alanlarda gelir.
Oda olanakları, oda içerikleri ürünüyle aynı sözlükten gelir; bir oda tipinin olanakları ile otelin olanak listesi çelişmez.
Olanaklar, dünya genelinde 3,5 milyon otelin eşleştirildiği HM ID altyapısı üzerinde çalışacak.
Aynı otel için üç tedarikçiden gelen olanak adları
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) Standart kodlara çevrilmiş olanaklar
{
"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"] }
]
} Örnek veridir; otel ve kodlar gerçek bir tesise ait değildir. Alan adları ve olanak kodları API v1 taslağıdır.
Tedarikçilerin gönderdiği tesis ve oda olanakları, otel eşleştirmeyle belirlenen HM ID altında bir araya getirilir.
"Free WiFi", "WLAN kostenlos" ve "Ücretsiz kablosuz internet" gibi farklı adlar tek bir olanak koduna bağlanır.
Her olanak tesis ya da oda seviyesine ayrılır; erişilebilirlik bilgileri ayrı alanlarda tutulur.
Belirsiz eşleşmeleri veri ekibi doğrular. Olanaklar API'den döner, değişiklikler delta dump ile gelir.
Tedarikçiler aynı olanağı farklı adlarla gönderir: bir dosyada “Free WiFi”, diğerinde “WLAN kostenlos”, bir başkasında “Ücretsiz kablosuz internet” yazar. Havuz bazen “Outdoor pool”, bazen yalnızca “POOL” olarak gelir. Standart kod olmadan “özel plajı olan oteller” filtresi bazı otelleri kaçırır, aynı otelin olanak listesi de tedarikçiye göre değişir.
Otel olanakları bu adları tek bir kod sözlüğüne bağlar. Kavramın ayrıntısı için olanak eşleştirme sözlük sayfasına bakabilirsiniz. Olanaklar statik otel verisinin bir parçasıdır ve doğru birleşmeleri için önce otel eşleştirme ile aynı otelin kayıtlarının tek HM ID altında toplanması gerekir. Genel çerçeve otel eşleştirme rehberinde.
Otel olanakları yakında kullanıma açılacak. Bu sayfa ürünün nasıl çalışacağını anlatır; örneklerdeki alan adları, olanak kodları ve uç noktalar API v1 taslağıdır ve değişebilir.
| Grup | Örnek olanaklar | Örnek kod |
|---|---|---|
| Tesis olanakları | Havuz, spa, özel plaj, aquapark, fitness, otopark, toplantı salonu | pool_outdoor, beach_private |
| Oda olanakları | Klima, balkon, minibar, kasa, kahve makinesi, küvet | air_conditioning, minibar |
| Erişilebilirlik | Engelli erişimi, asansör, erişilebilir oda | elevator |
Kodlar dilden bağımsızdır; arayüzde kendi dilinizdeki adı gösterirsiniz.
Oda tipine özel olanaklar oda içerikleri ürünüyle aynı sözlükten gelecek. Otelin çevresindeki plaj veya havalimanı gibi noktalar ise olanak değil, konum ve POI verisidir.
Ürün açıldığında olanaklar API’de otel içeriği yanıtıyla birlikte ve tüm envanter için dump dosyalarında teslim edilecek. Erken erişim, kapsam ve fiyat için teklif alabilirsiniz.
İstek
curl "https://api.hotelmapping.org/v1/hotels/HM-1048213/content?include=amenities&lang=tr" \
-H "X-API-Key: $HM_API_KEY" Yanıt
{
"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" }
]
}
} Kod örnekleri temsilidir; alan adları v1 yayınında değişebilir.
Otel olanakları yakında kullanıma açılacak; kesin tarih henüz paylaşılmadı. Erken erişim için teklif sayfasından bize yazabilirsiniz.
Havuz, spa, özel plaj, aquapark, fitness, otopark ve toplantı salonu gibi tesis olanakları; klima, balkon, minibar, kasa, kahve makinesi ve küvet gibi oda olanakları ile engelli erişimi, asansör ve erişilebilir oda bilgileri.
Tedarikçiler aynı olanağı farklı adlarla gönderir. Standart kod olmadan filtreler bazı otelleri kaçırır ya da yanlış otelleri gösterir.
Oda tipine özel olanaklar oda içerikleri ürününde, standart oda kimliğiyle birlikte gelecek. İki ürün aynı olanak sözlüğünü kullanır.
Evet. Farklı tedarikçilerden gelen olanaklar ancak aynı otelin kayıtları tek HM ID'de toplandıktan sonra birleştirilebilir.
Teklif al
Talebinizi üç adımda gönderin; teklifi iş e-postanıza iletelim. Talep bağlayıcı değildir.