Achat

12 questions à poser pour choisir une API de mapping hôtelier

Demandez comment la précision est mesurée, si la couverture vaut pour vos régions, comment sont traitées les correspondances incertaines, si les ID sont permanents, si les chambres et pensions sont prises en charge, quelles sont les livraisons et les conditions de sortie. Validez chaque réponse par un essai avec vos données.

Auteur
Équipe éditoriale de hotelmapping.org
Dernière mise à jour:
13 min de lecture

Comment utiliser cette liste ?

La plupart des fournisseurs de mapping hôtelier promettent une grande précision, une large couverture et une intégration facile. Quand les promesses se ressemblent, le choix se réduit facilement au prix et à l’impression laissée par la démo. Or les différences sont dans les détails : la façon dont la précision est mesurée, ce qui arrive aux fiches incertaines, comment l’ID se comporte quand un hôtel ferme, si les chambres et les types de pension sont inclus dans la couverture.

Les 12 questions ci-dessous regroupent en cinq rubriques les sujets à examiner lors de l’évaluation d’une API de mapping hôtelier. Pour chaque question, nous avons indiqué pourquoi elle compte et comment valider la réponse. La liste est neutre ; elle peut s’appliquer de la même manière à tous les fournisseurs, hotelmapping.org compris.

Si le sujet est nouveau pour vous, nous vous conseillons de lire d’abord le guide qu’est-ce que le mapping hôtelier. Nous avons expliqué les côtés statique et dynamique des connexions fournisseurs dans l’article intégration XML hôtelière.

Qualité des données

1. Comment la précision est-elle mesurée et quel est le taux de fausses correspondances ?

Pourquoi c’est important : une fausse correspondance coûte souvent plus cher qu’une correspondance manquée. Si deux hôtels différents sont fusionnés en une seule fiche, le client peut réserver dans le mauvais hôtel ; cela signifie annulation, réclamation et coût supplémentaire. Le mot « précision » ne recouvre pas la même chose chez tous les fournisseurs : le taux peut avoir été calculé uniquement sur les correspondances automatiques, ou en incluant les fiches passées par la revue humaine.

Comment valider : demandez avec quel jeu de test la mesure a été faite : combien de paires d’hôtels, de quelles régions, étiquetées par qui, mesurées pour la dernière fois quand ? Demandez séparément le taux de fausses correspondances (faux positifs) et le taux de correspondances manquées (faux négatifs). Envoyez ensuite un échantillon tiré de vos propres données fournisseurs et contrôlez les résultats à la main avec votre équipe.

2. Pour quelles régions et quels fournisseurs le taux de couverture est-il valable ?

Pourquoi c’est important : un taux de couverture global peut ne pas refléter la situation dans les régions que vous vendez. Les régions de resorts méditerranéens sont un terrain difficile, avec de nombreux établissements homonymes et des emplacements proches les uns des autres. De plus, la couverture dépend du fait que le fournisseur traite déjà ou non les données de vos fournisseurs.

Comment valider : donnez la liste des fournisseurs avec lesquels vous travaillez et demandez un taux de couverture distinct pour chacun. Pour les destinations que vous vendez le plus (par ex. Antalya, Muğla, Istanbul), demandez un résultat par région. Demandez si le taux de couverture est calculé sur le total des fiches ou sur les fiches actives et vendables.

3. Comment les correspondances incertaines sont-elles traitées ?

Pourquoi c’est important : la plupart des systèmes de mapping produisent un score de correspondance et utilisent des valeurs de seuil. Ce que l’on fait des fiches au score incertain détermine directement la qualité : sont-elles quand même rapprochées automatiquement, un expert les contrôle-t-il, ou une nouvelle fiche est-elle ouverte ?

Comment valider : demandez les valeurs de seuil et ce qui se passe dans chaque intervalle. Demandez le taux de fiches tombant en revue humaine et le délai moyen de décision. Regardez si le score vous est renvoyé dans la réponse de l’API ; s’il l’est, vous pouvez appliquer de votre côté un seuil plus strict.

Identité et cycle de vie

4. L’ID est-il permanent ; que deviennent les hôtels fermés, fusionnés et scindés ?

Pourquoi c’est important : l’identifiant de mapping est inscrit dans votre historique de réservations, vos tables de contenu et vos rapports. Si un ID est réattribué à un autre hôtel ou supprimé en silence, vos données historiques sont corrompues.

Comment valider : demandez par écrit si un ID peut être réattribué à un autre hôtel. Quand deux hôtels fusionnent, demandez si l’ancien ID est redirigé vers le nouveau et comment cela apparaît dans l’API (par ex. un champ status ou merged_into), avec un exemple de réponse. Regardez si les hôtels fermés sont marqués comme inactifs.

