Otel factsheet çözümü

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.

Neler kazanırsınız

  • Filtrelemeye hazır

    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.

  • Tek otel, tek doğru

    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.

  • Çelişkiler görünür

    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.

  • Açıklamalarla tutarlı

    Otel açıklamaları aynı factsheet verisinden üretilir; metin ile alanlar birbiriyle çelişmez.

Önce ve sonra

İki tedarikçiden gelen ham tesis bilgisi

supplier_facts.txt
[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-1048213 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.

Nasıl çalışır

  1. 1

    Kaynakları birleştirme

    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.

  2. 2

    Alanlara ayırma

    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.

  3. 3

    Çelişki kontrolü

    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.

  4. 4

    Teslim ve güncelleme

    Factsheet GET /v1/hotels/{hm_id}/content ucundan döner; tüm envanter günlük tam ve delta dump dosyalarında gelir.

Factsheet neden ayrı alanlarda?

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.

Factsheet alanları

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.

Çelişen bilgiler

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.

Açıklamalar ve teslim

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.

Otel eşleştirme nedir? Kapsamlı rehber

API örneği

İstek

Factsheet isteği
curl "https://api.hotelmapping.org/v1/hotels/HM-1048213/content?include=factsheet" \
  -H "X-API-Key: $HM_API_KEY"

Yanıt

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

Sık sorulan sorular

Otel factsheet nedir?

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.

Factsheet ile otel açıklaması arasındaki fark nedir?

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.

Tedarikçiler farklı bilgi verirse hangisi kullanılı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.

Factsheet verisini hangi biçimlerde alabilirim?

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

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