Otel açıklamaları çözümü
Her otel için TR, EN, DE, RU ve AR dillerinde kısa, orta ve uzun, satışa hazır açıklama.
Otel factsheet, bir otelin temel bilgilerini serbest metin yerine ayrı ve filtrelenebilir alanlarda verir: tesis tipi, yıldız, oda sayısı, giriş-çıkış saatleri, plaj ve havuzlar, çocuk ve evcil hayvan politikası, restoranlar ve iletişim bilgileri. Tüm tedarikçilerden gelen bilgi otelin HM ID'si altında birleşir, çelişen değerler işaretlenir; veri API ve dump dosyalarıyla teslim edilir.
{
"hm_id": "HM-1048213",
"factsheet": {
"check_in": "14:00",
"check_out": "12:00",
"room_count": 412,
"beach": { "type": "sand", "private": true, "distance_m": 250 },
"pools": { "outdoor": 3, "indoor": 1 },
"child_policy": { "free_from_age": 0, "free_to_age": 6.99 },
"pets_allowed": false,
"review_flags": ["check_in", "room_count"]
}
} Giriş saati, çocuk politikası, plaj tipi ve oda sayısı ayrı alan olduğu için filtre ve karşılaştırmada doğrudan kullanılır.
Bir otelin tüm tedarikçilerdeki bilgisi tek HM ID altında toplanır. Otel sayfası hangi tedarikçiden gelindiğine göre değişmez.
Tedarikçiler aynı alan için farklı değer verdiğinde alan işaretlenir. Hangi bilginin kontrol beklediğini yanıtta görürsünüz.
Otel açıklamaları aynı factsheet verisinden üretilir; metin ile alanlar birbiriyle çelişmez.
İki tedarikçiden gelen ham tesis bilgisi
[A / HTL-88213]
Check-in 14:00 / Check-out 12:00. 412 rooms. Private sandy
beach 250m. 3 outdoor pools, 1 indoor pool. Kids 0-6.99 free.
Pets not allowed.
[B / 40917]
Giriş: 15.00, Çıkış: 12.00 - 410 oda - Otele ait kum plaj
(250 mt) - Açık havuz x3 - Çocuk 0-7 yaş arası ücretsiz HM ID altında standart factsheet
{
"hm_id": "HM-1048213",
"factsheet": {
"check_in": "14:00",
"check_out": "12:00",
"room_count": 412,
"beach": { "type": "sand", "private": true, "distance_m": 250 },
"pools": { "outdoor": 3, "indoor": 1 },
"child_policy": { "free_from_age": 0, "free_to_age": 6.99 },
"pets_allowed": false,
"review_flags": ["check_in", "room_count"]
}
} Örnek veridir; otel ve kodlar gerçek bir tesise ait değildir. Tedarikçilerin çeliştiği alanlar (burada giriş saati ve oda sayısı) review_flags ile işaretlenir.
Aynı HM ID'ye bağlı tüm tedarikçi kayıtlarındaki otel bilgileri bir araya getirilir. Ham veri olduğu gibi saklanır, değişiklikler sürümlenir.
Serbest metindeki saatler, sayılar, mesafeler ve politikalar ayrı alanlara dönüştürülür; saat, mesafe ve yaş biçimleri standartlaştırılır.
Kaynaklar farklı bilgi verdiğinde değerler karşılaştırılır. Belirsiz alanlar işaretlenir ve veri ekibinin kontrol kuyruğuna düşer.
Factsheet GET /v1/hotels/{hm_id}/content ucundan döner; tüm envanter günlük tam ve delta dump dosyalarında gelir.
Tedarikçiler otel bilgilerini çoğu zaman serbest metin içinde gönderir. Bir tedarikçi giriş saatini 14:00, diğeri 15:00 yazar; biri 412 oda der, öteki 410. Plaj bilgisi bir cümlenin içinde kaybolur, çocuk yaş sınırı farklı biçimlerde gelir. Bu hâliyle “otele ait kum plajı olan oteller” veya “0–6 yaş çocuğu ücretsiz olanlar” filtresi kurulamaz.
Otel factsheet bu bilgileri ayrı alanlara çıkarır ve otelin HM ID’sine bağlar. 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.
| Grup | Alanlar | Örnek değer |
|---|---|---|
| Tesis bilgileri | Tesis tipi, yıldız, zincir ve marka, oda ve kat sayısı, açılış ve yenilenme yılı | Resort, 5 yıldız, 412 oda |
| Politikalar | Giriş-çıkış saati; çocuk, evcil hayvan, sigara ve ödeme politikası | 14:00 / 12:00, 0–6,99 yaş ücretsiz |
| Plaj ve havuz | Plaj tipi, otele ait olup olmadığı, mesafe; açık ve kapalı havuz sayısı | Kum, otele ait, 250 m; 3 açık, 1 kapalı |
| Yeme-içme | Restoranlar, barlar, mutfak türleri, açılış saatleri | Türk mutfağı restoranı, havuz barı |
| İletişim ve adres | Doğrulanmış adres, telefon, e-posta, web sitesi | [email protected] |
Alan adları ve değerler dilden bağımsızdır; arayüzde kendi dilinizdeki etiketi gösterirsiniz.
Aynı otel için tedarikçiler farklı değer verdiğinde değerler karşılaştırılır. Belirsiz kalan alanlar review_flags ile işaretlenir ve veri ekibi tarafından kontrol edilir. Böylece hangi bilginin kesin, hangisinin kontrol beklediğini yanıttan görürsünüz.
Otel açıklamaları aynı factsheet verisinden üretilir; metinde geçen bir saat veya mesafe, alandaki değerle çelişmez. Otelin fotoğraf galerisi ise otel resimleri hizmetindedir; factsheet’te plajı olan bir otelde plaj etiketli resim yoksa içerik ekibine uyarı üretebilirsiniz.
Factsheet otel bazında REST API ile, tüm envanter için günlük tam ve delta dump dosyalarıyla teslim edilir. Örnekteki include parametresi ve alan adları API v1 taslağıdır; kesin şema geliştirici sayfasında yayımlanır. Kapsam ve fiyat için teklif alabilirsiniz.
İstek
curl "https://api.hotelmapping.org/v1/hotels/HM-1048213/content?include=factsheet" \
-H "X-API-Key: $HM_API_KEY" Yanıt
{
"hm_id": "HM-1048213",
"factsheet": {
"property": { "type": "resort", "stars": 5, "room_count": 412 },
"policies": {
"check_in": "14:00",
"check_out": "12:00",
"child_policy": { "free_from_age": 0, "free_to_age": 6.99 },
"pets_allowed": false
},
"beach": { "type": "sand", "private": true, "distance_m": 250 },
"pools": { "outdoor": 3, "indoor": 1 },
"dining": [
{ "type": "restaurant", "cuisine": "turkish" },
{ "type": "bar", "location": "pool" }
],
"contact": { "email": "[email protected]" },
"review_flags": ["check_in", "room_count"]
},
"updated_at": "2026-11-02T08:14:00Z"
} Kod örnekleri temsilidir; alan adları v1 yayınında değişebilir.
Bir otelin temel bilgilerinin (tesis tipi, yıldız, oda sayısı, giriş-çıkış saatleri, politikalar, yeme-içme, iletişim) yapılandırılmış alanlar hâlinde sunulmasıdır.
Açıklama okunmak için yazılmış metindir; factsheet ise filtreleme ve karşılaştırma için ayrı alanlardır. İkisi de aynı doğrulanmış veriye dayanır.
Değerler karşılaştırılır; belirsiz kalan alanlar işaretlenir ve veri ekibi tarafından kontrol edilir. Yanıtta hangi alanların kontrol beklediği review_flags ile görünür.
Otel bazında REST API ile ya da tüm envanter için günlük tam ve delta dump dosyalarıyla (CSV, JSON). Değişiklik bildirimi için webhook planlanıyor.
Teklif al
Talebinizi üç adımda gönderin; teklifi iş e-postanıza iletelim. Talep bağlayıcı değildir.