Oda eşleştirme çözümü
Oda adlarını tip, sınıf, manzara, yatak ve kapasiteye ayırır; aynı odayı tek oda ID'sinde toplar.
Otel eşleştirme, farklı tedarikçilerin aynı otel için gönderdiği farklı ad, kod ve adresleri tek bir kalıcı kimlikte (HM ID) birleştirir. Tedarikçi kodları, Google Place ID ve koordinat bu kimliğe bağlanır; mevcut eşleştirme sağlayıcınızın veya kendi sisteminizin otel kimlikleri de çapraz referans olarak saklanır. Böylece her otel listenizde yalnız bir kez görünür.
{
"hm_id": "HM-1048213",
"name": "Sunset Bay Resort & Spa",
"destination_id": "TR-07-SERIK-BELEK",
"destination": ["TR", "Antalya", "Serik", "Belek"],
"geo": { "lat": 36.8541, "lng": 31.0552 },
"supplier_codes": {
"A": "HTL-88213",
"B": "40917",
"C": "TR-ANT-551"
},
"external_ids": { "client": "OTL-2231" },
"status": "active"
} Aynı otelin farklı tedarikçi kayıtları tek kartta toplanır; en uygun teklif tek yerde görünür.
HM ID asla başka bir otele yeniden verilmez. Birleşen oteller eski ID'yi yeni ID'ye yönlendirir.
Mevcut eşleştirme sağlayıcınızın veya kendi sisteminizin otel kimliklerini çapraz referans olarak saklarız; bugüne kadar yaptığınız eşleştirmeyi kaybetmezsiniz.
Yeni bir tedarikçi dosyası normalleştirme ve skorlamadan geçip kısa sürede HM ID'lere bağlanır.
Üç tedarikçiden gelen ham kayıt
supplier,code,name,city,lat,lng
A,HTL-88213,Sunset Bay Resort & Spa,Belek,36.8541,31.0552
B,40917,SUNSET BAY RESORT SPA,Serik,36.8543,31.0549
C,TR-ANT-551,Sunset Bay Rsrt. & Spa - Adults,Antalya,36.8539,31.0556 Tek HM ID altında standart kayıt
{
"hm_id": "HM-1048213",
"name": "Sunset Bay Resort & Spa",
"destination_id": "TR-07-SERIK-BELEK",
"destination": ["TR", "Antalya", "Serik", "Belek"],
"geo": { "lat": 36.8541, "lng": 31.0552 },
"supplier_codes": {
"A": "HTL-88213",
"B": "40917",
"C": "TR-ANT-551"
},
"external_ids": { "client": "OTL-2231" },
"status": "active"
} Örnek veridir; otel adı ve kodlar gerçek bir tesise ait değildir.
Tedarikçi statik verisini API, CSV veya FTP ile alırız. Her kayıt ham haliyle saklanır, değişiklikler sürümlenir.
Otel adından "Hotel", "Resort & Spa" gibi ekler ayrılır; Rusça ve Arapça adlar Latin harfe çevrilir; adres, telefon ve web adresi standart biçime getirilir.
Her kayıt yalnız yakınındaki otellerle karşılaştırılır. Ad benzerliği, çok dilli embedding, mesafe, telefon ve web eşleşmesi birleşerek 0–1 arası bir olasılık skoru verir.
Skor 0,97 ve üstüyse otomatik eşleşme olur; 0,80–0,97 arası kayıtlar haritalı kontrol ekranında bir uzmana düşer; 0,80 altı yeni bir HM ID açar.
Sonuç REST API ve günlük tam ve delta dump (CSV, JSON, Parquet) ile size ulaşır; webhook planlanıyor.
Bir acente ortalama birkaç tedarikçiyle çalışır ve her tedarikçi aynı oteli kendi adıyla, kendi koduyla ve kendi koordinatıyla gönderir. Eşleştirme yapılmadığında aynı otel listede birden fazla kez görünür, fiyat karşılaştırması bozulur ve müşteri hangi kartın doğru olduğunu anlayamaz.
hotelmapping.org dünya çapında 3,5 milyon otel ile çalışır ve bu kayıtları tek bir kalıcı kimlikte, HM ID’de birleştirir. Siz yalnız HM ID ile çalışırsınız; hangi tedarikçinin hangi kodu kullandığını biz takip ederiz.
| Alan | Açıklama |
|---|---|
| Tedarikçi kodları | Her tedarikçinin otel kodu, HM ID’ye bağlı |
| Harici otel kimlikleri | Mevcut eşleştirme sağlayıcınızın veya kendi sisteminizin kimlikleri; varsa çapraz referans olarak saklanır |
| Google Place ID | Konum ve kimlik için ek referans |
| Koordinat | Tedarikçi kayıtlarından seçilen enlem ve boylam (koordinat doğrulama planlanıyor) |
| Destinasyon | Ülke → il → ilçe → resort bölgesi hiyerarşisi |
Eşleştirme kalitesi elle etiketlenmiş bir test setiyle her sürümde ölçülür. Sitede yalnız bu ölçümle doğrulanmış rakamları yayınlarız; güncel değerler kapsam sayfasında yer alır.
İstek
curl https://api.hotelmapping.org/v1/suppliers/B/codes/40917 \
-H "X-API-Key: $HM_API_KEY" Yanıt
{
"supplier": "B",
"code": "40917",
"hm_id": "HM-1048213",
"confidence": 0.998,
"matched_at": "2026-11-02T08:14:00Z"
} Kod örnekleri temsilidir; alan adları v1 yayınında değişebilir.
Tedarikçi kodu yalnız o tedarikçinin sisteminde geçerlidir ve tedarikçiye göre değişir. HM ID ise aynı otelin tüm tedarikçi kodlarını bir araya getiren, bizim verdiğimiz kalıcı kimliktir.
Emin olunmayan skorlar otomatik eşleşmez, insan kontrolüne düşer. Yine de bir hata bildirirseniz kayıt düzeltilir ve bu karar modele eğitim verisi olarak eklenir.
HM ID asla başka bir otele verilmez. Kapanan otelin durumu "closed" olur. Birleşen otellerde eski ID'nin durumu "merged" olur ve merged_into alanı yeni ID'yi gösterir.
Evet. Mevcut eşleştirme sağlayıcınızın veya kendi sisteminizin otel kimliklerini çapraz referans olarak saklarız; bu kimlikler API yanıtında external_ids alanında HM ID ile birlikte döner. Böylece mevcut eşleştirmenizi bırakmadan HM ID'ye geçebilirsiniz.
Teklif al
Talebinizi üç adımda gönderin; teklifi iş e-postanıza iletelim. Talep bağlayıcı değildir.