5. Pouvez-vous reprendre vos ID et vos codes existants ?

Pourquoi c’est important : la plupart des équipes ne repartent pas de zéro. Vous pouvez avoir vos propres codes hôtel ou les ID d’un service de mapping utilisé auparavant. Si le nouveau fournisseur ne peut pas les conserver en référence croisée, le coût de la migration augmente.

Comment valider : envoyez un échantillon de votre table de mapping actuelle et regardez si les anciens identifiants reviennent avec les nouveaux ID. En cas de conflit (quand votre table et le résultat du fournisseur diffèrent), demandez lequel fait foi et si ces écarts vous sont signalés.

6. Comment les changements de code fournisseur sont-ils notifiés ?

Pourquoi c’est important : les fournisseurs suppriment des codes, en attribuent de nouveaux, relistent un hôtel sous un autre code. Si ces changements ne vous parviennent pas, votre table de mapping vieillit en silence et des hôtels manquants ou des doublons apparaissent en recherche.

Comment valider : demandez par quel canal les changements sont notifiés : delta dump, webhook ou point d’accès d’historique des modifications. Regardez si les fiches supprimées et fusionnées figurent explicitement dans le delta. Demandez un exemple de fichier delta du dernier mois.

Profondeur de couverture

7. Le mapping des chambres existe-t-il et comment fonctionne-t-il ?

Pourquoi c’est important : le mapping hôtelier seul ne suffit pas à comparer les prix. Si « DBL SV », « Double Room Sea View » et « Deniz Manzaralı Çift Kişilik Oda » sont la même chambre, il faut aussi les rattacher à une seule identité. Sinon, la même chambre apparaît plusieurs fois sur la même carte d’hôtel.

Comment valider : demandez si le mapping des chambres est un produit distinct ou inclus dans le mapping hôtelier. Renseignez-vous pour savoir s’il fonctionne instantanément (à chaque appel) ou en masse. Envoyez des noms de chambre difficiles tirés de vos données (abréviations, multilingues, chambres familiales, chambres communicantes) et examinez les résultats. Pour les détails, consultez notre page de mapping des chambres.

8. Le mapping des types de pension et des destinations est-il pris en charge ?

Pourquoi c’est important : sur le marché des resorts, le type de pension est l’un des principaux facteurs de prix. Si des orthographes comme « AI », « All Inclusive », « Ultra Her Şey Dahil », « Soft AI » ne sont pas converties en un code standard, des pensions différentes peuvent être comparées sur la même ligne de prix. Côté destinations, les fournisseurs envoient la même région avec des hiérarchies différentes (par ex. un fournisseur « Antalya », un autre « Belek »).

Comment valider : demandez la liste des codes de pension standard pris en charge. Envoyez les orthographes de pension de vos propres fournisseurs et regardez vers quel code elles sont converties. Pour les destinations, demandez si les niveaux pays, province, district et zone de resorts sont tenus séparément.

9. Comment les noms et adresses multilingues sont-ils traités ?

Pourquoi c’est important : le même hôtel peut arriver en caractères latins chez un fournisseur, en cyrillique ou en arabe chez un autre. Les caractères turcs (ç, ğ, ı, ö, ş, ü) sont altérés ou perdus dans certains systèmes. Ces écarts compliquent le mapping fondé sur la similarité des noms.

Comment valider : demandez comment la translittération et la normalisation des caractères sont faites. Incluez dans l’échantillon des hôtels arrivant avec des noms russes ou arabes et des fiches aux caractères turcs altérés. Évaluez séparément les résultats pour ce sous-groupe.

Intégration technique et exploitation

10. Quels sont les modes de livraison, les limites et la fraîcheur ?

Pourquoi c’est important : le résultat du mapping est utilisé au moment de la recherche. Aller chercher à chaque recherche une API distante peut créer de la latence ; la plupart des équipes conservent les résultats chez elles sous forme de table. C’est pourquoi la livraison de fichiers en masse (dump) compte autant que l’API.

Comment valider : demandez par écrit les détails suivants :

  • Points d’accès de l’API et exemples de requête/réponse
  • Limites d’appels (par minute, jour, mois) et ce qui se passe en cas de dépassement
  • Formats de dump complet et delta (CSV, JSON, Parquet, etc.) et fréquence de publication
  • Prise en charge des webhooks
  • Délai de mapping d’un nouveau fichier fournisseur
  • Environnement d’essai (sandbox) et documentation publique ou non

