Hotel mapping solutions
A persistent HM ID for every property; supplier codes and cross-IDs in a single record.
Board mapping converts the different spellings suppliers send for the same food-and-beverage concept ("ALL INCLUSIVE ULTRA", "Ultra Herşey Dahil", "Ультра всё включено") into a single standard code: RO, BB, HB, HB+, FB, FB+, AI, AI+, UAI or SAI. This way, an all inclusive offer is never compared as if it were the same product as an ultra all inclusive offer.
{
"hm_id": "HM-1048213",
"boards": [
{ "supplier": "A", "input": "ALL INCLUSIVE ULTRA", "code": "UAI" },
{ "supplier": "B", "input": "Ultra Herşey Dahil", "code": "UAI" },
{ "supplier": "C", "input": "Ультра всё включено", "code": "UAI" },
{ "supplier": "A", "input": "Half Board Plus", "code": "HB+" },
{ "supplier": "B", "input": "Yarım Pansiyon + İçecek", "code": "HB+" },
{ "supplier": "C", "input": "Soft All Inc.", "code": "SAI" }
]
} AI and UAI offers stay under separate codes. It is clear in the listing when a cheaper-looking offer is actually a lower-tier concept.
RO, BB, HB, HB+, FB, FB+, AI, AI+, UAI and SAI. All supplier spellings link to this short list; filters and reports work with a single list.
Turkish, English, German and Russian spellings, typos and abbreviations are kept in the dictionary: "Herşey Dahil", "Halbpension", "Полупансион".
A spelling not in the dictionary is suggested for a code by a similarity score and added to the dictionary after specialist approval. A spelling that has been approved once is never asked about again.
Concepts common especially at resorts in Turkey and the Mediterranean, such as ultra all inclusive, soft all inclusive and half board with drinks, are covered by separate codes.
Board spellings from three suppliers for the same hotel
supplier,hotel_code,rate_code,board
A,HTL-88213,R1,ALL INCLUSIVE ULTRA
B,40917,UAI,Ultra Herşey Dahil
C,TR-ANT-551,UAI-1,Ультра всё включено
A,HTL-88213,R2,Half Board Plus
B,40917,HBP,Yarım Pansiyon + İçecek
C,TR-ANT-551,SAI,Soft All Inc. Standard board codes
{
"hm_id": "HM-1048213",
"boards": [
{ "supplier": "A", "input": "ALL INCLUSIVE ULTRA", "code": "UAI" },
{ "supplier": "B", "input": "Ultra Herşey Dahil", "code": "UAI" },
{ "supplier": "C", "input": "Ультра всё включено", "code": "UAI" },
{ "supplier": "A", "input": "Half Board Plus", "code": "HB+" },
{ "supplier": "B", "input": "Yarım Pansiyon + İçecek", "code": "HB+" },
{ "supplier": "C", "input": "Soft All Inc.", "code": "SAI" }
]
} Sample data; the hotel and codes do not belong to a real property.
The incoming spelling is lowercased; punctuation, extra spaces and abbreviations such as "Inc." and "Incl." are expanded. "Herşey" and "Her Şey" are brought to the same form.
The normalized spelling is looked up in the synonym dictionary of each language. If found, it is linked directly to the standard code.
For spellings not in the dictionary, the closest code is suggested with a similarity score. The score and the method (dictionary or similarity) come back together in the response.
Uncertain suggestions go to the review queue. An approved spelling is added to the dictionary and matches directly on the next request.
The standard code comes back instantly in the API response. The original spelling sent by the supplier is also stored, so you can run retrospective checks when needed.
Board type is one of the fields that changes a hotel’s price the most. Even so, suppliers often send it as free text and in their own languages. The problem is most visible in resort markets where all inclusive concepts are common, such as Turkey and the Mediterranean, and it shows up in four ways:
| Code | Meaning | Spellings seen at suppliers |
|---|---|---|
| RO | Room only | Room Only, Sadece Oda, Ohne Verpflegung, Без питания |
| BB | Bed and breakfast | Bed & Breakfast, Oda Kahvaltı, Frühstück, Завтрак |
| HB | Half board | Half Board, Yarım Pansiyon, Halbpension, Полупансион |
| HB+ | Half board + drinks | Half Board Plus, HB Plus, Yarım Pansiyon + İçecek |
| FB | Full board | Full Board, Tam Pansiyon, Vollpension, Полный пансион |
| FB+ | Full board + drinks | Full Board Plus, Tam Pansiyon Plus |
| AI | All inclusive | All Inclusive, Her Şey Dahil, Herşey Dahil, Всё включено |
| AI+ | Extended all inclusive | All Inclusive Plus, AI Plus, Her Şey Dahil Plus |
| UAI | Ultra all inclusive | Ultra All Inclusive, Ultra Herşey Dahil, Ультра всё включено |
| SAI | Limited all inclusive | Soft All Inclusive, Soft AI, Soft Her Şey Dahil |
The codes are explained in detail in the board types guide, and the difference between AI and UAI is covered in all inclusive vs. ultra all inclusive. For the term, see the board type glossary page.
At many mapping providers, board type is not offered as a separate product. At hotelmapping.org, board mapping is a separate product with its own dictionary and review queue; when you request a quote, you can select it as a separate module.
Board mapping converts the spelling into a standard code. Which drinks are served at which hours in a hotel’s ultra concept is the hotel’s own definition; that is a matter for the hotel description, not the board code. For hotel descriptions, see the hotel content product. For accurate price comparison, the board code works together with hotel mapping and room mapping. For the general framework, see the hotel mapping guide, and to try a single spelling, the board code converter.
Request
curl -X POST https://api.hotelmapping.org/v1/boards/map \
-H "X-API-Key: $HM_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"hm_id": "HM-1048213",
"values": ["Soft All Inc.", "Ultra Herşey Dahil Plus"]
}' Response
{
"results": [
{
"input": "Soft All Inc.",
"code": "SAI",
"score": 0.99,
"decision": "auto_match",
"method": "dictionary"
},
{
"input": "Ultra Herşey Dahil Plus",
"code": "UAI",
"score": 0.88,
"decision": "review",
"method": "similarity"
}
]
} Code samples are illustrative; field names may change in the v1 release.
AI (all inclusive) generally covers meals and domestic drinks. UAI (ultra all inclusive) usually adds extras such as imported drinks or à la carte restaurants. The scope varies from hotel to hotel; we convert the concept into the standard code, while the hotel defines what the concept includes.
Soft AI maps to a separate code, SAI. It is generally a more limited form of all inclusive; for example, alcoholic drinks are not offered at all or are limited to certain hours. Recording it as AI or FB+ breaks price comparison.
Half Board Plus (HB+) adds drinks to half board; usually domestic drinks are included with dinner, and the scope varies from hotel to hotel. If a supplier sends it only as HB, the drink information is lost; the standard code preserves this difference.
At many mapping providers, board type is not offered as a separate product. At hotelmapping.org, board mapping is a separate product and works together with hotel and room mapping.
Yes. In the free board code converter tool, you can enter a spelling such as "Ultra Herşey Dahil Plus" and see which standard code it maps to.
Request a quote
Send your request in three steps; we will email the quote to your work address. The request is non-binding.