Otel eşleştirme çözümü

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.

Neler kazanırsınız

  • Her otel listede bir kez

    Aynı otelin farklı tedarikçi kayıtları tek kartta toplanır; en uygun teklif tek yerde görünür.

  • Kalıcı kimlik

    HM ID asla başka bir otele yeniden verilmez. Birleşen oteller eski ID'yi yeni ID'ye yönlendirir.

  • Mevcut ID'leriniz korunur

    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 tedarikçi hızla devrede

    Yeni bir tedarikçi dosyası normalleştirme ve skorlamadan geçip kısa sürede HM ID'lere bağlanır.

Önce ve sonra

Üç tedarikçiden gelen ham kayıt

supplier_static.csv
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

GET /v1/hotels/HM-1048213
{
  "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.

Nasıl çalışır

  1. 1

    Veri alma

    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.

  2. 2

    Normalleştirme

    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.

  3. 3

    Aday üretme ve skorlama

    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.

  4. 4

    Karar ve insan kontrolü

    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.

  5. 5

    Teslim

    Sonuç REST API ve günlük tam ve delta dump (CSV, JSON, Parquet) ile size ulaşır; webhook planlanıyor.

Otel eşleştirme neden gerekli?

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.

Neleri bağlıyoruz?

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

Kalite nasıl ölçülüyor?

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.

Otel eşleştirme nedir? Kapsamlı rehber

API örneği

İstek

Tedarikçi kodundan HM ID'ye
curl https://api.hotelmapping.org/v1/suppliers/B/codes/40917 \
  -H "X-API-Key: $HM_API_KEY"

Yanıt

200 OK
{
  "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.

Sık sorulan sorular

HM ID ile tedarikçi kodu arasındaki fark nedir?

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.

Yanlış eşleşme olursa ne oluyor?

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.

Otel kapanırsa veya iki otel birleşirse HM ID ne olur?

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.

Başka bir eşleştirme sağlayıcısından geçerken mevcut otel kimliklerimizi kullanmaya devam edebilir miyiz?

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

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