Dans l’environnement d’essai, faites tourner pendant quelques jours un flux proche de votre charge de travail réelle.

11. Que se passe-t-il quand une fausse correspondance est signalée ?

Pourquoi c’est important : aucun système n’est sans erreur. La différence tient à la rapidité de correction de l’erreur et à la répétition ou non de la même erreur. Si le processus de correction est flou, votre équipe doit rafistoler à la main les fiches erronées de son côté.

Comment valider : demandez le canal de signalement des erreurs (API, portail, e-mail) et le délai de correction visé. Renseignez-vous pour savoir si la correction s’applique uniquement dans votre compte ou pour tous les clients. Regardez si le contrat comporte un niveau de service (SLA) et si la langue du support convient à votre équipe. Pendant l’essai, signalez volontairement une erreur et suivez le processus de bout en bout.

Conditions commerciales

12. Quels sont le modèle tarifaire, l’essai et les conditions de sortie ?

Pourquoi c’est important : les services de mapping peuvent être facturés selon le nombre de fournisseurs, d’hôtels, d’appels ou de modules produit. Si le modèle ne correspond pas à votre plan de croissance, le coût augmente de manière inattendue. De plus, la possibilité de continuer à utiliser vos résultats de mapping à la fin du contrat détermine le coût de migration.

Comment valider : regardez si le prix est indiqué clairement, quels modules sont inclus et s’il y a des frais pour fournisseur supplémentaire. Demandez s’il existe un essai gratuit ou un environnement de test (sandbox). Demandez par écrit sous quel format les données peuvent être exportées à la fin du contrat et les conditions de licence.

Les 12 questions en un coup d’œil

# Question Preuve à demander Signal d’alerte
1 Comment la précision est-elle mesurée ? Description du jeu de test, résultat sur votre propre échantillon Un seul taux dont la méthode n’est pas expliquée
2 Quelle couverture sur vos régions ? Taux par fournisseur et par région Seulement un taux global
3 Que deviennent les correspondances incertaines ? Valeurs de seuil, taux de revue humaine Score non renvoyé par l’API
4 L’ID est-il permanent ? Exemple de réponse pour fusion et fermeture ID pouvant être réutilisé
5 Les ID existants sont-ils repris ? Exemple de sortie avec références croisées Perte des anciens codes
6 Les changements de code sont-ils notifiés ? Exemple de fichier delta Fiches supprimées absentes du delta
7 Le mapping des chambres existe-t-il ? Résultat de test avec des noms de chambre difficiles Renvoi de texte libre uniquement
8 Pensions et destinations ? Liste de codes standard, exemple de hiérarchie Type de pension hors périmètre
9 Les noms multilingues sont-ils traités ? Test avec des fiches en cyrillique et en arabe Baisse nette sur ce sous-groupe
10 Quelles livraisons et limites ? Documentation, sandbox, exemple de dump Pas d’option de livraison en masse
11 Comment les erreurs sont-elles corrigées ? Canal de signalement, délai visé, SLA Processus de correction flou
12 Quelles conditions de prix et de sortie ? Prix écrit, droit d’export Données inutilisables en fin de contrat

Exemple : que regarder dans une réponse de mapping ?

Les réponses d’API que vous recevez pendant l’évaluation répondent d’un coup d’œil à plusieurs des questions ci-dessus. Ci-dessous, nous montrons à titre d’exemple, pour un hôtel fictif, la réponse de POST /v1/match de l’API v1 (version préliminaire) de hotelmapping.org ; les noms de champs d’autres fournisseurs peuvent différer.

Requête :

{
  "reference": "res-20417",
  "name": "Kemer Pine Garden Hotel",
  "address": "Göynük Mah. Atatürk Cad. No:45, Kemer, Antalya",
  "lat": 36.6515,
  "lng": 30.5601,
  "supplier": "C",
  "supplier_code": "KPG-7781"
}

Réponse :

{
  "reference": "res-20417",
  "hm_id": "HM-1061590",
  "confidence": 0.984,
  "decision": "auto_match",
  "status": "active",
  "merged_into": null,
  "destination_id": "TR-07-KEMER-GOYNUK",
  "external_ids": { "client": "OTL-2231" },
  "supplier_codes": { "A": "KPGH-1102", "C": "KPG-7781" },
  "matched_at": "2026-11-15T09:20:00Z"
}

