Solutions d'images de chambres

Images de chambres relie les photos que les fournisseurs envoient pour chaque chambre aux types de chambres standard issus du mapping des chambres (par ex. HM-1048213-R03). Chaque offre de chambre s'affiche alors avec les photos propres à cette chambre, et non avec la galerie générale de l'hôtel. La même photo venant de fournisseurs différents est regroupée en une seule image, et les images sont renvoyées par l'API avec les données de la chambre.

Ce que vous y gagnez

  • La bonne chambre, la bonne photo

    L'offre d'une chambre vue mer avec balcon s'affiche avec les photos de cette chambre ; le client n'a pas à chercher sa chambre dans la galerie générale de l'hôtel.

  • Les fournisseurs convergent vers un seul type de chambre

    Les photos que trois fournisseurs envoient pour la même chambre sont rassemblées sous l'unique identifiant de chambre créé par le mapping des chambres.

  • Les doublons en une seule image

    Les copies d'une même photo de chambre reçues de fournisseurs différents et dans des tailles différentes sont regroupées sous une seule image.

  • Avec les données de la chambre

    Les images reviennent dans la même réponse que le type de chambre, la vue, le lit et la capacité ; aucune étape de rapprochement distincte n'est nécessaire.

Avant et après

Photos de chambres venant de trois fournisseurs

supplier_room_images.csv
supplier,hotel_code,room_code,room_name,image_url,width
A,HTL-88213,DBLSV-B,Dbl Sea View Balcony,https://img.supplier-a.example/88213/rooms/dblsv-1.jpg,1920
B,40917,DZMB,DZ Meerblick Balkon,https://cdn.supplier-b.example/40917/zimmer/dzmb_01.jpg,1024
C,TR-ANT-551,STD-DNZ,Standart Oda Deniz Manzaralı Balkonlu (2+1),https://media.supplier-c.example/551/IMG_3101.jpg,800
B,40917,FZLS,FZ Landseite,https://cdn.supplier-b.example/40917/zimmer/fzls_01.jpg,1024

Images reliées aux types de chambres standard

Images de chambres HM-1048213
{
  "hm_id": "HM-1048213",
  "rooms": [
    {
      "room_id": "HM-1048213-R03",
      "name": "Standard Double Room, Sea View, Balcony",
      "images": [
        {
          "image_id": "HM-1048213-R03-I001",
          "copies": [
            { "supplier": "A", "room_code": "DBLSV-B", "width": 1920 },
            { "supplier": "B", "room_code": "DZMB", "width": 1024 }
          ]
        },
        {
          "image_id": "HM-1048213-R03-I002",
          "copies": [{ "supplier": "C", "room_code": "STD-DNZ", "width": 800 }]
        }
      ]
    },
    {
      "room_id": "HM-1048213-R07",
      "name": "Standard Family Room, Land View",
      "images": [
        {
          "image_id": "HM-1048213-R07-I001",
          "copies": [{ "supplier": "B", "room_code": "FZLS", "width": 1024 }]
        }
      ]
    }
  ]
}

Données d'exemple ; l'hôtel, les noms de chambres, les codes et les adresses d'images n'appartiennent à aucun établissement réel.

Comment ça marche

  1. 1

    Mapping des chambres

    Les codes de chambre des fournisseurs sont reliés, par le mapping des chambres, à des identifiants de chambre standard rattachés au HM ID de l'hôtel.

  2. 2

    Collecte

    Les photos qu'un fournisseur envoie sous un code de chambre sont rassemblées sous l'identifiant de chambre standard auquel ce code est relié.

  3. 3

    Détection des images en double

    Une empreinte basée sur le contenu est calculée pour chaque image ; les copies d'une même photo de chambre venant de fournisseurs différents sont regroupées en une seule image.

  4. 4

    Livraison

    Les images, les groupes de doublons et les codes de chambre des fournisseurs sont renvoyés dans la réponse de l'API avec les données de la chambre.

Que résolvent les images de chambres ?

Quand cinq offres de chambres sont listées sur une page d’hôtel, la plupart des systèmes affichent la même galerie générale à côté de chaque offre. En choisissant une chambre vue mer avec balcon, le client voit une photo de piscine ou de lobby ; pour comprendre à quoi ressemble la chambre familiale, il doit parcourir toute la galerie. Les fournisseurs envoient souvent les photos de chambres avec leurs propres codes de chambre, mais ces codes diffèrent d’un fournisseur à l’autre.

