# Soluciones de imágenes de habitaciones

> URL: https://hotelmapping.org/es/productos/soluciones-imagenes-habitaciones/ · Idioma: Español

Imágenes de habitaciones vincula las fotos que los proveedores envían para cada habitación a los tipos de habitación estándar que genera el mapeo de habitaciones (p. ej., HM-1048213-R03). Así, cada oferta de habitación se muestra con las fotos propias de esa habitación en lugar de la galería general del hotel. La misma foto que llega de distintos proveedores se agrupa en una sola imagen, y las imágenes se devuelven desde la API junto con los datos de la habitación.

## Qué ganará

- **La habitación correcta, la foto correcta:** La oferta de una habitación con vistas al mar y balcón se muestra con las fotos de esa habitación; el huésped no tiene que buscar su habitación en la galería general del hotel.
- **Los proveedores se unen en un solo tipo de habitación:** Las fotos que tres proveedores envían para la misma habitación se reúnen bajo el único identificador de habitación que crea el mapeo de habitaciones.
- **Duplicados en una sola imagen:** Las copias de la misma foto de habitación que llegan de distintos proveedores y con distintos tamaños se agrupan bajo una sola imagen.
- **Junto con los datos de la habitación:** Las imágenes llegan en la misma respuesta que el tipo de habitación, la vista, la cama y la capacidad; no hace falta un paso de emparejamiento aparte.

## Antes y después

Fotos de habitaciones de tres proveedores

**supplier_room_images.csv**

```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
```

Imágenes vinculadas a tipos de habitación estándar

**Imágenes de habitaciones HM-1048213**

```json
{
  "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 }]
        }
      ]
    }
  ]
}
```

_Datos de ejemplo; el hotel, los nombres de habitación, los códigos y las direcciones de las imágenes no pertenecen a ningún establecimiento real._

## Cómo funciona

1. **Mapeo de habitaciones:** Los códigos de habitación de los proveedores se vinculan, mediante el mapeo de habitaciones, a identificadores de habitación estándar ligados al HM ID del hotel.
2. **Recopilación:** Las fotos que un proveedor envía con un código de habitación se reúnen bajo el identificador de habitación estándar al que está vinculado ese código.
3. **Detección de imágenes duplicadas:** Se calcula una huella basada en el contenido de cada imagen; las copias de la misma foto de habitación que llegan de distintos proveedores se agrupan en una sola imagen.
4. **Entrega:** Las imágenes, los grupos de duplicados y los códigos de habitación de los proveedores se devuelven en la respuesta de la API junto con los datos de la habitación.

## Ejemplo de API

**Solicitud de las habitaciones de un hotel con sus imágenes**

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

**200 OK**

```json
{
  "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
        }
      ]
    }
  ]
}
```

_Los ejemplos de código son ilustrativos; los nombres de los campos pueden cambiar en la versión v1._

## ¿Qué resuelven las imágenes de habitaciones?

Cuando una página de hotel lista cinco ofertas de habitación, la mayoría de los sistemas muestra la misma galería general junto a cada oferta. Al elegir una habitación con vistas al mar y balcón, el huésped ve una foto de la piscina o del lobby; para saber cómo es la habitación familiar, tiene que recorrer toda la galería. Los proveedores suelen enviar las fotos de habitaciones con sus propios códigos de habitación, pero esos códigos son distintos en cada proveedor.

