# Solutions de mapping hôtelier

> URL: https://hotelmapping.org/fr/produits/solutions-mapping-hotelier/ · Langue: Français

Le mapping hôtelier réunit sous un identifiant permanent unique (HM ID) les noms, codes et adresses différents que les fournisseurs envoient pour un même hôtel. Les codes fournisseurs, le Google Place ID et les coordonnées sont rattachés à cet identifiant ; les identifiants hôteliers de votre prestataire de mapping actuel ou de votre propre système sont conservés comme références croisées. Ainsi, chaque hôtel n'apparaît qu'une seule fois dans votre liste.

## Ce que vous y gagnez

- **Chaque hôtel une seule fois dans la liste:** Les fiches d'un même hôtel provenant de différents fournisseurs sont regroupées sur une seule carte ; la meilleure offre apparaît en un seul endroit.
- **Identifiant permanent:** Un HM ID n'est jamais réattribué à un autre hôtel. Lorsque des hôtels fusionnent, l'ancien ID est redirigé vers le nouveau.
- **Vos ID existants sont conservés:** Nous stockons comme références croisées les identifiants hôteliers de votre prestataire de mapping actuel ou de votre propre système ; vous ne perdez pas le mapping réalisé jusqu'ici.
- **Nouveau fournisseur rapidement opérationnel:** Le fichier d'un nouveau fournisseur passe par la normalisation et le scoring, puis est rattaché aux HM ID en peu de temps.

## Avant et après

Fiches brutes de trois fournisseurs

**supplier_static.csv**

```csv
supplier,code,name,city,lat,lng
A,HTL-88213,Sunset Bay Resort & Spa,Belek,36.8541,31.0552
B,40917,SUNSET BAY RESORT SPA,Serik,36.8543,31.0549
C,TR-ANT-551,Sunset Bay Rsrt. & Spa - Adults,Antalya,36.8539,31.0556
```

Fiche standard sous un seul HM ID

**GET /v1/hotels/HM-1048213**

```json
{
  "hm_id": "HM-1048213",
  "name": "Sunset Bay Resort & Spa",
  "destination_id": "TR-07-SERIK-BELEK",
  "destination": ["TR", "Antalya", "Serik", "Belek"],
  "geo": { "lat": 36.8541, "lng": 31.0552 },
  "supplier_codes": {
    "A": "HTL-88213",
    "B": "40917",
    "C": "TR-ANT-551"
  },
  "external_ids": { "client": "OTL-2231" },
  "status": "active"
}
```

_Données d'exemple ; le nom de l'hôtel et les codes ne correspondent à aucun établissement réel._

## Comment ça marche

1. **Ingestion des données:** Nous récupérons les données statiques du fournisseur par API, CSV ou FTP. Chaque fiche est conservée à l'état brut et les modifications sont versionnées.
2. **Normalisation:** Les suffixes tels que « Hotel » ou « Resort & Spa » sont séparés du nom de l'hôtel ; les noms russes et arabes sont translittérés en alphabet latin ; l'adresse, le téléphone et le site web sont ramenés à un format standard.
3. **Génération de candidats et scoring:** Chaque fiche n'est comparée qu'aux hôtels situés à proximité. Similarité des noms, embeddings multilingues, distance, téléphone et site web se combinent pour produire un score de probabilité entre 0 et 1.
4. **Décision et revue humaine:** À partir d'un score de 0,97, la correspondance est automatique ; les fiches entre 0,80 et 0,97 arrivent chez un expert sur un écran de contrôle cartographique ; en dessous de 0,80, un nouveau HM ID est créé.
5. **Livraison:** Le résultat vous parvient par l'API REST et par un dump quotidien complet et delta (CSV, JSON, Parquet) ; les webhooks sont prévus.

## Exemple d'API

**Du code fournisseur au HM ID**

```bash
curl https://api.hotelmapping.org/v1/suppliers/B/codes/40917 \
  -H "X-API-Key: $HM_API_KEY"
```

**200 OK**