Les images de chambres relient ces photos aux types de chambres standard issus du mapping des chambres. Comme « Dbl Sea View Balcony », « DZ Meerblick Balkon » et « Standart Oda Deniz Manzaralı Balkonlu » sont rattachés au même identifiant de chambre, les photos des trois fournisseurs sont rassemblées dans la même chambre. Vous trouverez la façon dont les types de chambres sont standardisés dans le guide qu’est-ce que le mapping des chambres et le cadre général dans le guide du mapping hôtelier.

Images d’hôtels et images de chambres

Images d’hôtels Images de chambres
Rattachées à Le HM ID de l’hôtel L’identifiant de chambre standard (par ex. HM-1048213-R03)
Contenu Façade, lobby, piscine, plage, restaurant, spa, espaces communs Photos de ce type de chambre
Prérequis Mapping hôtelier Mapping hôtelier et mapping des chambres
Détection des doublons Au sein de la galerie de l’hôtel Au sein du type de chambre
Livraison Réponse de contenu hôtelier et dump Réponse de données de chambre

Pour la galerie générale de l’hôtel, consultez le service images d’hôtels. Quand les deux services sont utilisés ensemble, la page de l’hôtel affiche la galerie générale et chaque offre de chambre affiche ses propres photos.

Comment les doublons sont-ils éliminés ?

Plusieurs fournisseurs peuvent envoyer la même photo de chambre dans une taille ou une compression différente. Une empreinte basée sur le contenu est calculée pour chaque image, et les prises de vue identiques au sein d’un même type de chambre sont regroupées sous une seule image. La réponse indique, pour chaque image, le nombre de copies et le code de chambre du fournisseur dont elles proviennent.

Livraison

Les images fonctionnent sur les mêmes HM ID et identifiants de chambre que le contenu hôtelier et les données de mapping des chambres. Le point d’accès GET /v1/hotels/{hm_id}/rooms?include=images et les champs de réponse de l’exemple constituent un brouillon de l’API v1 ; le schéma définitif sera publié sur la page développeurs. Pour le périmètre et le prix, vous pouvez demander un devis.

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

Exemple d'API

Requête

Demande des chambres d'un hôtel avec leurs images
curl "https://api.hotelmapping.org/v1/hotels/HM-1048213/rooms?include=images" \
  -H "X-API-Key: $HM_API_KEY"

Réponse

200 OK
{
  "hm_id": "HM-1048213",
  "rooms": [
    {
      "room_id": "HM-1048213-R03",
      "name": "Standard Double Room, Sea View, Balcony",
      "view": "sea",
      "bed": "double",
      "max_occupancy": 3,
      "supplier_rooms": { "A": "DBLSV-B", "B": "DZMB", "C": "STD-DNZ" },
      "images": [
        {
          "image_id": "HM-1048213-R03-I001",
          "url": "https://img.supplier-a.example/88213/rooms/dblsv-1.jpg",
          "width": 1920,
          "copy_count": 2
        },
        {
          "image_id": "HM-1048213-R03-I002",
          "url": "https://media.supplier-c.example/551/IMG_3101.jpg",
          "width": 800,
          "copy_count": 1
        }
      ]
    }
  ]
}

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

Questions fréquentes

Le mapping des chambres est-il nécessaire pour les images de chambres ?

Oui. Les photos sont rattachées aux identifiants de chambre standard créés par le mapping des chambres. Tant que les types de chambres ne sont pas standardisés, les photos que différents fournisseurs envoient pour la même chambre ne peuvent pas être rassemblées.

Quelle est la différence entre images de chambres et images d'hôtels ?

Les images d'hôtels forment la galerie générale de l'hôtel : façade, lobby, piscine, plage, restaurant, spa et espaces communs. Les images de chambres sont des photos rattachées individuellement à chaque type de chambre standard. Ce sont deux services distincts.

Que se passe-t-il si un fournisseur n'envoie pas la photo d'une chambre avec un code de chambre ?

Une image de chambre est rattachée à un type de chambre selon le code de chambre avec lequel le fournisseur a envoyé la photo. Les photos reçues sans code de chambre ne sont rattachées à aucun type de chambre ; les photos reçues au niveau de l'hôtel sont traitées par le service images d'hôtels.

Les images de chambres apportent-elles aussi des données de prix ou de disponibilité ?

Non. Les images de chambres font partie des données statiques de chambre. Le prix et la disponibilité arrivent du fournisseur vers votre système ; nous indiquons seulement à quelle chambre appartient une offre et fournissons les images de cette chambre.

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