Imágenes de habitaciones vincula estas fotos a los tipos de habitación estándar que genera el [mapeo de habitaciones](https://hotelmapping.org/es/productos/soluciones-mapeo-habitaciones/). Como «Dbl Sea View Balcony», «DZ Meerblick Balkon» y «Standart Oda Deniz Manzaralı Balkonlu» están vinculados al mismo identificador de habitación, las fotos de los tres proveedores se reúnen en la misma habitación. Cómo se estandarizan los tipos de habitación se explica en la guía [qué es el mapeo de habitaciones](https://hotelmapping.org/es/guia/que-es-mapeo-de-habitaciones/), y el marco general, en la [guía de mapeo hotelero](https://hotelmapping.org/es/guia/que-es-mapeo-hotelero/).

## Imágenes de hoteles e imágenes de habitaciones

| | Imágenes de hoteles | Imágenes de habitaciones |
| --- | --- | --- |
| Se vinculan a | El HM ID del hotel | El identificador de habitación estándar (p. ej., HM-1048213-R03) |
| Qué contienen | Fachada, lobby, piscina, playa, restaurante, spa, zonas comunes | Fotos de ese tipo de habitación |
| Requisito previo | [Mapeo hotelero](https://hotelmapping.org/es/productos/soluciones-mapeo-hotelero/) | Mapeo hotelero y mapeo de habitaciones |
| Detección de duplicados | Dentro de la galería del hotel | Dentro del tipo de habitación |
| Entrega | Respuesta de contenido hotelero y dump | Respuesta de datos de habitación |

Para la galería general del hotel, consulte el servicio de [imágenes de hoteles](https://hotelmapping.org/es/productos/soluciones-imagenes-hoteles/). Cuando se usan los dos servicios juntos, la página del hotel muestra la galería general y cada oferta de habitación muestra sus propias fotos.

## ¿Cómo se eliminan los duplicados?

Varios proveedores pueden enviar la misma foto de habitación con distinto tamaño o compresión. Se calcula una huella basada en el contenido de cada imagen y las tomas idénticas dentro del mismo tipo de habitación se agrupan bajo una sola imagen. La respuesta incluye, para cada imagen, el número de copias y el código de habitación del proveedor del que proceden.

## Entrega

Las imágenes funcionan sobre el mismo HM ID y los mismos identificadores de habitación que el [contenido hotelero](https://hotelmapping.org/es/productos/soluciones-descripciones-hoteles/) y los datos del mapeo de habitaciones. El endpoint `GET /v1/hotels/{hm_id}/rooms?include=images` y los campos de respuesta del ejemplo son un borrador de la API v1; el esquema definitivo se publicará en la [página para desarrolladores](https://hotelmapping.org/es/desarrolladores/). Para el alcance y el precio, puede [solicitar presupuesto](https://hotelmapping.org/es/solicitar-presupuesto/).

## Preguntas frecuentes

### ¿Es necesario el mapeo de habitaciones para las imágenes de habitaciones?

Sí. Las fotos se vinculan a los identificadores de habitación estándar que crea el mapeo de habitaciones. Mientras los tipos de habitación no estén estandarizados, no se pueden reunir las fotos que distintos proveedores envían para la misma habitación.

### ¿Cuál es la diferencia entre imágenes de habitaciones e imágenes de hoteles?

Las imágenes de hoteles son la galería general del hotel: fachada, lobby, piscina, playa, restaurante, spa y zonas comunes. Las imágenes de habitaciones son fotos vinculadas individualmente a cada tipo de habitación estándar. Son dos servicios distintos.

### ¿Qué ocurre si un proveedor no envía la foto de la habitación con un código de habitación?

Una imagen de habitación se vincula a un tipo de habitación según el código de habitación con el que el proveedor envió la foto. Las fotos que llegan sin código de habitación no se vinculan a ningún tipo de habitación; las fotos que llegan a nivel de hotel las procesa el servicio de imágenes de hoteles.

### ¿Las imágenes de habitaciones traen también datos de precio o disponibilidad?

No. Las imágenes de habitaciones forman parte de los datos estáticos de habitación. El precio y la disponibilidad llegan del proveedor a su sistema; nosotros solo indicamos a qué habitación pertenece una oferta y entregamos las imágenes de esa habitación.

## Productos relacionados

- [Soluciones de mapeo de habitaciones](https://hotelmapping.org/es/productos/soluciones-mapeo-habitaciones/)
- [Soluciones de imágenes de hoteles](https://hotelmapping.org/es/productos/soluciones-imagenes-hoteles/)
- [Soluciones de descripciones de hoteles](https://hotelmapping.org/es/productos/soluciones-descripciones-hoteles/)

## Artículos relacionados

- [¿Qué es el mapeo de habitaciones? ¿Por qué los nombres de habitación son tan confusos?](https://hotelmapping.org/es/guia/que-es-mapeo-de-habitaciones/)
- [Glosario de abreviaturas de tipos de habitación: SGL, DBL, TWN, TRP, SV, LV, FAM](https://hotelmapping.org/es/guia/abreviaturas-tipos-de-habitacion/)
- [¿Qué es el mapeo hotelero (hotel mapping) y cómo funciona? Guía completa](https://hotelmapping.org/es/guia/que-es-mapeo-hotelero/)
