# Solutions de fiche hôtel

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

La fiche hôtel fournit les informations de base d'un hôtel dans des champs séparés et filtrables plutôt qu'en texte libre : type d'établissement, étoiles, nombre de chambres, horaires d'arrivée et de départ, plage et piscines, politique enfants et animaux, restaurants et coordonnées. Les informations de tous les fournisseurs sont regroupées sous le HM ID de l'hôtel, les valeurs contradictoires sont signalées ; les données sont livrées par API et fichiers dump.

## Ce que vous y gagnez

- **Prêt pour le filtrage:** L'heure d'arrivée, la politique enfants, le type de plage et le nombre de chambres sont des champs distincts : ils s'utilisent directement dans les filtres et les comparaisons.
- **Un hôtel, une seule vérité:** Les informations d'un hôtel chez tous les fournisseurs sont réunies sous un seul HM ID. La page de l'hôtel ne change pas selon le fournisseur d'origine.
- **Contradictions visibles:** Quand les fournisseurs donnent des valeurs différentes pour un même champ, ce champ est signalé. Vous voyez dans la réponse quelle information attend une vérification.
- **Cohérent avec les descriptions:** Les descriptions d'hôtels sont produites à partir des mêmes données de fiche hôtel ; le texte et les champs ne se contredisent pas.

## Avant et après

Informations brutes de l'établissement venant de deux fournisseurs

**supplier_facts.txt**

```text
[A / HTL-88213]
Check-in 14:00 / Check-out 12:00. 412 rooms. Private sandy
beach 250m. 3 outdoor pools, 1 indoor pool. Kids 0-6.99 free.
Pets not allowed.

[B / 40917]
Giriş: 15.00, Çıkış: 12.00 - 410 oda - Otele ait kum plaj
(250 mt) - Açık havuz x3 - Çocuk 0-7 yaş arası ücretsiz
```

Fiche hôtel standard sous un HM ID

**Fiche hôtel HM-1048213**

```json
{
  "hm_id": "HM-1048213",
  "factsheet": {
    "check_in": "14:00",
    "check_out": "12:00",
    "room_count": 412,
    "beach": { "type": "sand", "private": true, "distance_m": 250 },
    "pools": { "outdoor": 3, "indoor": 1 },
    "child_policy": { "free_from_age": 0, "free_to_age": 6.99 },
    "pets_allowed": false,
    "review_flags": ["check_in", "room_count"]
  }
}
```

_Données d'exemple ; l'hôtel et les codes ne correspondent à aucun établissement réel. Les champs sur lesquels les fournisseurs se contredisent (ici l'heure d'arrivée et le nombre de chambres) sont signalés par review_flags._

## Comment ça marche

1. **Regroupement des sources:** Les informations de tous les enregistrements fournisseurs rattachés au même HM ID sont rassemblées. Les données brutes sont conservées telles quelles, les modifications sont versionnées.
2. **Découpage en champs:** Les horaires, nombres, distances et politiques du texte libre sont convertis en champs séparés ; les formats d'heure, de distance et d'âge sont normalisés.
3. **Contrôle des contradictions:** Lorsque les sources donnent des informations différentes, les valeurs sont comparées. Les champs incertains sont signalés et placés dans la file de vérification de l'équipe données.
4. **Livraison et mise à jour:** La fiche hôtel est renvoyée par le endpoint GET /v1/hotels/{hm_id}/content ; tout l'inventaire est fourni dans des fichiers dump complets et delta quotidiens.

## Exemple d'API

**Requête de fiche hôtel**

```bash
curl "https://api.hotelmapping.org/v1/hotels/HM-1048213/content?include=factsheet" \
  -H "X-API-Key: $HM_API_KEY"
```

**200 OK**

