Room mapping solutions
Breaks room names into type, class, view, bed and capacity; groups the same room under one room ID.
Room images links the photos suppliers send for each room to the standard room types created by room mapping (e.g. HM-1048213-R03). Each room offer is then shown with that room's own photos instead of the general hotel gallery. The same photo arriving from different suppliers is grouped into one image, and images are returned from the API together with the room data.
{
"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 }]
}
]
}
]
} The offer for a sea-view room with a balcony is shown with that room's photos; guests don't have to hunt for their room in the hotel's general gallery.
Photos that three suppliers send for the same room are collected under the single room ID created by room mapping.
Copies of the same room photo that arrive from different suppliers and in different sizes are grouped under one image.
Images come back in the same response as room type, view, bed and capacity tags; no separate matching step is needed.
Room photos from three suppliers
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 Images linked to standard room types
{
"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 }]
}
]
}
]
} Sample data; the hotel, room names, codes and image URLs do not belong to a real property.
Supplier room codes are linked through room mapping to standard room IDs tied to the hotel's HM ID.
Photos a supplier sends under a room code are collected under the standard room ID that code is linked to.
A content-based fingerprint is computed for each image; copies of the same room photo that arrive from different suppliers are grouped into one image.
Images, duplicate groups and supplier room codes are returned in the API response together with the room data.
When five room offers are listed on a hotel page, most systems show the same general gallery next to every offer. While choosing a sea-view room with a balcony, the guest sees a pool or lobby photo; to understand what the family room looks like, they have to browse the whole gallery. Suppliers often send room photos with their own room codes, but those codes differ from supplier to supplier.
Room images link these photos to the standard room types produced by room mapping. Because “Dbl Sea View Balcony”, “DZ Meerblick Balkon” and “Standart Oda Deniz Manzaralı Balkonlu” are tied to the same room ID, the photos from all three suppliers are collected under the same room. You can read how room types are standardized in the what is room mapping guide, and the general framework in the hotel mapping guide.
| Hotel images | Room images | |
|---|---|---|
| Linked to | The hotel’s HM ID | Standard room ID (e.g. HM-1048213-R03) |
| What it contains | Exterior, lobby, pool, beach, restaurant, spa, common areas | Photos of that room type |
| Prerequisite | Hotel mapping | Hotel mapping and room mapping |
| Duplicate detection | Within the hotel gallery | Within the room type |
| Delivery | Hotel content response and dump | Room data response |
For the hotel’s general gallery, see the hotel images service. When both services are used together, the hotel page shows the general gallery and each room offer shows its own photos.
Several suppliers may send the same room photo in different sizes or compression. A content-based fingerprint is computed for each image, and identical shots within the same room type are grouped under one image. The response includes each image’s copy count and which supplier room code it came from.
Images work on the same HM ID and room IDs as hotel content and room mapping data. The GET /v1/hotels/{hm_id}/rooms?include=images endpoint and response fields in the example are an API v1 draft; the final schema will be published on the developer page. For scope and pricing, you can request a quote.
Request
curl "https://api.hotelmapping.org/v1/hotels/HM-1048213/rooms?include=images" \
-H "X-API-Key: $HM_API_KEY" Response
{
"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
}
]
}
]
} Code samples are illustrative; field names may change in the v1 release.
Yes. Photos are linked to the standard room IDs created by room mapping. Until room types are standardized, photos that different suppliers send for the same room cannot be brought together.
Hotel images are the hotel's general gallery: exterior, lobby, pool, beach, restaurant, spa and common areas. Room images are photos linked individually to each standard room type. They are two separate services.
A room image is linked to a room type according to the room code the supplier sent the photo with. Photos that arrive without a room code are not linked to any room type; photos that arrive at hotel level are handled by the hotel images service.
No. Room images are part of static room data. Price and availability come from the supplier to your system; we only tell you which room an offer belongs to and provide that room's images.
Request a quote
Send your request in three steps; we will email the quote to your work address. The request is non-binding.