Yakında

Otel olanakları çözümü

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.

Neler kazanırsınız

  • Tek sözlük

    Tüm tedarikçilerin olanakları aynı kod setinde toplanır; "özel plajı olan oteller" filtresi hangi kaynaktan gelirse gelsin aynı çalışır.

  • Çok dilli girdi

    Türkçe, İngilizce, Almanca veya başka bir dilde gelen olanak adları aynı koda bağlanır.

  • Tesis, oda ve erişilebilirlik ayrı

    Havuz gibi tesis olanakları, klima gibi oda olanakları ve engelli erişimi bilgileri ayrı alanlarda gelir.

  • Oda içerikleriyle ortak sözlük

    Oda olanakları, oda içerikleri ürünüyle aynı sözlükten gelir; bir oda tipinin olanakları ile otelin olanak listesi çelişmez.

  • Eşleşmiş otel üzerinde

    Olanaklar, dünya genelinde 3,5 milyon otelin eşleştirildiği HM ID altyapısı üzerinde çalışacak.

Önce ve sonra

Aynı otel için üç tedarikçiden gelen olanak adları

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)

Standart kodlara çevrilmiş olanaklar

HM-1048213 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.

Nasıl çalışır

  1. 1

    Olanak adlarını toplama

    Tedarikçilerin gönderdiği tesis ve oda olanakları, otel eşleştirmeyle belirlenen HM ID altında bir araya getirilir.

  2. 2

    Standart koda çevirme

    "Free WiFi", "WLAN kostenlos" ve "Ücretsiz kablosuz internet" gibi farklı adlar tek bir olanak koduna bağlanır.

  3. 3

    Tesis ve oda olarak ayırma

    Her olanak tesis ya da oda seviyesine ayrılır; erişilebilirlik bilgileri ayrı alanlarda tutulur.

  4. 4

    Doğrulama ve güncelleme

    Belirsiz eşleşmeleri veri ekibi doğrular. Olanaklar API'den döner, değişiklikler delta dump ile gelir.

Otel olanakları neyi çözer?

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.

Ürün durumu

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.

Kapsam

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.

Nerede kullanılır?

  • Arama filtreleri: “Özel plajı olan”, “aquaparklı” ya da “evcil hayvan kabul eden” otel filtreleri tüm kaynaklarda aynı veriyle çalışır.
  • Otel karşılaştırması: Kullanıcılar otelleri aynı olanak listesi üzerinden karşılaştırır.
  • Erişilebilirlik bilgisi: Engelli erişimine uygun oteller ve odalar ayrı alanlardan net biçimde gösterilir.

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.

Erken erişim

Ü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.

Otel eşleştirme nedir? Kapsamlı rehber

API örneği

İstek

API v1 taslağı: otel olanaklarını isteme
curl "https://api.hotelmapping.org/v1/hotels/HM-1048213/content?include=amenities&lang=tr" \
  -H "X-API-Key: $HM_API_KEY"

Yanıt

200 OK (taslak 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.

Sık sorulan sorular

Otel olanakları ne zaman kullanıma açılacak?

Otel olanakları yakında kullanıma açılacak; kesin tarih henüz paylaşılmadı. Erken erişim için teklif sayfasından bize yazabilirsiniz.

Hangi olanaklar kapsanıyor?

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.

Olanak eşleştirme neden gerekli?

Tedarikçiler aynı olanağı farklı adlarla gönderir. Standart kod olmadan filtreler bazı otelleri kaçırır ya da yanlış otelleri gösterir.

Oda olanakları her oda tipine ayrı mı bağlanıyor?

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.

Olanaklar için otel eşleştirme gerekli mi?

Evet. Farklı tedarikçilerden gelen olanaklar ancak aynı otelin kayıtları tek HM ID'de toplandıktan sonra birleştirilebilir.

Teklif al

Size özel teklifi alın

Talebinizi üç adımda gönderin; teklifi iş e-postanıza iletelim. Talep bağlayıcı değildir.

  1. 1 Çözümleri seçin
  2. 2 Tedarikçileri seçin
  3. 3 İletişim bilgilerinizi bırakın