```json
{
  "hm_id": "HM-1048213",
  "factsheet": {
    "property": { "type": "resort", "stars": 5, "room_count": 412 },
    "policies": {
      "check_in": "14:00",
      "check_out": "12:00",
      "child_policy": { "free_from_age": 0, "free_to_age": 6.99 },
      "pets_allowed": false
    },
    "beach": { "type": "sand", "private": true, "distance_m": 250 },
    "pools": { "outdoor": 3, "indoor": 1 },
    "dining": [
      { "type": "restaurant", "cuisine": "turkish" },
      { "type": "bar", "location": "pool" }
    ],
    "contact": { "email": "info@sunsetbay.example" },
    "review_flags": ["check_in", "room_count"]
  },
  "updated_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 la fiche hôtel utilise-t-elle des champs séparés ?

Les fournisseurs envoient souvent les informations de l'hôtel dans du texte libre. L'un écrit l'heure d'arrivée 14:00, l'autre 15:00 ; l'un annonce 412 chambres, l'autre 410. L'information sur la plage se perd au milieu d'une phrase, la limite d'âge des enfants arrive sous des formats différents. En l'état, on ne peut pas construire un filtre « hôtels avec plage privée de sable » ou « enfants de 0 à 6 ans gratuits ».

La fiche hôtel extrait ces informations dans des champs séparés et les rattache au [HM ID](https://hotelmapping.org/fr/glossaire/hm-id/) de l'hôtel. La condition préalable est de mapper correctement l'hôtel ; vous trouverez la méthode dans le [guide du mapping hôtelier](https://hotelmapping.org/fr/guide/qu-est-ce-que-le-mapping-hotelier/) et le produit sur la page [mapping hôtelier](https://hotelmapping.org/fr/produits/solutions-mapping-hotelier/).

## Champs de la fiche hôtel

| Groupe | Champs | Exemple de valeur |
| --- | --- | --- |
| Informations sur l'établissement | Type d'établissement, étoiles, chaîne et marque, nombre de chambres et d'étages, année d'ouverture et de rénovation | Resort, 5 étoiles, 412 chambres |
| Politiques | Heures d'arrivée et de départ ; politique enfants, animaux, fumeurs et paiement | 14:00 / 12:00, gratuit de 0 à 6,99 ans |
| Plage et piscine | Type de plage, appartenant ou non à l'hôtel, distance ; nombre de piscines extérieures et intérieures | Sable, privée, 250 m ; 3 extérieures, 1 intérieure |
| Restauration | Restaurants, bars, types de cuisine, horaires d'ouverture | Restaurant de cuisine turque, bar de piscine |
| Contact et adresse | Adresse vérifiée, téléphone, e-mail, site web | info@sunsetbay.example |

Les noms de champs et les valeurs sont indépendants de la langue ; dans votre interface, vous affichez le libellé dans votre langue.

## Informations contradictoires

Lorsque les fournisseurs donnent des valeurs différentes pour un même hôtel, les valeurs sont comparées. Les champs qui restent incertains sont signalés par `review_flags` et vérifiés par l'équipe données. Vous voyez ainsi dans la réponse quelle information est certaine et laquelle attend une vérification.

## Descriptions et livraison

Les [descriptions d'hôtels](https://hotelmapping.org/fr/produits/solutions-descriptions-hotels/) sont produites à partir des mêmes données de fiche hôtel ; un horaire ou une distance cités dans le texte ne contredisent pas la valeur du champ. La galerie photo de l'hôtel se trouve, elle, dans le service [images d'hôtels](https://hotelmapping.org/fr/produits/solutions-images-hotels/) ; si la fiche hôtel indique une plage mais qu'aucune image n'est étiquetée plage, vous pouvez générer une alerte pour l'équipe contenu.

La fiche hôtel est livrée par API REST hôtel par hôtel, et pour tout l'inventaire par des fichiers [dump delta](https://hotelmapping.org/fr/glossaire/delta-dump/) et complets quotidiens. Le paramètre `include` et les noms de champs de l'exemple sont un brouillon de l'API v1 ; le schéma définitif sera publié sur la [page développeurs](https://hotelmapping.org/fr/developpeurs/). Pour le périmètre et le tarif, vous pouvez [demander un devis](https://hotelmapping.org/fr/demander-un-devis/).

## Questions fréquentes

### Qu'est-ce que la fiche hôtel ?

C'est la présentation des informations de base d'un hôtel (type d'établissement, étoiles, nombre de chambres, horaires d'arrivée et de départ, politiques, restauration, coordonnées) sous forme de champs structurés.

### Quelle différence entre la fiche hôtel et la description de l'hôtel ?

La description est un texte écrit pour être lu ; la fiche hôtel est un ensemble de champs séparés pour le filtrage et la comparaison. Toutes deux reposent sur les mêmes données vérifiées.

### Quelle valeur est retenue si les fournisseurs donnent des informations différentes ?

Les valeurs sont comparées ; les champs qui restent incertains sont signalés et vérifiés par l'équipe données. La réponse indique avec review_flags quels champs attendent une vérification.

### Sous quels formats puis-je recevoir les données de la fiche hôtel ?

Par API REST hôtel par hôtel, ou par fichiers dump complets et delta quotidiens pour tout l'inventaire (CSV, JSON). Un webhook de notification des changements est prévu.

## Produits associés

- [Solutions de descriptions d'hôtels](https://hotelmapping.org/fr/produits/solutions-descriptions-hotels/)
- [Solutions de mapping hôtelier](https://hotelmapping.org/fr/produits/solutions-mapping-hotelier/)
- [Solutions d'images d'hôtels](https://hotelmapping.org/fr/produits/solutions-images-hotels/)

## Articles associés

- [Qu'est-ce que l'intégration XML hôtelière ? Données statiques et dynamiques](https://hotelmapping.org/fr/guide/qu-est-ce-que-l-integration-xml-hoteliere/)
- [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/)
