Otel eşleştirme çözümü
Her tesise kalıcı bir HM ID; tedarikçi kodları ve çapraz ID'ler tek kayıtta.
Oda eşleştirme, tedarikçilerin aynı oda için gönderdiği farklı adları oda tipi, sınıf, manzara, yatak, özellik ve kapasite etiketlerine ayırır ve aynı odayı otelin HM ID'sine bağlı tek bir oda kimliğinde (ör. HM-1048213-R03) toplar. Böylece aynı odanın farklı tedarikçi fiyatları yan yana karşılaştırılabilir.
{
"room_id": "HM-1048213-R03",
"hm_id": "HM-1048213",
"name": "Standard Double Room, Sea View, Balcony",
"type": "room",
"class": "standard",
"view": "sea",
"bed": "double",
"features": ["balcony"],
"max_occupancy": 3,
"supplier_rooms": {
"A": "DBLSV-B",
"B": "DZMB",
"C": "STD-DNZ"
}
} "DBL SV BLC", "DZ Meerblick Balkon" ve "Deniz Manzaralı Balkonlu Çift Kişilik Oda" aynı oda kimliğine bağlanır; fiyatlar tek satırda karşılaştırılır.
TR, EN, DE ve RU oda kısaltmaları ve yazım biçimleri kural sözlüğünde tutulur; sözlüğün yetmediği yerde etiketleme modeli devreye girer.
Her oda adı altı etikete ayrılır. Manzara, yatak tipi veya kapasiteye göre filtreleme ve sıralama ayrı bir ayrıştırma gerektirmez.
Kara manzaralı ve deniz manzaralı odaların etiketleri farklıdır; bu yüzden ayrı oda kimliklerinde kalır ve aynı satırda gösterilmez.
Tek bir istekte birkaç oda adı anında eşleştirilir; tüm envanter için toplu işlem ve dosya teslimi de yapılır.
Aynı oda için üç tedarikçiden gelen adlar
supplier,hotel_code,room_code,room_name
A,HTL-88213,DBLSV-B,Dbl Sea View Balcony
B,40917,DZMB,DZ Meerblick Balkon
C,TR-ANT-551,STD-DNZ,Standart Oda Deniz Manzaralı Balkonlu (2+1) Etiketlere ayrılmış tek oda kaydı
{
"room_id": "HM-1048213-R03",
"hm_id": "HM-1048213",
"name": "Standard Double Room, Sea View, Balcony",
"type": "room",
"class": "standard",
"view": "sea",
"bed": "double",
"features": ["balcony"],
"max_occupancy": 3,
"supplier_rooms": {
"A": "DBLSV-B",
"B": "DZMB",
"C": "STD-DNZ"
}
} Örnek veridir; otel, oda adları ve kodlar gerçek bir tesise ait değildir.
Oda adı kelimelere ve kısaltmalara ayrılır. Büyük-küçük harf, noktalama, parantez içi kapasite ("2+1") ve dil farkları normalleştirilir.
Her parça TR, EN, DE ve RU kısaltma sözlüğüyle eşlenir: "SV", "Meerblick" ve "Deniz Manzaralı" aynı manzara etiketine düşer.
Sözlükte olmayan veya birden fazla anlama gelen parçaları bir etiketleme modeli tip, sınıf, manzara, yatak, özellik ya da kapasiteye atar.
Aynı HM ID'ye bağlı odalar etiketlerine göre karşılaştırılır. Etiketleri uyuşan adlar aynı oda kimliğine bağlanır; çelişen kayıtlar insan kontrolüne gider.
Sonuç API yanıtında anında, toplu işlerde ise dosya olarak döner. Her tedarikçi oda kodu, bağlandığı oda kimliğiyle birlikte saklanır.
Her tedarikçi oda adını kendi sisteminin kurallarına göre yazar. Biri kısaltma kullanır (“DBL SV BLC”), biri Alman tur operatörü katalog dilini kullanır (“DZ Meerblick”), biri oteldeki Türkçe adı olduğu gibi gönderir. Bir otelde 10 oda tipi ve 5 tedarikçi varsa eşleştirilecek ad sayısı 50’ye çıkar. Elle eşleştirme yavaştır; manzara veya kapasite farkı kolayca gözden kaçar.
Oda eşleştirme her adı aynı altı etikete ayırır ve karşılaştırmayı adlar yerine bu etiketler üzerinden yapar. Konunun ayrıntılı anlatımı için oda eşleştirme nedir rehberine, genel çerçeve için otel eşleştirme rehberine bakabilirsiniz.
| Etiket | Ne anlatır | Örnek değerler |
|---|---|---|
| Tip | Oda kategorisi | Oda, süit, junior süit, stüdyo, aile odası, villa, bungalov, apart |
| Sınıf | Konfor seviyesi | Ekonomi, standart, superior, deluxe |
| Manzara | Pencereden görünen | Deniz, yan deniz, kara, bahçe, havuz |
| Yatak | Yatak düzeni | Tek kişilik (single), çift kişilik (double), iki ayrı yatak (twin), king, queen |
| Özellik | Ek donanım | Balkon, teras, jakuzi, havuza açılan oda, bağlantılı oda |
| Kapasite | En fazla kişi sayısı | SGL = 1, DBL = 2, TRP = 3, QUAD = 4; 2+1, 2+2 |
Kural sözlüğü aynı kavramın dört dildeki yazımlarını tek etikete bağlar. Aşağıdaki satırlar örnektir; tam liste oda tipi kısaltmaları rehberindedir.
| Kavram | EN | DE | TR | RU |
|---|---|---|---|---|
| Tek kişilik kullanım (kapasite 1) | SGL | EZ (Einzelzimmer) | Tek kişilik | одноместный |
| İki kişilik kullanım (kapasite 2) | DBL | DZ (Doppelzimmer) | Çift kişilik | двухместный |
| İki ayrı yatak (yatak: twin) | TWN | 2 Einzelbetten | İki ayrı yataklı | две кровати |
| Aile odası | FAM | FZ (Familienzimmer) | Aile odası | семейный номер |
| Deniz manzarası | SV | Meerblick | Deniz manzaralı | вид на море |
| Balkon | BLC | Balkon | Balkonlu | балкон |
| Süit | STE | Suite | Süit | люкс |
DBL çoğu tedarikçide iki kişilik odayı belirtir; yatak tipini her zaman söylemez. Bu yüzden “DBL” önce kapasite olarak okunur (en az 2 kişi). Adda TWN veya “twin” yoksa yatak etiketi double olur; “king” gibi daha açık bir ipucu varsa o kullanılır. Tip etiketi ise oda kategorisidir: “DBL Sea View” bir oda (room), “Junior Suite” bir junior süittir.
Oda eşleştirme yalnız aynı otelin odaları arasında çalışır; bu yüzden önce otel eşleştirme ile otelin HM ID’si belirlenir. Fiyat karşılaştırmasının doğru olması için oda ile birlikte pansiyon tipi eşleştirme de gerekir. Terimler için oda eşleştirme ve tedarikçi kodu sözlük sayfalarına bakabilirsiniz.
İstek
curl -X POST https://api.hotelmapping.org/v1/rooms/map \
-H "X-API-Key: $HM_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"hm_id": "HM-1048213",
"rooms": [
{ "supplier": "B", "code": "DZMB", "name": "DZ Meerblick Balkon" },
{ "supplier": "B", "code": "FZLS", "name": "FZ Landseite" }
]
}' Yanıt
{
"hm_id": "HM-1048213",
"groups": [
{
"room_id": "HM-1048213-R03",
"type": "room",
"class": "standard",
"view": "sea",
"bed": "double",
"features": ["balcony"],
"max_occupancy": 3,
"matched": [
{ "supplier": "B", "code": "DZMB", "name": "DZ Meerblick Balkon", "confidence": 0.98, "decision": "auto_match" }
]
},
{
"room_id": "HM-1048213-R07",
"type": "family_room",
"class": "standard",
"view": "land",
"bed": null,
"features": [],
"max_occupancy": 4,
"matched": [
{ "supplier": "B", "code": "FZLS", "name": "FZ Landseite", "confidence": 0.91, "decision": "review" }
]
}
]
} Kod örnekleri temsilidir; alan adları v1 yayınında değişebilir.
Evet. Oda adları yalnız aynı otelin odalarıyla karşılaştırılır. Bu yüzden önce otelin HM ID'si belirlenir, ardından o otele ait tedarikçi oda adları gruplanır.
Yeni ad yeniden etiketlenir. Etiketler değişmediyse aynı oda kimliğine bağlı kalır. Değiştiyse kayıt kontrol kuyruğuna düşer ve gerekirse başka bir oda kimliğine bağlanır.
Otel eşleştirmedeki eşik mantığının oda için de uygulanması planlanıyor: 0,97 ve üstü otomatik bağlanır, 0,80–0,97 arası bir uzmana gider, 0,80 altı yeni bir oda kaydı açar. Uzman kararları sözlüğe ve modele geri beslenir.
Kural sözlüğü lansmanda Türkçe, İngilizce, Almanca ve Rusça kısaltmaları kapsar. Arapça ve diğer diller için kapsam henüz kesinleşmedi.
Hayır. Oda eşleştirme yalnız statik oda verisini standartlaştırır. Fiyat ve müsaitlik tedarikçiden sizin sisteminize gelir; biz yalnız hangi odaya ait olduğunu söyleriz.
Teklif al
Talebinizi üç adımda gönderin; teklifi iş e-postanıza iletelim. Talep bağlayıcı değildir.