Oda eşleştirme çözümü
Oda adlarını tip, sınıf, manzara, yatak ve kapasiteye ayırır; aynı odayı tek oda ID'sinde toplar.
Oda resimleri, tedarikçilerin her oda için gönderdiği fotoğrafları oda eşleştirmesiyle oluşan standart oda tiplerine (ör. HM-1048213-R03) bağlar. Böylece her oda teklifi genel otel galerisi yerine o odanın kendi fotoğraflarıyla gösterilir. Farklı tedarikçilerden gelen aynı fotoğraf tek resimde gruplanır ve resimler oda verisiyle birlikte API'den döner.
{
"hm_id": "HM-1048213",
"rooms": [
{
"room_id": "HM-1048213-R03",
"name": "Standard Double Room, Sea View, Balcony",
"images": [
{
"image_id": "HM-1048213-R03-I001",
"copies": [
{ "supplier": "A", "room_code": "DBLSV-B", "width": 1920 },
{ "supplier": "B", "room_code": "DZMB", "width": 1024 }
]
},
{
"image_id": "HM-1048213-R03-I002",
"copies": [{ "supplier": "C", "room_code": "STD-DNZ", "width": 800 }]
}
]
},
{
"room_id": "HM-1048213-R07",
"name": "Standard Family Room, Land View",
"images": [
{
"image_id": "HM-1048213-R07-I001",
"copies": [{ "supplier": "B", "room_code": "FZLS", "width": 1024 }]
}
]
}
]
} Deniz manzaralı balkonlu odanın teklifi, o odanın fotoğraflarıyla gösterilir; misafir otelin genel galerisinde odasını aramak zorunda kalmaz.
Üç tedarikçinin aynı oda için gönderdiği fotoğraflar, oda eşleştirmesinin oluşturduğu tek oda kimliği altında toplanır.
Aynı oda fotoğrafının farklı tedarikçilerden ve farklı boyutlarda gelen kopyaları tek resim altında gruplanır.
Resimler oda tipi, manzara, yatak ve kapasite etiketleriyle aynı yanıtta döner; ayrı bir eşleştirme adımı gerekmez.
Üç tedarikçiden gelen oda fotoğrafları
supplier,hotel_code,room_code,room_name,image_url,width
A,HTL-88213,DBLSV-B,Dbl Sea View Balcony,https://img.supplier-a.example/88213/rooms/dblsv-1.jpg,1920
B,40917,DZMB,DZ Meerblick Balkon,https://cdn.supplier-b.example/40917/zimmer/dzmb_01.jpg,1024
C,TR-ANT-551,STD-DNZ,Standart Oda Deniz Manzaralı Balkonlu (2+1),https://media.supplier-c.example/551/IMG_3101.jpg,800
B,40917,FZLS,FZ Landseite,https://cdn.supplier-b.example/40917/zimmer/fzls_01.jpg,1024 Standart oda tiplerine bağlanmış resimler
{
"hm_id": "HM-1048213",
"rooms": [
{
"room_id": "HM-1048213-R03",
"name": "Standard Double Room, Sea View, Balcony",
"images": [
{
"image_id": "HM-1048213-R03-I001",
"copies": [
{ "supplier": "A", "room_code": "DBLSV-B", "width": 1920 },
{ "supplier": "B", "room_code": "DZMB", "width": 1024 }
]
},
{
"image_id": "HM-1048213-R03-I002",
"copies": [{ "supplier": "C", "room_code": "STD-DNZ", "width": 800 }]
}
]
},
{
"room_id": "HM-1048213-R07",
"name": "Standard Family Room, Land View",
"images": [
{
"image_id": "HM-1048213-R07-I001",
"copies": [{ "supplier": "B", "room_code": "FZLS", "width": 1024 }]
}
]
}
]
} Örnek veridir; otel, oda adları, kodlar ve resim adresleri gerçek bir tesise ait değildir.
Tedarikçi oda kodları, oda eşleştirmesiyle otelin HM ID'sine bağlı standart oda kimliklerine bağlanır.
Tedarikçinin bir oda koduyla gönderdiği fotoğraflar, o kodun bağlı olduğu standart oda kimliği altında toplanır.
Her resmin içeriğe dayalı bir parmak izi çıkarılır; aynı oda fotoğrafının farklı tedarikçilerden gelen kopyaları tek resimde gruplanır.
Resimler, kopya grupları ve tedarikçi oda kodları oda verisiyle birlikte API yanıtında döner.
Bir otel sayfasında beş oda teklifi listelendiğinde çoğu sistem her teklifin yanında aynı genel galeriyi gösterir. Misafir deniz manzaralı balkonlu odayı seçerken havuz veya lobi fotoğrafı görür; aile odasının nasıl göründüğünü anlamak için galeriyi baştan sona gezmesi gerekir. Tedarikçiler oda fotoğraflarını çoğu zaman kendi oda kodlarıyla gönderir, ama bu kodlar her tedarikçide farklıdır.
Oda resimleri bu fotoğrafları oda eşleştirme sonucunda oluşan standart oda tiplerine bağlar. “Dbl Sea View Balcony”, “DZ Meerblick Balkon” ve “Standart Oda Deniz Manzaralı Balkonlu” aynı oda kimliğine bağlandığı için üç tedarikçinin fotoğrafları da aynı odada toplanır. Oda tiplerinin nasıl standartlaştığını oda eşleştirme nedir rehberinde, genel çerçeveyi otel eşleştirme rehberinde bulabilirsiniz.
| Otel resimleri | Oda resimleri | |
|---|---|---|
| Neye bağlanır | Otelin HM ID’si | Standart oda kimliği (ör. HM-1048213-R03) |
| Ne içerir | Dış cephe, lobi, havuz, plaj, restoran, spa, ortak alanlar | O oda tipinin fotoğrafları |
| Ön koşul | Otel eşleştirme | Otel eşleştirme ve oda eşleştirme |
| Mükerrer tespiti | Otel galerisi içinde | Oda tipi içinde |
| Teslim | Otel içeriği yanıtı ve dump | Oda verisi yanıtı |
Otelin genel galerisi için otel resimleri hizmetine bakın. İki hizmet birlikte kullanıldığında otel sayfası genel galeriyi, her oda teklifi ise kendi fotoğraflarını gösterir.
Birden fazla tedarikçi aynı oda fotoğrafını farklı boyut veya sıkıştırmayla gönderebilir. Her resmin içeriğe dayalı bir parmak izi çıkarılır ve aynı oda tipi içindeki aynı kareler tek resim altında gruplanır. Yanıtta her resmin kopya sayısı ve hangi tedarikçi oda kodundan geldiği yer alır.
Resimler, otel içeriği ve oda eşleştirme verisiyle aynı HM ID ve oda kimlikleri üzerinden çalışır. Örnekteki GET /v1/hotels/{hm_id}/rooms?include=images uç noktası ve yanıt alanları 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/rooms?include=images" \
-H "X-API-Key: $HM_API_KEY" Yanıt
{
"hm_id": "HM-1048213",
"rooms": [
{
"room_id": "HM-1048213-R03",
"name": "Standard Double Room, Sea View, Balcony",
"view": "sea",
"bed": "double",
"max_occupancy": 3,
"supplier_rooms": { "A": "DBLSV-B", "B": "DZMB", "C": "STD-DNZ" },
"images": [
{
"image_id": "HM-1048213-R03-I001",
"url": "https://img.supplier-a.example/88213/rooms/dblsv-1.jpg",
"width": 1920,
"copy_count": 2
},
{
"image_id": "HM-1048213-R03-I002",
"url": "https://media.supplier-c.example/551/IMG_3101.jpg",
"width": 800,
"copy_count": 1
}
]
}
]
} Kod örnekleri temsilidir; alan adları v1 yayınında değişebilir.
Evet. Fotoğraflar, oda eşleştirmesinin oluşturduğu standart oda kimliklerine bağlanır. Oda tipleri standartlaşmadan farklı tedarikçilerin aynı oda için gönderdiği fotoğraflar bir araya getirilemez.
Otel resimleri otelin genel galerisidir: dış cephe, lobi, havuz, plaj, restoran, spa ve ortak alanlar. Oda resimleri her standart oda tipine ayrı ayrı bağlanan fotoğraflardır. İkisi ayrı hizmetlerdir.
Oda resmi, tedarikçinin fotoğrafı hangi oda koduyla gönderdiğine göre oda tipine bağlanır. Oda koduyla gelmeyen fotoğraflar bir oda tipine bağlanmaz; otel düzeyinde gelen fotoğraflar otel resimleri hizmetinde işlenir.
Hayır. Oda resimleri statik oda verisinin bir parçasıdır. Fiyat ve müsaitlik tedarikçiden sizin sisteminize gelir; biz yalnız teklifin hangi odaya ait olduğunu ve o odanın resimlerini veririz.
Teklif al
Talebinizi üç adımda gönderin; teklifi iş e-postanıza iletelim. Talep bağlayıcı değildir.