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 chambres décompose les différents noms que les fournisseurs envoient pour une même chambre en étiquettes de type, de classe, de vue, de lit, d'équipement et de capacité, puis regroupe la chambre sous un identifiant unique rattaché au HM ID de l'hôtel (par ex. HM-1048213-R03). Les prix d'une même chambre proposés par différents fournisseurs peuvent ainsi être comparés côte à côte.
{
"room_id": "HM-1048213-R03",
"hm_id": "HM-1048213",
"name": "Standard Double Room, Sea View, Balcony",
"type": "room",
"class": "standard",
"view": "sea",
"bed": "double",
"features": ["balcony"],
"max_occupancy": 3,
"supplier_rooms": {
"A": "DBLSV-B",
"B": "DZMB",
"C": "STD-DNZ"
}
} « DBL SV BLC », « DZ Meerblick Balkon » et « Deniz Manzaralı Balkonlu Çift Kişilik Oda » sont rattachés au même identifiant de chambre ; les prix se comparent sur une seule ligne.
Les abréviations et graphies de chambres en TR, EN, DE et RU sont conservées dans un dictionnaire de règles ; lorsque le dictionnaire ne suffit pas, le modèle d'étiquetage prend le relais.
Chaque nom de chambre est décomposé en six étiquettes. Le filtrage et le tri par vue, type de lit ou capacité ne nécessitent aucune analyse supplémentaire.
Les chambres vue terre et vue mer portent des étiquettes différentes ; elles restent donc sous des identifiants distincts et ne sont pas affichées sur la même ligne.
Plusieurs noms de chambres sont mappés instantanément en une seule requête ; le traitement par lot et la livraison de fichiers sont également disponibles pour l'ensemble de l'inventaire.
Noms de trois fournisseurs pour une même chambre
supplier,hotel_code,room_code,room_name
A,HTL-88213,DBLSV-B,Dbl Sea View Balcony
B,40917,DZMB,DZ Meerblick Balkon
C,TR-ANT-551,STD-DNZ,Standart Oda Deniz Manzaralı Balkonlu (2+1) Fiche de chambre unique décomposée en étiquettes
{
"room_id": "HM-1048213-R03",
"hm_id": "HM-1048213",
"name": "Standard Double Room, Sea View, Balcony",
"type": "room",
"class": "standard",
"view": "sea",
"bed": "double",
"features": ["balcony"],
"max_occupancy": 3,
"supplier_rooms": {
"A": "DBLSV-B",
"B": "DZMB",
"C": "STD-DNZ"
}
} Données d'exemple ; l'hôtel, les noms de chambres et les codes ne correspondent à aucun établissement réel.
Le nom de la chambre est découpé en mots et en abréviations. Les majuscules et minuscules, la ponctuation, la capacité entre parenthèses (« 2+1 ») et les différences de langue sont normalisées.
Chaque élément est associé au dictionnaire d'abréviations TR, EN, DE et RU : « SV », « Meerblick » et « Deniz Manzaralı » se rattachent à la même étiquette de vue.
Les éléments absents du dictionnaire ou ayant plusieurs sens sont affectés par un modèle d'étiquetage au type, à la classe, à la vue, au lit, à l'équipement ou à la capacité.
Les chambres rattachées au même HM ID sont comparées selon leurs étiquettes. Les noms dont les étiquettes concordent sont rattachés au même identifiant de chambre ; les fiches contradictoires passent en revue humaine.
Le résultat est renvoyé instantanément dans la réponse API et sous forme de fichier pour les traitements par lot. Chaque code de chambre fournisseur est conservé avec l'identifiant de chambre auquel il est rattaché.
Chaque fournisseur écrit le nom de la chambre selon les règles de son propre système. L’un utilise des abréviations (« DBL SV BLC »), un autre la langue de catalogue des tour-opérateurs allemands (« DZ Meerblick »), un troisième envoie tel quel le nom turc utilisé par l’hôtel. Avec 10 types de chambres dans un hôtel et 5 fournisseurs, le nombre de noms à mapper monte à 50. Le mapping manuel est lent ; une différence de vue ou de capacité passe facilement inaperçue.
Le mapping des chambres décompose chaque nom selon les mêmes six étiquettes et effectue la comparaison sur ces étiquettes plutôt que sur les noms. Pour un exposé détaillé du sujet, consultez le guide qu’est-ce que le mapping des chambres ; pour le cadre général, le guide du mapping hôtelier.
| Étiquette | Ce qu’elle décrit | Exemples de valeurs |
|---|---|---|
| Type | Catégorie de chambre | Chambre, suite, junior suite, studio, chambre familiale, villa, bungalow, appartement |
| Classe | Niveau de confort | Économique, standard, supérieure, deluxe |
| Vue | Ce que l’on voit de la fenêtre | Mer, vue latérale mer, terre, jardin, piscine |
| Lit | Configuration du couchage | Lit simple (single), lit double (double), lits jumeaux (twin), king, queen |
| Équipement | Équipement supplémentaire | Balcon, terrasse, jacuzzi, chambre avec accès piscine, chambre communicante |
| Capacité | Nombre maximal de personnes | SGL = 1, DBL = 2, TRP = 3, QUAD = 4 ; 2+1, 2+2 |
Le dictionnaire de règles relie les graphies d’un même concept dans quatre langues à une seule étiquette. Les lignes ci-dessous sont des exemples ; la liste complète figure dans le guide des abréviations de types de chambres.
| Concept | EN | DE | TR | RU |
|---|---|---|---|---|
| Occupation simple (capacité 1) | SGL | EZ (Einzelzimmer) | Tek kişilik | одноместный |
| Occupation double (capacité 2) | DBL | DZ (Doppelzimmer) | Çift kişilik | двухместный |
| Lits jumeaux (lit : twin) | TWN | 2 Einzelbetten | İki ayrı yataklı | две кровати |
| Chambre familiale | FAM | FZ (Familienzimmer) | Aile odası | семейный номер |
| Vue mer | SV | Meerblick | Deniz manzaralı | вид на море |
| Balcon | BLC | Balkon | Balkonlu | балкон |
| Suite | STE | Suite | Süit | люкс |
Chez la plupart des fournisseurs, DBL désigne une chambre pour deux personnes, sans toujours préciser le type de lit. C’est pourquoi « DBL » est d’abord lu comme une capacité (au moins 2 personnes). Si le nom ne contient ni TWN ni « twin », l’étiquette de lit est double ; si un indice plus explicite comme « king » est présent, c’est lui qui est retenu. L’étiquette de type, elle, est la catégorie de chambre : « DBL Sea View » est une chambre (room), « Junior Suite » est une junior suite.
Le mapping des chambres ne fonctionne qu’entre les chambres d’un même hôtel ; le HM ID de l’hôtel est donc déterminé d’abord par le mapping hôtelier. Pour que la comparaison des prix soit juste, le mapping des types de pension est également nécessaire avec la chambre. Pour les termes, consultez les pages du glossaire mapping des chambres et code fournisseur.
Requête
curl -X POST https://api.hotelmapping.org/v1/rooms/map \
-H "X-API-Key: $HM_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"hm_id": "HM-1048213",
"rooms": [
{ "supplier": "B", "code": "DZMB", "name": "DZ Meerblick Balkon" },
{ "supplier": "B", "code": "FZLS", "name": "FZ Landseite" }
]
}' Réponse
{
"hm_id": "HM-1048213",
"groups": [
{
"room_id": "HM-1048213-R03",
"type": "room",
"class": "standard",
"view": "sea",
"bed": "double",
"features": ["balcony"],
"max_occupancy": 3,
"matched": [
{ "supplier": "B", "code": "DZMB", "name": "DZ Meerblick Balkon", "confidence": 0.98, "decision": "auto_match" }
]
},
{
"room_id": "HM-1048213-R07",
"type": "family_room",
"class": "standard",
"view": "land",
"bed": null,
"features": [],
"max_occupancy": 4,
"matched": [
{ "supplier": "B", "code": "FZLS", "name": "FZ Landseite", "confidence": 0.91, "decision": "review" }
]
}
]
} Les exemples de code sont indicatifs ; les noms de champs peuvent changer lors de la publication de la v1.
Oui. Les noms de chambres ne sont comparés qu'aux chambres du même hôtel. Le HM ID de l'hôtel est donc déterminé en premier, puis les noms de chambres fournisseurs de cet hôtel sont regroupés.
Le nouveau nom est de nouveau étiqueté. Si les étiquettes n'ont pas changé, la chambre reste rattachée au même identifiant. Dans le cas contraire, la fiche passe dans la file de contrôle et, si nécessaire, est rattachée à un autre identifiant de chambre.
Il est prévu d'appliquer aussi aux chambres la logique de seuils du mapping hôtelier : à partir de 0,97, le rattachement est automatique ; entre 0,80 et 0,97, la fiche va à un expert ; en dessous de 0,80, une nouvelle fiche de chambre est créée. Les décisions des experts alimentent en retour le dictionnaire et le modèle.
Au lancement, le dictionnaire de règles couvre les abréviations en turc, anglais, allemand et russe. La couverture de l'arabe et des autres langues n'est pas encore arrêtée.
Non. Le mapping des chambres ne standardise que les données statiques des chambres. Les prix et les disponibilités vont du fournisseur à votre système ; nous indiquons seulement à quelle chambre ils appartiennent.
Demander un devis
Envoyez votre demande en trois étapes ; nous vous transmettons le devis à votre e-mail professionnel. La demande n'engage à rien.