Soluciones de ficha de hotel
Horario de entrada y salida, playa, piscina y política de niños: datos del hotel en campos separados vinculados al HM ID.
Las descripciones de hoteles ofrecen, para cada HM ID, un texto de presentación multilingüe y listo para vender. Cada hotel tiene tres versiones: corta, media y larga; los primeros idiomas son turco, inglés, alemán, ruso y árabe. Los textos se generan a partir de los datos de la ficha de hotel y de los textos de los proveedores, los revisan editores y se entregan por API y archivos dump.
{
"hm_id": "HM-1048213",
"lang": "tr",
"available_langs": ["tr", "en", "de", "ru", "ar"],
"descriptions": {
"short": "Belek'te, otele ait kum plaja 250 metre mesafede, üç açık havuzlu resort otel.",
"medium": "Sunset Bay Resort & Spa, Antalya'nın Belek bölgesinde, otele ait kum plaja 250 metre uzaklıktadır. 412 odalı tesiste üç açık ve bir kapalı havuz bulunur.",
"long": "Sunset Bay Resort & Spa, Belek'in sahil şeridinde yer alır. (Örnekte kısaltıldı.)"
}
} El texto corto encaja en la tarjeta de resultados de búsqueda, el medio en la parte superior de la página del hotel y el largo en la sección de detalle. No hace falta recortar el texto para cada pantalla.
Las descripciones en turco, inglés, alemán, ruso y árabe se basan en la misma información verificada. Al abrir un mercado nuevo, no tiene que encargar el contenido desde cero.
La IA genera el borrador y los editores lo revisan en cuanto a exactitud y estilo. Datos como horarios, cifras y políticas proceden de los campos de la ficha de hotel.
Cada descripción está vinculada a un HM ID. Aunque cambie de proveedor o añada uno nuevo, el texto permanece en el mismo hotel.
Textos del mismo hotel de tres proveedores
[A / HTL-88213] lang=en
Nice hotel near the beach. Great pools!! Check-in 14:00.
Great pools and great food. Close to the beach.
[B / 40917] lang=tr
Belek'te 5 yıldızlı otel.
[C / TR-ANT-551] lang=de
(açıklama yok) Descripción en tres longitudes bajo un HM ID
{
"hm_id": "HM-1048213",
"lang": "tr",
"available_langs": ["tr", "en", "de", "ru", "ar"],
"descriptions": {
"short": "Belek'te, otele ait kum plaja 250 metre mesafede, üç açık havuzlu resort otel.",
"medium": "Sunset Bay Resort & Spa, Antalya'nın Belek bölgesinde, otele ait kum plaja 250 metre uzaklıktadır. 412 odalı tesiste üç açık ve bir kapalı havuz bulunur.",
"long": "Sunset Bay Resort & Spa, Belek'in sahil şeridinde yer alır. (Örnekte kısaltıldı.)"
}
} Datos de ejemplo; el hotel y los códigos no pertenecen a un establecimiento real. Se descartan las expresiones repetidas y exageradas; las distancias y cifras del texto proceden de los campos de la ficha de hotel.
Gracias al mapeo hotelero, se reúnen bajo un único HM ID todos los textos de proveedores y los datos de la ficha del hotel.
La IA genera una descripción corta, media y larga a partir de los datos de la ficha de hotel y de los textos de los proveedores; se descartan las expresiones repetidas y contradictorias.
Los editores revisan el texto en cuanto a exactitud y estilo. Todos los idiomas se basan en la misma información.
Cuando cambia la información del establecimiento, la descripción también se actualiza; el texto no llega a contradecir la ficha de hotel.
Las descripciones se devuelven desde el endpoint GET /v1/hotels/{hm_id}/content con el parámetro de idioma; todo el inventario llega en archivos dump completos y delta diarios.
El mapeo reúne el mismo hotel bajo un único HM ID, pero el texto de presentación sigue siendo tan distinto como número de proveedores haya. Uno envía solo inglés con frases repetidas, otro una nota de una línea en turco y un tercero no envía texto alguno. La página del hotel cambia según el contenido de qué proveedor se use; y si quiere abrirse a un mercado de habla alemana o rusa, tiene que encargar el texto desde cero.
Las descripciones de hoteles cierran esa brecha a nivel de HM ID: un único texto coherente y listo para vender para cada 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.
| Versión | Formato | ¿Dónde se usa? |
|---|---|---|
| Corta | Una frase | Tarjeta de resultados de búsqueda, tarjeta del mapa |
| Media | Un párrafo | Parte superior de la página del hotel |
| Larga | Varios párrafos | Pestaña de detalle: ubicación, habitaciones, restauración, servicios |
Cada versión se basa en la misma información. El texto corto no es una versión recortada del largo; se redacta aparte para su propio espacio.
La descripción se basa en información verificada, recopilada de todos los registros de proveedores del hotel. Datos como horarios, cifras, distancias y políticas proceden de los campos de la ficha de hotel. Así, un horario de entrada o una distancia a la playa que aparezcan en el texto no contradicen el valor de la ficha.
La IA genera el borrador; se descartan las expresiones repetidas, exageradas o contradictorias. A continuación, los editores revisan el texto en cuanto a exactitud y estilo. Cuando cambia la información del establecimiento, la descripción también se actualiza.
La primera versión ofrece descripciones en turco, inglés, alemán, ruso y árabe. Como todos los idiomas se generan a partir de la misma información, la página en un idioma y la de otro describen el mismo hotel.
Las descripciones se entregan por API REST hotel a hotel y, para todo el inventario, con archivos completos y dump delta diarios. Los parámetros include y lang del ejemplo son un borrador de la API v1; el esquema definitivo se publicará en la página para desarrolladores.
La información estructurada necesaria para filtrar y comparar está en el producto de ficha de hotel. La galería de fotos del hotel se depura de duplicados y se etiqueta por categoría en el servicio de imágenes de hoteles. Para conocer el alcance y el precio, puede solicitar un presupuesto.
Solicitud
curl "https://api.hotelmapping.org/v1/hotels/HM-1048213/content?include=descriptions&lang=en" \
-H "X-API-Key: $HM_API_KEY" Respuesta
{
"hm_id": "HM-1048213",
"lang": "en",
"available_langs": ["tr", "en", "de", "ru", "ar"],
"descriptions": {
"short": "Resort hotel in Belek, 250 m from its private sandy beach, with three outdoor pools.",
"medium": "Sunset Bay Resort & Spa is in Belek, Antalya, 250 metres from the hotel's private sandy beach. The 412-room property has three outdoor pools and one indoor pool.",
"long": "Sunset Bay Resort & Spa sits on the Belek coastline. (Shortened in this example.)"
},
"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.
Los primeros idiomas son turco, inglés, alemán, ruso y árabe. Todos se basan en la misma información verificada. El calendario de nuevos idiomas aún no está definido.
El texto lo genera la IA y los editores lo revisan en cuanto a exactitud y estilo. Datos como horarios, cifras y políticas proceden de los datos estructurados de la ficha de hotel.
La descripción es un texto escrito para leerse. La ficha de hotel ofrece, en campos separados, datos como el horario de entrada y salida, la playa, las piscinas y la política de niños, para filtrar y comparar. Ambas se basan en los mismos datos.
Por API REST hotel a hotel y, para todo el inventario, con archivos dump completos y delta diarios. Está previsto un webhook para notificar cambios.
Las condiciones de uso y licencia del contenido se establecen en el contrato.
Solicitar presupuesto
Envíe su solicitud en tres pasos; le enviaremos el presupuesto a su correo profesional. La solicitud no es vinculante.