```json
{
  "supplier": "B",
  "code": "40917",
  "hm_id": "HM-1048213",
  "confidence": 0.998,
  "matched_at": "2026-11-02T08:14:00Z"
}
```

_Les exemples de code sont indicatifs ; les noms de champs peuvent changer lors de la publication de la v1._

## Pourquoi le mapping hôtelier est-il nécessaire ?

Une agence travaille en moyenne avec plusieurs fournisseurs, et chacun envoie le même hôtel avec son propre nom, son propre code et ses propres coordonnées. Sans mapping, le même hôtel apparaît plusieurs fois dans la liste, la comparaison des prix est faussée et le client ne sait pas quelle carte est la bonne.

hotelmapping.org travaille avec 3,5 millions d'hôtels dans le monde et réunit ces fiches sous un identifiant permanent unique, le **HM ID**. Vous ne travaillez qu'avec le HM ID ; nous suivons quel fournisseur utilise quel code.

## Que rattachons-nous ?

| Champ | Description |
| --- | --- |
| Codes fournisseurs | Le code hôtel de chaque fournisseur, rattaché au HM ID |
| Identifiants hôteliers externes | Identifiants de votre prestataire de mapping actuel ou de votre propre système ; stockés comme références croisées le cas échéant |
| Google Place ID | Référence supplémentaire pour la localisation et l'identité |
| Coordonnées | Latitude et longitude retenues parmi les fiches fournisseurs (vérification des coordonnées prévue) |
| Destination | Hiérarchie pays → province → district → zone de villégiature |

## Comment la qualité est-elle mesurée ?

La qualité du mapping est mesurée à chaque version à l'aide d'un jeu de test étiqueté manuellement. Nous ne publions sur le site que les chiffres validés par cette mesure ; les valeurs actuelles figurent sur la [page de couverture](https://hotelmapping.org/fr/couverture/).

## Questions fréquentes

### Quelle est la différence entre un HM ID et un code fournisseur ?

Le code fournisseur n'est valable que dans le système de ce fournisseur et varie d'un fournisseur à l'autre. Le HM ID est l'identifiant permanent que nous attribuons et qui réunit tous les codes fournisseurs d'un même hôtel.

### Que se passe-t-il en cas de mauvaise correspondance ?

Les scores incertains ne donnent pas lieu à une correspondance automatique : ils passent en revue humaine. Si vous signalez malgré tout une erreur, la fiche est corrigée et cette décision est ajoutée au modèle comme donnée d'entraînement.

### Que devient le HM ID si un hôtel ferme ou si deux hôtels fusionnent ?

Un HM ID n'est jamais attribué à un autre hôtel. Le statut d'un hôtel fermé passe à « closed ». Pour les hôtels fusionnés, le statut de l'ancien ID passe à « merged » et le champ merged_into indique le nouvel ID.

### En changeant de prestataire de mapping, pouvons-nous continuer à utiliser nos identifiants hôteliers actuels ?

Oui. Nous stockons comme références croisées les identifiants hôteliers de votre prestataire de mapping actuel ou de votre propre système ; ils sont renvoyés avec le HM ID dans le champ external_ids de la réponse API. Vous pouvez ainsi passer au HM ID sans abandonner votre mapping existant.

## Produits associés

- [Solutions de mapping des chambres](https://hotelmapping.org/fr/produits/solutions-mapping-chambres/)
- [Solutions de mapping des types de pension](https://hotelmapping.org/fr/produits/solutions-mapping-types-pension/)
- [Solutions Find Match API](https://hotelmapping.org/fr/produits/solutions-find-match-api/)

## Articles associés

- [Qu'est-ce que le mapping hôtelier (hotel mapping) ? Fonctionnement et guide complet](https://hotelmapping.org/fr/guide/qu-est-ce-que-le-mapping-hotelier/)
- [Coût des hôtels en double pour l'agence : conversion, annulations et réclamations clients](https://hotelmapping.org/fr/guide/cout-des-hotels-en-double-pour-l-agence/)
- [12 questions à poser pour choisir une API de mapping hôtelier](https://hotelmapping.org/fr/guide/12-questions-choisir-api-mapping-hotelier/)
