Room images solutions

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
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
{
  "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. 1

    Room mapping

    Supplier room codes are linked through room mapping to standard room IDs tied to the hotel's HM ID.

  2. 2

    Collection

    Photos a supplier sends under a room code are collected under the standard room ID that code is linked to.

  3. 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. 4

    Delivery

    Images, duplicate groups and supplier room codes are returned in the API response together with the room data.

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. 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 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 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.

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 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.

What is hotel mapping? The complete guide

API example

Request

Requesting a hotel's rooms with their images
curl "https://api.hotelmapping.org/v1/hotels/HM-1048213/rooms?include=images" \
  -H "X-API-Key: $HM_API_KEY"

Response

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

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.

Request a quote

Get your tailored quote

Send your request in three steps; we will email the quote to your work address. The request is non-binding.

  1. 1 Select solutions
  2. 2 Select suppliers
  3. 3 Leave your contact details