Ce sont des données d’exemple ; le nom de l’hôtel, l’adresse et les codes n’appartiennent à aucun établissement réel. Les noms de champs sont ceux de la version préliminaire v1 et peuvent changer. Dans cette réponse, regardez les points suivants :

  • confidence et decision : le score et le type de décision sont-ils renvoyés ? (Question 3)
  • status et merged_into : l’état de fermeture et de fusion est-il visible ? (Question 4)
  • external_ids : vos propres codes hôtel ou les identifiants de votre prestataire actuel sont-ils repris ? (Question 5)
  • supplier_codes : les codes des autres fournisseurs du même hôtel sont-ils réunis dans une seule fiche ? (Question 6)
  • destination_id : la hiérarchie des destinations arrive-t-elle avec un identifiant standard ? (Question 8)

Les détails de l’API Find Match se trouvent sur les pages API de correspondance et mapping hôtelier, la liste des points d’accès sur la page développeurs.

Comment organiser l’essai ?

Pour obtenir les réponses aux questions par les données plutôt que par une présentation, un court plan d’essai suffit :

  1. Préparez un échantillon : constituez une liste de fiches issues de tous vos fournisseurs, des régions que vous vendez le plus et des cas difficiles (hôtels homonymes, établissements proches, noms multilingues).
  2. Déterminez à l’avance les bonnes réponses : mappez à la main avec votre équipe une partie de cette liste. C’est la référence à laquelle vous comparerez les résultats du fournisseur.
  3. Envoyez les mêmes données à tous les candidats : pour que la comparaison soit équitable, chaque fournisseur doit recevoir le même fichier.
  4. Mesurez les résultats séparément : produisez des chiffres distincts pour les fausses correspondances, les correspondances manquées, les fiches tombant en revue humaine et le délai de livraison.
  5. Testez l’exploitation : signalez une erreur, demandez un fichier delta, essayez les limites de l’API.
  6. Obtenez les conditions contractuelles par écrit : le prix, le SLA et le droit d’export des données doivent figurer clairement dans l’offre.

Calculer ce que les doublons coûtent à votre activité vous aide à traduire les résultats de l’essai en impact commercial. Pour cela, consultez l’article sur le coût du doublon d’hôtel.

Posez aussi ces questions à hotelmapping.org

Nous n’avons pas préparé cette liste en faveur d’un fournisseur ; nous attendons de vous que vous posiez les mêmes questions à hotelmapping.org. Nos valeurs mesurées de précision et de couverture seront publiées sur la page de couverture une fois le jeu de test achevé. Nous avons expliqué sur la page de demande de devis comment la tarification est déterminée selon les modules et le nombre de fournisseurs. Si vous comparez plusieurs fournisseurs, mesurez les résultats sur le même jeu de données ; nous avons expliqué comment lire ensemble les chiffres de précision et de couverture dans l’article précision ou couverture ?.

Questions fréquentes

Quelle est la différence entre précision et couverture ?

La précision indique quelle part des correspondances effectuées est réellement exacte. La couverture indique quelle part des fiches fournisseurs a pu être rattachée à un hôtel. L'une peut être élevée et l'autre basse ; il faut donc les demander séparément, sur le même jeu de données.

Quelle quantité de données suffit pour un essai ?

Il n'y a pas de chiffre précis. L'important est que l'échantillon représente votre inventaire réel : les régions que vous vendez le plus, les cas difficiles (hôtels homonymes, noms en caractères cyrilliques ou arabes, établissements proches) et tous vos fournisseurs doivent y figurer.

Si je change de prestataire, mes correspondances sont-elles perdues ?

Cela dépend du contrat et des conditions de propriété des données. Avant de choisir, demandez par écrit sous quel format vous pouvez exporter les résultats de mapping et si vous pourrez continuer à utiliser ces données après la fin du contrat.

Pouvons-nous aussi poser ces questions à hotelmapping.org ?

Oui. La liste a été préparée de façon neutre et peut s'appliquer de la même manière à tous les fournisseurs, hotelmapping.org compris. Un essai avec vos propres données est la méthode de comparaison la plus fiable.

Équipe éditoriale de hotelmapping.org

Équipe données hôtelières de DIJI.TECH

L'équipe DIJI.TECH, spécialisée dans le mapping hôtelier, l'intégration de fournisseurs et les logiciels de voyage.

Produits associés

  • Solutions Find Match API

    Envoyez nom, adresse et coordonnées ; recevez un HM ID et un score de confiance. Aucun code fournisseur requis.

  • Solutions de mapping hôtelier

    Un HM ID permanent pour chaque établissement ; codes fournisseurs et ID croisés dans une seule fiche.

  • Solutions de mapping des chambres

    Décompose les noms de chambres en type, classe, vue, lit et capacité ; regroupe une même chambre sous un seul ID.