Otel factsheet çözümü
Giriş-çıkış saati, plaj, havuz ve çocuk politikası gibi otel bilgileri, HM ID'ye bağlı ayrı alanlarda.
Otel açıklamaları, her HM ID için çok dilli ve satışa hazır tanıtım metni sunar. Her otel için kısa, orta ve uzun olmak üzere üç sürüm vardır; ilk diller Türkçe, İngilizce, Almanca, Rusça ve Arapça. Metinler otelin factsheet verisinden ve tedarikçi metinlerinden üretilir, editör kontrolünden geçer, API ve dump dosyalarıyla teslim edilir.
{
"hm_id": "HM-1048213",
"lang": "tr",
"available_langs": ["tr", "en", "de", "ru", "ar"],
"descriptions": {
"short": "Belek'te, otele ait kum plaja 250 metre mesafede, üç açık havuzlu resort otel.",
"medium": "Sunset Bay Resort & Spa, Antalya'nın Belek bölgesinde, otele ait kum plaja 250 metre uzaklıktadır. 412 odalı tesiste üç açık ve bir kapalı havuz bulunur.",
"long": "Sunset Bay Resort & Spa, Belek'in sahil şeridinde yer alır. (Örnekte kısaltıldı.)"
}
} Kısa metin arama sonuç kartına, orta metin otel sayfasının üstüne, uzun metin detay bölümüne uyar. Metni her ekran için ayrıca kırpmanız gerekmez.
Türkçe, İngilizce, Almanca, Rusça ve Arapça açıklamalar aynı doğrulanmış bilgiye dayanır. Yeni bir pazara açılırken içeriği sıfırdan yazdırmazsınız.
Taslağı yapay zekâ üretir, editörler doğruluk ve üslup açısından kontrol eder. Saat, sayı ve politika gibi bilgiler factsheet alanlarından gelir.
Her açıklama bir HM ID'ye bağlıdır. Tedarikçi değiştirseniz veya yeni tedarikçi ekleseniz de metin aynı otelde kalır.
Üç tedarikçiden gelen otel metni
[A / HTL-88213] lang=en
Nice hotel near the beach. Great pools!! Check-in 14:00.
Great pools and great food. Close to the beach.
[B / 40917] lang=tr
Belek'te 5 yıldızlı otel.
[C / TR-ANT-551] lang=de
(açıklama yok) HM ID altında üç uzunlukta açıklama
{
"hm_id": "HM-1048213",
"lang": "tr",
"available_langs": ["tr", "en", "de", "ru", "ar"],
"descriptions": {
"short": "Belek'te, otele ait kum plaja 250 metre mesafede, üç açık havuzlu resort otel.",
"medium": "Sunset Bay Resort & Spa, Antalya'nın Belek bölgesinde, otele ait kum plaja 250 metre uzaklıktadır. 412 odalı tesiste üç açık ve bir kapalı havuz bulunur.",
"long": "Sunset Bay Resort & Spa, Belek'in sahil şeridinde yer alır. (Örnekte kısaltıldı.)"
}
} Örnek veridir; otel ve kodlar gerçek bir tesise ait değildir. Tekrar eden ve abartılı ifadeler ayıklanır; metindeki mesafe ve sayılar factsheet alanlarından gelir.
Otel eşleştirmeyle tek HM ID'de birleşen otelin tüm tedarikçi metinleri ve factsheet verisi bir araya getirilir.
Yapay zekâ, factsheet verisinden ve tedarikçi metinlerinden kısa, orta ve uzun açıklama üretir; tekrar eden ve çelişen ifadeler ayıklanır.
Editörler metni doğruluk ve üslup açısından kontrol eder. Tüm diller aynı bilgiye dayanır.
Tesis bilgisi değiştiğinde açıklama da güncellenir; metin factsheet ile çelişir hâle gelmez.
Açıklamalar GET /v1/hotels/{hm_id}/content ucundan dil parametresiyle döner; tüm envanter günlük tam ve delta dump dosyalarında gelir.
Eşleştirme aynı oteli tek HM ID’de birleştirir; tanıtım metni ise hâlâ tedarikçi sayısı kadar farklıdır. Bir tedarikçi yalnız İngilizce ve tekrar eden cümleler gönderir, diğeri tek satırlık bir Türkçe not, üçüncüsü hiç metin göndermez. Otel sayfası hangi tedarikçinin içeriği kullanıldığına göre değişir; Almanca veya Rusça konuşan bir pazara açılmak istediğinizde metni sıfırdan yazdırmanız gerekir.
Otel açıklamaları bu farkı HM ID düzeyinde kapatır: her otel için tek, tutarlı ve satışa hazır bir metin. Bunun ön koşulu oteli doğru eşleştirmektir; yöntemi otel eşleştirme rehberinde, ürünü otel eşleştirme sayfasında bulabilirsiniz.
| Sürüm | Biçim | Nerede kullanılır? |
|---|---|---|
| Kısa | Tek cümle | Arama sonuç kartı, harita kartı |
| Orta | Tek paragraf | Otel sayfasının üst bölümü |
| Uzun | Birkaç paragraf | Detay sekmesi: konum, odalar, yeme-içme, olanaklar |
Her sürüm aynı bilgiye dayanır. Kısa metin, uzun metnin kırpılmış hâli değildir; kendi alanı için ayrıca yazılır.
Açıklama, otelin tüm tedarikçi kayıtlarından derlenen doğrulanmış bilgiye dayanır. Saat, sayı, mesafe ve politika gibi bilgiler otel factsheet alanlarından gelir. Böylece metinde geçen bir giriş saati veya plaj mesafesi, factsheet’teki değerle çelişmez.
Taslağı yapay zekâ üretir; tekrar eden, abartılı ve birbiriyle çelişen ifadeler ayıklanır. Ardından editörler metni doğruluk ve üslup açısından kontrol eder. Tesis bilgisi değiştiğinde açıklama da güncellenir.
İlk sürümde Türkçe, İngilizce, Almanca, Rusça ve Arapça açıklama sunulur. Tüm diller aynı bilgiden üretildiği için bir dildeki sayfa ile diğerindeki sayfa aynı oteli anlatır.
Açıklamalar otel bazında REST API ile, tüm envanter için günlük tam ve delta dump dosyalarıyla teslim edilir. Örnekteki include ve lang parametreleri API v1 taslağıdır; kesin şema geliştirici sayfasında yayımlanır.
Filtreleme ve karşılaştırma için gereken yapılandırılmış bilgiler otel factsheet ürünündedir. Otelin fotoğraf galerisi otel resimleri hizmetinde tekilleştirilir ve kategoriyle etiketlenir. Kapsam ve fiyat için teklif alabilirsiniz.
İstek
curl "https://api.hotelmapping.org/v1/hotels/HM-1048213/content?include=descriptions&lang=en" \
-H "X-API-Key: $HM_API_KEY" Yanıt
{
"hm_id": "HM-1048213",
"lang": "en",
"available_langs": ["tr", "en", "de", "ru", "ar"],
"descriptions": {
"short": "Resort hotel in Belek, 250 m from its private sandy beach, with three outdoor pools.",
"medium": "Sunset Bay Resort & Spa is in Belek, Antalya, 250 metres from the hotel's private sandy beach. The 412-room property has three outdoor pools and one indoor pool.",
"long": "Sunset Bay Resort & Spa sits on the Belek coastline. (Shortened in this example.)"
},
"updated_at": "2026-11-02T08:14:00Z"
} Kod örnekleri temsilidir; alan adları v1 yayınında değişebilir.
İlk diller Türkçe, İngilizce, Almanca, Rusça ve Arapça. Tüm diller aynı doğrulanmış bilgiye dayanır. Yeni dillerin takvimi henüz kesinleşmedi.
Metni yapay zekâ üretir; editörler doğruluk ve üslup açısından kontrol eder. Saat, sayı ve politika gibi bilgiler yapılandırılmış factsheet verisinden gelir.
Açıklama okunmak için yazılmış metindir. Factsheet ise giriş-çıkış saati, plaj, havuz ve çocuk politikası gibi bilgileri filtreleme ve karşılaştırma için ayrı alanlarda verir. İkisi aynı veriye dayanır.
Otel bazında REST API ile, tüm envanter için günlük tam ve delta dump dosyalarıyla. Değişiklik bildirimi için webhook planlanıyor.
İçeriğin kullanım ve lisans koşulları sözleşmede belirlenir.
Teklif al
Talebinizi üç adımda gönderin; teklifi iş e-postanıza iletelim. Talep bağlayıcı değildir.