Hotel room mapping is how a booking platform recognises that rooms sold by different suppliers under different names are the same physical room, and links them into one record. Without it, the same room appears three times in search — “Deluxe King Room”, “DLX KNG 1 Bed”, “Superior Double, 1 King Bed” — and a traveller can book the wrong one. With it, each room appears once with every supplier’s rate behind it. Tripgic’s Hotel API, for example, returns hotels from 50+ suppliers in one schema, which is the starting point mapping needs.
This guide explains why mapping is hard, the three levels it works at, the methods behind it, the two ways it goes wrong, how to measure it, and whether to build it or buy it. For the wider hotel booking flow, see our hotel API integration guide.
Why the Same Room Has Many Names
There is no global ID for a hotel room type. Each supplier — bedbank, channel manager, GDS, hotel chain — names and describes rooms its own way:
| Source of difference | Example |
|---|---|
| Abbreviations | “DLX KNG” vs “Deluxe King” |
| Marketing names | “Signature Room” vs “Deluxe Room” |
| Category words | “Superior”, “Deluxe”, “Premium” used differently by each hotel |
| Bed descriptions | “1 King Bed”, “Double”, “Queen or Twin” |
| Views and location | “City View”, “High Floor”, omitted entirely |
| Language | Names in the hotel’s local language |
| Detail level | One supplier lists size and view; another lists neither |

A human can often tell that three names mean the same room. A computer needs rules, data and judgement — which is what mapping provides. At the scale of a modern platform — thousands of hotels, each with several room types from several suppliers — doing it by hand is impossible, and doing it carelessly is expensive.
Who Needs Room Mapping
| Business | Why mapping matters |
|---|---|
| OTAs with several hotel sources | Duplicates in results lower conversion and trust |
| Metasearch and comparison sites | Comparing prices is only fair for the same room |
| B2B portals | Agents need one clear list to quote from |
| Corporate booking tools | Policy rates must attach to the right room |
| Tour operators and DMCs | Packages must name the exact room booked |
| A platform with one hotel source | Less urgent, but needed the day a second source is added |
The last row is the common trap: a platform launches with one hotel supplier, adds a second for coverage, and discovers its results page is suddenly full of duplicates. Plan mapping before the second source arrives.
The Three Levels of Mapping
| Level | Question | Must be right before |
|---|---|---|
| 1. Property | Is this the same hotel? | Room mapping |
| 2. Room type | Is this the same room type inside the hotel? | Rate grouping |
| 3. Rate plan | Are these the same conditions? | Display and booking |
Mapping always works top-down. If two properties are wrongly matched, every room comparison inside them is meaningless.
Level 1: property mapping
The same hotel arrives from different suppliers with slightly different names, addresses and IDs. Property mapping uses:
- Supplier and chain IDs, where they exist.
- Normalised names: lower case, punctuation removed, common words (“hotel”, “the”) handled.
- Addresses: street, number and postcode, normalised.
- Coordinates: latitude and longitude within a small distance.
- Phone numbers and websites, where available.
Coordinates are powerful but not enough on their own: two hotels can share a building, and a new hotel can sit across the street from an old one. Combine several signals, and treat a match on coordinates alone as a candidate for review rather than a certainty. Large resorts with several buildings and hotel chains with two brands at one address are the classic traps.
Level 2: room mapping
Inside a matched hotel, room mapping compares room types:
- Normalise names: expand abbreviations (“DLX” → “Deluxe”, “KNG” → “King”), fix spelling, translate where needed.
- Extract attributes: bed type and count, maximum occupancy, view, size, accessibility, smoking, room class.
- Compare candidates: every room from supplier A against every room from supplier B in the same hotel.
- Score each pair: matching attributes add confidence; conflicting ones (a twin against a king) remove it.
- Decide: high scores merge, low scores stay separate, uncertain scores go to review.
Level 3: rate plans
Even when two suppliers sell the same room, their rates may differ in conditions:
| Condition | Why it must not be merged |
|---|---|
| Board | Room only vs breakfast included are different products |
| Refundability | Non-refundable vs free cancellation |
| Cancellation deadline | Different dates mean different risk |
| Payment | Pay now vs pay at the hotel |
| Occupancy | A rate for two is not a rate for three |
Rates with the same room and the same conditions can be compared directly on price. Rates with different conditions belong under the same room, but as separate options.

