Solutions de mapping hôtelier
Un HM ID permanent pour chaque établissement ; codes fournisseurs et ID croisés dans une seule fiche.
La Find Match API prend une fiche d'hôtel unique en votre possession (nom, adresse, coordonnées, et téléphone et site web le cas échéant) et trouve son équivalent dans la base hotelmapping.org. La réponse contient le HM ID correspondant, un score de confiance de 0 à 1 et la décision rendue selon ce score. Elle fonctionne aussi pour les fiches sans code fournisseur.
{
"reference": "K-0192",
"normalized_name": "lara palm",
"decision": "auto_match",
"hm_id": "HM-1052207",
"name": "Lara Palm Hotel",
"confidence": 0.973,
"signals": {
"name_similarity": 0.95,
"distance_m": 63,
"phone_match": true
}
} Pour vos hôtels sous contrat, vos fiches extranet ou un nom d'hôtel en texte libre, le nom et la localisation suffisent.
Chaque réponse renvoie le score de confiance et le champ de décision. Vous pouvez aussi restreindre, avec votre propre règle métier, les fiches que vous acceptez automatiquement.
Les abréviations, les suffixes manquants et les noms en caractères cyrilliques ou arabes passent par la normalisation. Des écarts comme « Rsrt. » et « Resort » sont comparés au niveau des caractères et des mots dans la similarité des noms.
Les candidats les plus probables sont renvoyés avec leur distance et leur score ; la décision est facilitée pour les fiches à contrôler.
Fiche sans code fournisseur issue du système propre de l'agence
internal_id,name,city,lat,lng,phone
K-0192,Отель Лара Палм,Анталья,36.8567,30.7969,0242 000 00 00 Résultat de la Find Match API
{
"reference": "K-0192",
"normalized_name": "lara palm",
"decision": "auto_match",
"hm_id": "HM-1052207",
"name": "Lara Palm Hotel",
"confidence": 0.973,
"signals": {
"name_similarity": 0.95,
"distance_m": 63,
"phone_match": true
}
} Données d'exemple ; le nom de l'hôtel, le téléphone et les codes ne correspondent à aucun établissement réel. Le nom russe est translittéré en alphabet latin et le suffixe « hôtel » est séparé avant la comparaison.
Le nom de l'hôtel et sa localisation sont envoyés au point d'accès POST /v1/match. La correspondance se renforce à mesure que vous ajoutez coordonnées, adresse, téléphone et site web.
Les suffixes tels que « Hotel », « Resort & Spa » ou « Otel » sont séparés du nom ; les noms russes et arabes sont translittérés en alphabet latin ; le téléphone est ramené au format international et le site web au nom de domaine.
La fiche n'est comparée qu'aux hôtels situés à proximité : cellule géographique d'environ 500 mètres, similarité des noms, même téléphone ou même nom de domaine.
Similarité des noms, similarité d'embeddings multilingues, distance, correspondance du téléphone et du site web, étoiles et code postal se combinent pour produire un score de probabilité de 0 à 1.
À partir de 0,97, auto_match est renvoyé ; entre 0,80 et 0,97, review ; en dessous de 0,80, no_match, avec un hm_id null. La réponse contient aussi les candidats les plus probables.
Le produit de mapping hôtelier rattache les fichiers fournisseurs aux HM ID en lot. La Find Match API sert, elle, à interroger instantanément une fiche unique. Cas d’usage typiques :
Nous expliquons la logique générale du mapping dans le guide du mapping hôtelier.
| Score de confiance | decision |
Que faire ? |
|---|---|---|
| 0,97 et plus | auto_match |
Vous pouvez utiliser directement le HM ID |
| 0,80–0,97 | review |
Vérifiez les candidats ; examinez les écarts de nom, de distance et de téléphone |
| Moins de 0,80 | no_match |
hm_id est renvoyé à null. L’établissement n’est peut-être pas encore dans la base ; vérifiez le nom et la localisation |
Les seuils sont calibrés sur un jeu de test étiqueté manuellement et peuvent évoluer d’une version à l’autre. Nous expliquons de quels signaux le score est composé au terme score de correspondance.
reference. Votre propre identifiant de fiche est renvoyé tel quel dans la réponse ; il est plus facile de rattacher les résultats à votre propre table.Plutôt que d’interroger des milliers de fiches une à une, confiez votre fichier au flux de mapping hôtelier ; le résultat revient par dump quotidien complet et delta. La Find Match API ne crée pas de nouvel identifiant pour une fiche en dessous de 0,80 ; dans le flux d’ingestion en lot, en revanche, un nouveau HM ID est créé pour ces fiches (décision new_id). Avec le HM ID trouvé, vous accédez aussi aux données de destination et de contenu hôtelier.
Les champs de réponse correspondent à un projet de l’API v1 ; le schéma définitif sera publié sur la page développeurs.
Requête
curl -X POST https://api.hotelmapping.org/v1/match \
-H "X-API-Key: $HM_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"reference": "res-55821",
"name": "Sunset Bay Rsrt. & Spa - Adults",
"city": "Belek",
"country": "TR",
"lat": 36.8539,
"lng": 31.0556
}' Réponse
{
"reference": "res-55821",
"decision": "auto_match",
"hm_id": "HM-1048213",
"name": "Sunset Bay Resort & Spa",
"confidence": 0.984,
"candidates": [
{ "hm_id": "HM-1048213", "confidence": 0.984, "distance_m": 42 },
{ "hm_id": "HM-1048390", "confidence": 0.412, "distance_m": 310 }
]
} Les exemples de code sont indicatifs ; les noms de champs peuvent changer lors de la publication de la v1.
La recherche par code fournisseur (GET /v1/suppliers/{supplier}/codes/{code}) renvoie directement le HM ID d'un code déjà mappé. La Find Match API, elle, recherche par nom, adresse et coordonnées une fiche sans code ou inconnue du système, et calcule un nouveau score.
Le nom de l'hôtel et sa localisation (coordonnées, ou pays, ville et adresse) sont nécessaires. Le téléphone, le site web et le code postal sont facultatifs mais renforcent le score.
Comparez les candidats de la réponse selon le nom, la distance et le score. La voie d'envoi (portail ou API) des fiches que vous ne parvenez pas à trancher vers la revue humaine n'est pas encore arrêtée. Les décisions des experts sont ajoutées au modèle comme données d'entraînement.
Oui. Les noms en caractères cyrilliques et arabes sont translittérés en alphabet latin lors de la normalisation ; la similarité d'embeddings multilingues participe aussi au score. Vous n'avez pas à traduire le nom vous-même.
Vous pouvez l'essayer sur des données d'exemple avec un compte sandbox.
Demander un devis
Envoyez votre demande en trois étapes ; nous vous transmettons le devis à votre e-mail professionnel. La demande n'engage à rien.