Soluciones de ficha de hotel

La ficha de hotel ofrece los datos básicos de un hotel en campos separados y filtrables en lugar de texto libre: tipo de establecimiento, estrellas, número de habitaciones, horarios de entrada y salida, playa y piscinas, política de niños y mascotas, restaurantes y datos de contacto. La información de todos los proveedores se reúne bajo el HM ID del hotel, los valores contradictorios se marcan; los datos se entregan por API y archivos dump.

Qué ganará

  • Listo para filtrar

    La hora de entrada, la política de niños, el tipo de playa y el número de habitaciones son campos independientes, por lo que se usan directamente en filtros y comparaciones.

  • Un hotel, una sola verdad

    La información de un hotel en todos los proveedores se reúne bajo un único HM ID. La página del hotel no cambia según el proveedor del que se llegue.

  • Contradicciones visibles

    Cuando los proveedores dan valores distintos para el mismo campo, el campo se marca. En la respuesta ve qué datos están pendientes de revisión.

  • Coherente con las descripciones

    Las descripciones de hoteles se generan a partir de los mismos datos de la ficha; el texto y los campos no se contradicen.

Antes y después

Datos brutos del establecimiento de dos proveedores

supplier_facts.txt
[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

Ficha de hotel estándar bajo un HM ID

Ficha de hotel HM-1048213
{
  "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"]
  }
}

Datos de ejemplo; el hotel y los códigos no pertenecen a un establecimiento real. Los campos en los que los proveedores se contradicen (aquí, la hora de entrada y el número de habitaciones) se marcan con review_flags.

Cómo funciona

  1. 1

    Reunión de las fuentes

    Se reúnen los datos de todos los registros de proveedores vinculados al mismo HM ID. Los datos brutos se conservan tal cual y los cambios se versionan.

  2. 2

    División en campos

    Los horarios, cifras, distancias y políticas del texto libre se convierten en campos separados; se normalizan los formatos de hora, distancia y edad.

  3. 3

    Control de contradicciones

    Cuando las fuentes dan información distinta, se comparan los valores. Los campos dudosos se marcan y pasan a la cola de revisión del equipo de datos.

  4. 4

    Entrega y actualización

    La ficha de hotel se devuelve desde el endpoint GET /v1/hotels/{hm_id}/content; todo el inventario llega en archivos dump completos y delta diarios.

¿Por qué la ficha de hotel usa campos separados?

Los proveedores suelen enviar los datos del hotel dentro de texto libre. Uno escribe la hora de entrada como 14:00 y otro como 15:00; uno dice 412 habitaciones y otro 410. La información de la playa se pierde dentro de una frase y el límite de edad de los niños llega en formatos distintos. Así no se puede montar un filtro de “hoteles con playa de arena privada” o “niños de 0 a 6 años gratis”.

La ficha de hotel extrae estos datos a campos separados y los vincula al HM ID del hotel. El requisito previo es mapear bien el hotel; puede consultar el método en la guía de mapeo hotelero y el producto en la página de mapeo hotelero.

Campos de la ficha de hotel

Grupo Campos Valor de ejemplo
Datos del establecimiento Tipo de establecimiento, estrellas, cadena y marca, número de habitaciones y plantas, año de apertura y de renovación Resort, 5 estrellas, 412 habitaciones
Políticas Horario de entrada y salida; política de niños, mascotas, tabaco y pago 14:00 / 12:00, gratis de 0 a 6,99 años
Playa y piscina Tipo de playa, si es del hotel, distancia; número de piscinas exteriores e interiores Arena, del hotel, 250 m; 3 exteriores, 1 interior
Restauración Restaurantes, bares, tipos de cocina, horarios de apertura Restaurante de cocina turca, bar en la piscina
Contacto y dirección Dirección verificada, teléfono, correo electrónico, sitio web [email protected]

Los nombres y valores de los campos son independientes del idioma; en su interfaz muestra la etiqueta en su propio idioma.

Información contradictoria

Cuando los proveedores dan valores distintos para el mismo hotel, se comparan los valores. Los campos que siguen siendo dudosos se marcan con review_flags y los revisa el equipo de datos. Así ve en la respuesta qué información es segura y cuál está pendiente de revisión.

Descripciones y entrega

Las descripciones de hoteles se generan a partir de los mismos datos de la ficha; un horario o una distancia que aparezcan en el texto no contradicen el valor del campo. La galería de fotos del hotel está en el servicio de imágenes de hoteles; si la ficha indica que el hotel tiene playa y no hay ninguna imagen etiquetada como playa, puede generar una alerta para el equipo de contenido.

La ficha de hotel se entrega por API REST hotel a hotel y, para todo el inventario, con archivos completos y dump delta diarios. El parámetro include y los nombres de campo del ejemplo son un borrador de la API v1; el esquema definitivo se publicará en la página para desarrolladores. Para conocer el alcance y el precio, puede solicitar un presupuesto.

¿Qué es el mapeo hotelero? Guía completa

Ejemplo de API

Solicitud

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

Respuesta

200 OK
{
  "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": "[email protected]" },
    "review_flags": ["check_in", "room_count"]
  },
  "updated_at": "2026-11-02T08:14:00Z"
}

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

Preguntas frecuentes

¿Qué es la ficha de hotel?

Es la presentación de los datos básicos de un hotel (tipo de establecimiento, estrellas, número de habitaciones, horarios de entrada y salida, políticas, restauración, contacto) en campos estructurados.

¿Cuál es la diferencia entre la ficha de hotel y la descripción del hotel?

La descripción es un texto escrito para leerse; la ficha de hotel son campos separados para filtrar y comparar. Ambas se basan en los mismos datos verificados.

¿Qué valor se usa si los proveedores dan información distinta?

Se comparan los valores; los campos que siguen siendo dudosos se marcan y los revisa el equipo de datos. En la respuesta, review_flags muestra qué campos están pendientes de revisión.

¿En qué formatos puedo recibir los datos de la ficha de hotel?

Por API REST hotel a hotel o, para todo el inventario, con archivos dump completos y delta diarios (CSV, JSON). Está previsto un webhook para notificar cambios.

Solicitar presupuesto

Reciba su presupuesto a medida

Envíe su solicitud en tres pasos; le enviaremos el presupuesto a su correo profesional. La solicitud no es vinculante.

  1. 1 Seleccione las soluciones
  2. 2 Seleccione los proveedores
  3. 3 Deje sus datos de contacto