The Data Good Mapping Needs
Mapping is only as good as the data each supplier sends. These fields make the biggest difference:
| Field | Why it helps |
|---|---|
| Hotel identifiers | Direct links between supplier records when available |
| Coordinates | Separate nearby hotels and confirm matches |
| Full address | Confirms property matches |
| Bed type and count | The strongest room signal |
| Maximum occupancy | Separates double rooms from family rooms |
| Room size | Separates categories that share a bed type |
| View and floor | Separates sea-view from city-view rooms |
| Room-level photos | Lets reviewers confirm a match quickly |
| Structured rate conditions | Keeps different rates apart |
When a supplier sends only a free-text room name, mapping must guess more — and should be more cautious. When you compare providers, ask how much of this structure they return.
Scoring: How Confident Is a Match?
Mapping is a probability, not a certainty. A typical scoring approach:
| Signal | Effect on the match score |
|---|---|
| Same bed type and count | Strong increase |
| Same maximum occupancy | Increase |
| Same view | Increase |
| Similar size (within a tolerance) | Increase |
| Name similarity after normalisation | Moderate increase |
| Conflicting bed type (twin vs king) | Strong decrease |
| Conflicting view (sea vs city) | Strong decrease |
| One is a suite, the other a standard room | Strong decrease |
Set two thresholds: above the high one, merge automatically; below the low one, keep separate; in between, send to a person. The review queue is where quality is won — and where many in-house projects run out of budget.
The Two Ways Mapping Goes Wrong
| Error | What the traveller sees | How bad |
|---|---|---|
| Under-merging | The same room listed twice or three times | Annoying; looks messy; can confuse comparison |
| Over-merging | Two different rooms shown as one | Serious: the traveller may book a room that is not the one they chose |
Under-merging costs conversion; over-merging costs trust and refunds. Both are measurable, and both should be watched every week once you sell hotels from more than one source. When in doubt, keep rooms separate. A duplicate is a display problem; a wrong room is a customer-service problem at check-in.
Apartments, Villas and Vacation Rentals
Apartments and rentals are harder to map than hotel rooms:
- Each unit can be unique, so “room type” may mean one specific apartment.
- Descriptions vary widely: bedrooms, bathrooms, sofa beds, kitchens.
- The same building may hold units sold by different managers, each with its own listing.
- Occupancy rules differ: a two-bedroom apartment may sleep four or six.
Map apartments mainly on bedrooms, bathrooms, maximum occupancy, size and address, and be cautious about merging units that are not clearly identical. For families and longer stays, showing two similar apartments separately is far better than merging different ones.
Mapping Across Languages and Markets
Suppliers often describe the same room in different languages, or in a local language with an English translation that varies:
- Translate before comparing, so “Chambre Double Supérieure” and “Superior Double Room” can be matched.
- Watch local category words, which may not translate directly.
- Keep the original text for support staff and for the hotel’s own records.
- Display in the traveller’s language using the richest description available, not a machine translation of the poorest one.
Multilingual content from the supplier helps here: the more of it is structured, the less translation mapping must do.
Why Mapping Matters to Your Business
- Clean results. One room, one line — easier to scan, easier to choose.
- Real price comparison. With rooms mapped, you can show the best rate for the same room across suppliers.
- Higher margin. You can sell the room through the source that leaves you the best margin, without the traveller seeing duplicates.
- Fewer wrong bookings. Clear room identity reduces check-in problems.
- Better content. Mapped rooms can combine the best photos and descriptions from several suppliers.
A Worked Example
A traveller searches a four-star hotel in Paris for two adults. Three suppliers return rooms:
| Supplier A | Supplier B | Supplier C |
|---|---|---|
| Deluxe King Room | DLX KNG 1 Bed | Superior Double, 1 King Bed |
| Classic Twin | Standard Twin | Twin Room |
| Junior Suite | Jr Suite City View | Suite |
- Property: all three hotel records share coordinates, address and a normalised name — merged.
- Deluxe King: all three have one king bed and two guests; A and B say “Deluxe”, C says “Superior”. Size data (where present) matches. High score — merged, with C’s name flagged for review.
- Twin: all three are two single beds, two guests — merged.
- Suites: A and B are junior suites; C says only “Suite” and lists a larger size. Medium score — sent to review, shown separately meanwhile.
- Rates: under the Deluxe King, supplier A offers room-only refundable, B offers breakfast non-refundable, C offers room-only refundable at a lower price. A and C are comparable; B is shown as a separate option.
The traveller sees three room types — with the uncertain suite shown carefully — and a clear choice of rates under each.
Mapping in B2B and Agent Portals
Agents use mapped content differently from consumers:
- They quote from it. A duplicate or a wrong merge ends up in a quote sent to a client.
- They compare net rates. Mapping lets the portal show the best net rate for each room.
- They need the supplier’s own room name when talking to the hotel or the client’s travel manager.
- They book repeatedly for the same clients and hotels, so consistent room records save time.
Show agents the merged room with its rates, and make the original supplier room name one click away.
Measuring Mapping Quality
| Measure | What it tells you |
|---|---|
| Duplicate rate in results | How much under-merging remains |
| Wrong-room complaints at check-in | Whether over-merging is happening |
| Share of rooms auto-merged vs reviewed | How well your rules work |
| Review queue size and age | Whether the team keeps up |
| Coverage | Share of hotels and rooms mapped across suppliers |
Sample a set of hotels each month and check them by hand. Automated measures miss subtle errors that a person sees at once.
Keeping Mapping Up to Date
Mapping is never finished:
- New hotels join suppliers every day.
- Hotels rename rooms, refurbish them or change bed configurations.
- Suppliers change their data — new codes, new descriptions.
- Hotels close or change brands, which changes names and IDs.
Plan a regular refresh: re-map new and changed hotels daily or weekly, and re-check your highest-selling hotels by hand. The hotels that sell most deserve the most attention. A small team reviewing the top hundred hotels each month usually catches more costly errors than any rule change.
Which Rate to Show: Mapping and Revenue
Once rooms are mapped, a platform often has several rates for the same room and the same conditions from different suppliers. Which one to show is a business decision:
| Rule | Effect |
|---|---|
| Lowest price for the traveller | Best conversion; may not be your best margin |
| Best margin for you | Higher revenue per booking; must stay competitive |
| Most reliable supplier | Fewer failed bookings and complaints |
| Preferred contract | Honour direct deals and targets |
Many platforms combine these: show the lowest price, but book through the supplier with the best margin when prices are equal, and avoid suppliers with high failure rates. Mapping is what makes this possible — without it, the same room competes against itself in your own results.
How to Display Mapped Rooms
- Group rates under the room, with conditions side by side: board, refundability, payment.
- Show the best price per condition, not just the cheapest overall, so travellers compare like with like.
- Use the richest content — the best photos and fullest description — from any supplier for the merged room.
- Mark uncertain matches cautiously, or keep them separate until reviewed.
- Keep the supplier’s own room name available to support staff, so they can check what was booked.
Build, Buy or Combine?
| Option | What it means | Best for |
|---|---|---|
| Build in-house | Your own normalisation, scoring and review team | Very large platforms with data teams |
| Specialist mapping provider | A company that maintains hotel and room mappings across suppliers | Platforms connecting several suppliers directly |
| Rely on an aggregator’s normalised data | Hotels arrive already in one schema from one provider | Most OTAs, agencies and B2B platforms |
| Combine | Aggregator data plus your own rules for display and edge cases | Growing platforms adding direct contracts |
Building mapping is a permanent commitment: rules, data, a review team and constant updates. Most platforms do better by starting with normalised data from one provider and adding their own logic only where their business needs it.
How to Test Mapping Before You Rely on It
- Pick twenty hotels in your busiest cities, including chains, independents and apartments.
- Search them through every source you plan to use, for the same dates.
- Compare by hand: how many room types do you see, and are any duplicates or wrong merges?
- Check rates: are different conditions kept separate?
- Book and cancel a test room on a merged record and confirm the supplier’s room is the one you expected.
Repeat the test whenever you add a supplier. Keep the twenty hotels and the results as a benchmark, so you can see whether mapping quality improves or slips over time.
Common Mistakes in Room Mapping
- Skipping property mapping. Comparing rooms across two different hotels guarantees errors.
- Merging on names alone. “Deluxe” means different things in different hotels; compare attributes.
- Merging different rate conditions. Breakfast and room-only are different products, even on the same room.
- No review queue. Automatic rules alone either merge too much or too little.
- Mapping once and stopping. Hotels and suppliers change constantly; mapping must keep up.
- Ignoring the hotels that sell most. Check your top hotels by hand; they carry most of your revenue and most of your risk.
How Tripgic Handles Hotel Data
Tripgic is a B2B travel API aggregator. For hotels, its own pages state:
- One schema for every supplier. Its Hotel API page says inventory and rates from dozens of source suppliers are “normalized into a single response”, and that a property response has “the same shape regardless of which underlying supplier fulfilled it”.
- Scale. 2M+ properties from 50+ supply partners in 190+ countries.
- Structured rooms and rates. Room-level images, maximum occupancy, multiple rate plans — room-only, bed and breakfast, half board, full board, all-inclusive, advance purchase, non-refundable, member rates — each with structured cancellation deadlines and penalties.
- Rich content. High-resolution photos, structured descriptions, amenity lists, coordinates and multilingual content.
- The full booking flow. Eleven hotel endpoints in the API docs, from location suggestions to voucher and cancellation.
- Final prices, flat fee. Prices at validation and booking are final; a flat amount per night, never a percentage; figures on the pricing page.
- Test first. Sandbox credentials at no charge after a short call; run the twenty-hotel test above on your own cities.
Final Thoughts
Hotel room mapping is invisible when it works and painful when it does not. Get the property right first, then the room, then keep rate conditions apart. Prefer a duplicate to a wrong merge, measure quality by hand as well as by numbers, and keep mapping current as hotels and suppliers change.
Most platforms should not build it all themselves: start from normalised hotel data, add your own display logic, and spend your effort on the hotels that sell most. A clean results page is one of the quietest ways to raise conversion, and one of the few that travellers notice only when it is missing.
Want to see normalised hotel data from 50+ suppliers? Book a demo and get Tripgic sandbox credentials after a short call.
Mohammad Fahim





