Solutions de mapping hôtelier
Un HM ID permanent pour chaque établissement ; codes fournisseurs et ID croisés dans une seule fiche.
Le mapping des types de pension convertit en un code standard unique les différentes graphies que les fournisseurs envoient pour un même concept de restauration (« ALL INCLUSIVE ULTRA », « Ultra Herşey Dahil », « Ультра всё включено ») : RO, BB, HB, HB+, FB, FB+, AI, AI+, UAI ou SAI. Une offre tout compris n'est ainsi plus comparée comme s'il s'agissait du même produit qu'une offre ultra tout compris.
{
"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" }
]
} Les offres AI et UAI restent sous des codes distincts. On voit clairement dans la liste quand l'offre qui paraît moins chère correspond en réalité à un concept inférieur.
RO, BB, HB, HB+, FB, FB+, AI, AI+, UAI et SAI. Toutes les graphies fournisseurs sont rattachées à cette courte liste ; filtres et rapports fonctionnent avec une seule liste.
Les graphies en turc, anglais, allemand et russe, ainsi que les fautes de frappe et les abréviations, sont conservées dans le dictionnaire : « Herşey Dahil », « Halbpension », « Полупансион ».
Une graphie absente du dictionnaire est proposée pour un code par score de similarité, puis ajoutée au dictionnaire après validation par un expert. Une graphie validée une fois n'est plus jamais redemandée.
Des concepts répandus surtout dans les complexes de Turquie et de Méditerranée, comme l'ultra tout compris, le soft tout compris et la demi-pension avec boissons, disposent de codes distincts.
Graphies de pension de trois fournisseurs pour un même hôtel
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. Codes de pension standard
{
"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" }
]
} Données d'exemple ; l'hôtel et les codes ne correspondent à aucun établissement réel.
La graphie reçue est mise en minuscules ; la ponctuation, les espaces superflus et les abréviations comme « Inc. » ou « Incl. » sont développés. « Herşey » et « Her Şey » sont ramenés à la même forme.
La graphie normalisée est recherchée dans le dictionnaire de synonymes de chaque langue. Si elle est trouvée, elle est directement rattachée au code standard.
Pour les graphies absentes du dictionnaire, le code le plus proche est proposé avec un score de similarité. Le score et la méthode (dictionnaire ou similarité) sont renvoyés ensemble dans la réponse.
Les propositions incertaines passent dans la file de contrôle. La graphie validée est ajoutée au dictionnaire et correspond directement à la requête suivante.
Le code standard est renvoyé instantanément dans la réponse API. La graphie d'origine envoyée par le fournisseur est également conservée, ce qui permet un contrôle rétroactif si nécessaire.
Le type de pension est l’un des champs qui font le plus varier le prix d’un hôtel. Pourtant, les fournisseurs l’envoient le plus souvent en texte libre et dans leur propre langue. Le problème est particulièrement visible sur les marchés de villégiature comme la Turquie et la Méditerranée, où les concepts tout compris sont répandus, et il prend quatre formes :
| Code | Signification | Graphies observées chez les fournisseurs |
|---|---|---|
| RO | Chambre seule | Room Only, Sadece Oda, Ohne Verpflegung, Без питания |
| BB | Chambre et petit-déjeuner | Bed & Breakfast, Oda Kahvaltı, Frühstück, Завтрак |
| HB | Demi-pension | Half Board, Yarım Pansiyon, Halbpension, Полупансион |
| HB+ | Demi-pension + boissons | Half Board Plus, HB Plus, Yarım Pansiyon + İçecek |
| FB | Pension complète | Full Board, Tam Pansiyon, Vollpension, Полный пансион |
| FB+ | Pension complète + boissons | Full Board Plus, Tam Pansiyon Plus |
| AI | Tout compris | All Inclusive, Her Şey Dahil, Herşey Dahil, Всё включено |
| AI+ | Tout compris étendu | All Inclusive Plus, AI Plus, Her Şey Dahil Plus |
| UAI | Ultra tout compris | Ultra All Inclusive, Ultra Herşey Dahil, Ультра всё включено |
| SAI | Tout compris limité | Soft All Inclusive, Soft AI, Soft Her Şey Dahil |
Le détail des codes figure dans le guide des types de pension ; la différence entre AI et UAI est expliquée dans l’article sur la différence entre tout compris et ultra tout compris. Pour le terme, consultez la page du glossaire type de pension.
Chez beaucoup de prestataires de mapping, le type de pension n’est pas proposé comme un produit à part. Chez hotelmapping.org, le mapping des types de pension est un produit distinct, avec son propre dictionnaire et sa propre file de contrôle ; lorsque vous demandez un devis, vous pouvez le sélectionner comme module séparé.
Le mapping des types de pension convertit la graphie en code standard. Quelles boissons sont servies à quels horaires dans le concept ultra d’un hôtel relève de la description propre à l’hôtel : ce n’est pas l’objet du code de pension, mais de la description de l’hôtel. Pour les descriptions d’hôtels, consultez le produit contenu hôtelier. Pour une comparaison de prix correcte, le code de pension fonctionne avec le mapping hôtelier et le mapping des chambres. Pour le cadre général, consultez le guide du mapping hôtelier ; pour tester une seule graphie, le convertisseur de codes de pension.
Requête
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"]
}' Réponse
{
"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"
}
]
} Les exemples de code sont indicatifs ; les noms de champs peuvent changer lors de la publication de la v1.
L'AI (tout compris) couvre généralement les repas et les boissons locales. L'UAI (ultra tout compris) y ajoute généralement des services supplémentaires tels que les boissons importées ou les restaurants à la carte. Le périmètre varie d'un hôtel à l'autre ; nous convertissons le concept en code standard, c'est l'hôtel qui définit le contenu du concept.
Le Soft AI correspond à un code distinct, SAI. Il s'agit généralement d'une forme plus limitée du tout compris ; par exemple, les boissons alcoolisées ne sont pas proposées ou sont limitées à certains horaires. L'enregistrer comme AI ou FB+ fausse la comparaison des prix.
Le Half Board Plus (HB+) ajoute des boissons à la demi-pension ; en général, les boissons locales sont incluses au dîner, avec un périmètre variable selon l'hôtel. Si un fournisseur l'envoie simplement comme HB, l'information sur les boissons est perdue ; le code standard préserve cette différence.
Chez beaucoup de prestataires de mapping, le type de pension n'est pas proposé comme un produit à part. Chez hotelmapping.org, le mapping des types de pension est un produit distinct, qui fonctionne avec le mapping des hôtels et des chambres.
Oui. Dans l'outil gratuit de conversion de codes de pension, vous pouvez saisir une graphie comme « Ultra Herşey Dahil Plus » et voir à quel code standard elle correspond.
Demander un devis
Envoyez votre demande en trois étapes ; nous vous transmettons le devis à votre e-mail professionnel. La demande n'engage à rien.