Solutions Find Match API

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.

Ce que vous y gagnez

  • Aucun code fournisseur requis

    Pour vos hôtels sous contrat, vos fiches extranet ou un nom d'hôtel en texte libre, le nom et la localisation suffisent.

  • Score et décision ensemble

    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.

  • Résistant aux écarts de graphie

    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.

  • Liste de candidats

    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.

Avant et après

Fiche sans code fournisseur issue du système propre de l'agence

kontratli_oteller.csv
internal_id,name,city,lat,lng,phone
K-0192,Отель Лара Палм,Анталья,36.8567,30.7969,0242 000 00 00

Résultat de la Find Match API

POST /v1/match → 200 OK
{
  "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.

Comment ça marche

  1. 1

    Requête

    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.

  2. 2

    Normalisation

    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.

  3. 3

    Recherche de candidats

    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.

  4. 4

    Scoring

    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.

  5. 5

    Décision

    À 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.

Quand utiliser la Find Match API ?

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 :

  • Rattacher un à un vos hôtels sous contrat ou vos fiches extranet à un HM ID. Le mapping en lot des hôtels sous contrat via le portail est prévu.
  • Tester des fiches d’exemple avant de commencer à travailler avec un nouveau fournisseur.
  • Convertir en identifiant standard les noms d’hôtels en texte libre présents dans un système de réservation, de CRM ou de comptabilité.
  • Rattacher au bon établissement, avec les informations de localisation, le nom d’hôtel saisi dans une barre de recherche ou auprès d’un assistant d’IA.

Nous expliquons la logique générale du mapping dans le guide du mapping hôtelier.

Le champ de décision dans la réponse

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.

Pour un meilleur résultat

  • Envoyez les coordonnées. La recherche de candidats commence par la cellule géographique. Sans coordonnées, la ville et l’adresse sont utilisées ; le nombre de candidats augmente et le score baisse généralement. Pour la conversion d’une adresse en coordonnées, consultez le terme géocodage.
  • Ajoutez le téléphone et le site web. Un même numéro de téléphone ou nom de domaine est un signal de correspondance fort.
  • Envoyez le nom tel quel. Les noms en caractères cyrilliques ou arabes sont translittérés en alphabet latin grâce à la translittération.
  • Utilisez le champ 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.

Utilisation en lot et limites

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.

Qu'est-ce que le mapping hôtelier ? Le guide complet

Exemple d'API

Requête

Recherche de correspondance par nom et coordonnées
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

200 OK
{
  "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.

Questions fréquentes

Quelle est la différence entre la Find Match API et la recherche par code fournisseur ?

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.

Quels champs sont obligatoires dans la requête ?

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.

Que faire si la décision est review ?

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.

Puis-je rechercher avec un nom russe ou arabe ?

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.

Comment puis-je essayer l'API ?

Vous pouvez l'essayer sur des données d'exemple avec un compte sandbox.

Demander un devis

Obtenez votre devis sur mesure

Envoyez votre demande en trois étapes ; nous vous transmettons le devis à votre e-mail professionnel. La demande n'engage à rien.

  1. 1 Sélectionnez les solutions
  2. 2 Sélectionnez les fournisseurs
  3. 3 Laissez vos coordonnées