Otel eşleştirme çözümü
Her tesise kalıcı bir HM ID; tedarikçi kodları ve çapraz ID'ler tek kayıtta.
Find Match API, elinizdeki tek bir otel kaydını (ad, adres, koordinat, varsa telefon ve web adresi) alır ve hotelmapping.org veritabanındaki karşılığını bulur. Yanıtta eşleşen HM ID, 0–1 arası güven skoru ve bu skora göre verilen karar döner. Tedarikçi kodu olmayan kayıtlar için de çalışır.
{
"reference": "K-0192",
"normalized_name": "lara palm",
"decision": "auto_match",
"hm_id": "HM-1052207",
"name": "Lara Palm Hotel",
"confidence": 0.973,
"signals": {
"name_similarity": 0.95,
"distance_m": 63,
"phone_match": true
}
} Kontratlı otelleriniz, extranet kayıtlarınız veya serbest metin bir otel adı için ad ve konum bilgisi yeterlidir.
Her yanıtta güven skoru ve karar alanı döner. Hangi kaydı otomatik kabul edeceğinizi kendi iş kuralınızla da sınırlayabilirsiniz.
Kısaltmalar, eksik ekler, Kiril ve Arap harfli adlar normalleştirmeden geçer. "Rsrt." ile "Resort" gibi farklar ad benzerliğinde karakter ve kelime düzeyinde karşılaştırılır.
En olası adaylar mesafe ve skorlarıyla birlikte döner; kontrol gereken kayıtlarda karar vermek kolaylaşır.
Acentenin kendi sisteminden, tedarikçi kodu olmayan kayıt
internal_id,name,city,lat,lng,phone
K-0192,Отель Лара Палм,Анталья,36.8567,30.7969,0242 000 00 00 Find Match API sonucu
{
"reference": "K-0192",
"normalized_name": "lara palm",
"decision": "auto_match",
"hm_id": "HM-1052207",
"name": "Lara Palm Hotel",
"confidence": 0.973,
"signals": {
"name_similarity": 0.95,
"distance_m": 63,
"phone_match": true
}
} Örnek veridir; otel adı, telefon ve kodlar gerçek bir tesise ait değildir. Rusça ad Latin harfe çevrilip "otel" eki ayrıldıktan sonra karşılaştırılır.
POST /v1/match ucuna otel adı ve konum bilgisi gönderilir. Koordinat, adres, telefon ve web adresi eklendikçe eşleşme güçlenir.
Addan "Hotel", "Resort & Spa", "Otel" gibi ekler ayrılır; Rusça ve Arapça adlar Latin harfe çevrilir; telefon uluslararası biçime, web adresi alan adına indirgenir.
Kayıt yalnız yakınındaki otellerle karşılaştırılır: yaklaşık 500 metrelik coğrafi hücre, ad benzerliği, aynı telefon veya alan adı.
Ad benzerliği, çok dilli embedding benzerliği, mesafe, telefon ve web eşleşmesi, yıldız ve posta kodu birleşerek 0–1 arası bir olasılık skoru üretir.
Skor 0,97 ve üstüyse auto_match, 0,80–0,97 arasıysa review, 0,80 altındaysa no_match döner; no_match yanıtında hm_id null olur. Yanıtta en olası adaylar da yer alır.
Otel eşleştirme ürünü tedarikçi dosyalarını toplu olarak HM ID’ye bağlar. Find Match API ise tek bir kaydı anında sorgulamak içindir. Tipik kullanım alanları:
Eşleştirmenin genel mantığını otel eşleştirme rehberinde anlatıyoruz.
| Güven skoru | decision |
Ne yapmalı? |
|---|---|---|
| 0,97 ve üstü | auto_match |
HM ID’yi doğrudan kullanabilirsiniz |
| 0,80–0,97 | review |
Adayları kontrol edin; ad, mesafe ve telefon farklarına bakın |
| 0,80 altı | no_match |
hm_id null döner. Tesis veritabanında henüz olmayabilir; adı ve konumu kontrol edin |
Eşikler elle etiketlenmiş test setine göre ayarlanır ve sürümler arasında değişebilir. Skorun hangi sinyallerden oluştuğunu eşleşme skoru teriminde açıklıyoruz.
reference alanını kullanın. Kendi kayıt kimliğiniz yanıtta aynen döner; sonuçları kendi tablonuza bağlamak kolaylaşır.Binlerce kaydı tek tek sorgulamak yerine dosyanızı otel eşleştirme akışına verin; sonuç günlük tam ve delta dump ile döner. Find Match API 0,80 altındaki kayıt için yeni kimlik açmaz; toplu alım akışında ise bu kayıtlar için yeni bir HM ID açılır (new_id kararı). Bulunan HM ID ile destinasyon ve otel içeriği verisine de ulaşırsınız.
Yanıt alanları API v1 taslağıdır; kesin şema geliştirici sayfasında yayımlanır.
İstek
curl -X POST https://api.hotelmapping.org/v1/match \
-H "X-API-Key: $HM_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"reference": "res-55821",
"name": "Sunset Bay Rsrt. & Spa - Adults",
"city": "Belek",
"country": "TR",
"lat": 36.8539,
"lng": 31.0556
}' Yanıt
{
"reference": "res-55821",
"decision": "auto_match",
"hm_id": "HM-1048213",
"name": "Sunset Bay Resort & Spa",
"confidence": 0.984,
"candidates": [
{ "hm_id": "HM-1048213", "confidence": 0.984, "distance_m": 42 },
{ "hm_id": "HM-1048390", "confidence": 0.412, "distance_m": 310 }
]
} Kod örnekleri temsilidir; alan adları v1 yayınında değişebilir.
Tedarikçi kodu sorgulaması (GET /v1/suppliers/{supplier}/codes/{code}) daha önce eşleştirilmiş bir kodun HM ID'sini doğrudan getirir. Find Match API ise kodu olmayan ya da sistemde bilinmeyen bir kaydı ad, adres ve koordinatla arar ve yeni bir skor hesaplar.
Otel adı ve konum bilgisi (koordinat ya da ülke, şehir ve adres) gerekir. Telefon, web adresi ve posta kodu isteğe bağlıdır ama skoru güçlendirir.
Yanıttaki adayları ad, mesafe ve skorla karşılaştırın. Karar veremediğiniz kayıtları uzman kontrolüne göndermenin yolu (portal veya API) henüz kesinleşmedi. Uzman kararları modele eğitim verisi olarak eklenir.
Evet. Kiril ve Arap harfli adlar normalleştirme sırasında Latin harfe çevrilir; çok dilli embedding benzerliği de skora katılır. Adı sizin ayrıca çevirmeniz gerekmez.
Sandbox hesabıyla örnek veri üzerinde deneyebilirsiniz.
Teklif al
Talebinizi üç adımda gönderin; teklifi iş e-postanıza iletelim. Talep bağlayıcı değildir.