# Room images solutions

> URL: https://hotelmapping.org/en/products/room-images-solutions/ · Language: English

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.

## What you gain

- **The right room, the right photo:** 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.
- **Suppliers merge into one room type:** Photos that three suppliers send for the same room are collected under the single room ID created by room mapping.
- **Duplicates in one image:** Copies of the same room photo that arrive from different suppliers and in different sizes are grouped under one image.
- **Together with room data:** Images come back in the same response as room type, view, bed and capacity tags; no separate matching step is needed.

## Before and after

Room photos from three suppliers

**supplier_room_images.csv**

```csv
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-1048213 room images**

```json
{
  "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._

## How it works

1. **Room mapping:** Supplier room codes are linked through room mapping to standard room IDs tied to the hotel's HM ID.
2. **Collection:** Photos a supplier sends under a room code are collected under the standard room ID that code is linked to.
3. **Duplicate image detection:** 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.
4. **Delivery:** Images, duplicate groups and supplier room codes are returned in the API response together with the room data.

## API example

**Requesting a hotel's rooms with their images**

```bash
curl "https://api.hotelmapping.org/v1/hotels/HM-1048213/rooms?include=images" \
  -H "X-API-Key: $HM_API_KEY"
```

**200 OK**

```json
{
  "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._

## What do room images solve?

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](https://hotelmapping.org/en/products/room-mapping-solutions/). 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](https://hotelmapping.org/en/guide/what-is-room-mapping/) guide, and the general framework in the [hotel mapping guide](https://hotelmapping.org/en/guide/what-is-hotel-mapping/).

## Hotel images and room images

| | 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](https://hotelmapping.org/en/products/hotel-mapping-solutions/) | 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](https://hotelmapping.org/en/products/hotel-images-solutions/) service. When both services are used together, the hotel page shows the general gallery and each room offer shows its own photos.

## How are duplicates removed?

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.

## Delivery

Images work on the same HM ID and room IDs as [hotel content](https://hotelmapping.org/en/products/hotel-descriptions-solutions/) 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](https://hotelmapping.org/en/developers/). For scope and pricing, you can [request a quote](https://hotelmapping.org/en/get-a-quote/).

## Frequently asked questions

### Is room mapping required for room images?

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.

### What is the difference between room images and hotel images?

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.

### What happens if a supplier doesn't send a room photo with a room code?

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.

### Do room images also bring price or availability data?

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.

## Related products

- [Room mapping solutions](https://hotelmapping.org/en/products/room-mapping-solutions/)
- [Hotel images solutions](https://hotelmapping.org/en/products/hotel-images-solutions/)
- [Hotel descriptions solutions](https://hotelmapping.org/en/products/hotel-descriptions-solutions/)

## Related articles

- [What is room mapping? Why are room names so messy?](https://hotelmapping.org/en/guide/what-is-room-mapping/)
- [Room type abbreviations glossary: SGL, DBL, TWN, TRP, SV, LV, FAM](https://hotelmapping.org/en/guide/room-type-abbreviations/)
- [What is hotel mapping? How it works: a complete guide](https://hotelmapping.org/en/guide/what-is-hotel-mapping/)
