حلول أوصاف الفنادق

تقدّم أوصاف الفنادق لكل HM ID نصًا تعريفيًا متعدد اللغات وجاهزًا للبيع. لكل فندق ثلاث نسخ: قصيرة ومتوسطة وطويلة؛ واللغات الأولى هي التركية والإنجليزية والألمانية والروسية والعربية. تُنتَج النصوص من بيانات بطاقة بيانات الفندق (factsheet) ونصوص المورّدين، وتمر بمراجعة المحررين، وتُسلَّم عبر API وملفات dump.

ما الذي تكسبه

  • نص بثلاثة أطوال

    النص القصير يناسب بطاقة نتائج البحث، والمتوسط أعلى صفحة الفندق، والطويل قسم التفاصيل. لا تحتاج إلى اقتطاع النص لكل شاشة على حدة.

  • المعلومات نفسها بخمس لغات

    الأوصاف بالتركية والإنجليزية والألمانية والروسية والعربية مبنية على المعلومات الموثّقة نفسها. عند دخول سوق جديدة لا تحتاج إلى كتابة المحتوى من الصفر.

  • ذكاء اصطناعي ومحرر

    يُنتج الذكاء الاصطناعي المسودة، ويراجع المحررون الدقة والأسلوب. أما المواعيد والأرقام والسياسات فتأتي من حقول بطاقة البيانات (factsheet).

  • مرتبط بالفندق المطابَق

    كل وصف مرتبط بـ HM ID واحد. وحتى لو غيّرت المورّد أو أضفت مورّدًا جديدًا يبقى النص عند الفندق نفسه.

قبل وبعد

نص الفندق القادم من ثلاثة مورّدين

supplier_descriptions.txt
[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)

وصف بثلاثة أطوال تحت HM ID

أوصاف الفندق HM-1048213 (tr)
{
  "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ı.)"
  }
}

هذه بيانات مثال؛ الفندق والرموز لا تخص منشأة حقيقية. تُحذف العبارات المتكررة والمبالغ فيها؛ وتأتي المسافات والأرقام في النص من حقول بطاقة البيانات (factsheet).

كيف يعمل

  1. 1

    البدء بالفندق الصحيح

    تُجمع كل نصوص المورّدين وبيانات بطاقة البيانات (factsheet) للفندق الذي اجتمع في HM ID واحد عبر مطابقة الفنادق.

  2. 2

    إنتاج المسودة

    ينتج الذكاء الاصطناعي وصفًا قصيرًا ومتوسطًا وطويلًا من بيانات بطاقة البيانات ونصوص المورّدين؛ وتُحذف العبارات المتكررة والمتعارضة.

  3. 3

    مراجعة المحرر

    يراجع المحررون النص من حيث الدقة والأسلوب. وتعتمد جميع اللغات على المعلومات نفسها.

  4. 4

    التحديث

    عند تغيّر معلومات المنشأة يُحدَّث الوصف أيضًا؛ فلا يتعارض النص مع بطاقة البيانات.

  5. 5

    التسليم

    تعود الأوصاف من نقطة النهاية GET /v1/hotels/{hm_id}/content بحسب معامل اللغة؛ ويصل المخزون كاملًا في ملفات dump اليومية الكاملة وdelta.

ما المشكلة التي تحلها أوصاف الفنادق؟

تجمع المطابقة الفندق نفسه في HM ID واحد، لكن النص التعريفي يبقى مختلفًا بعدد المورّدين. مورّد يرسل نصًا بالإنجليزية فقط بجمل مكررة، وآخر ملاحظة تركية من سطر واحد، وثالث لا يرسل أي نص. وتتغير صفحة الفندق بحسب المورّد المستخدَم؛ وعند دخول سوق ناطقة بالألمانية أو الروسية تضطر إلى كتابة النص من جديد.

تسدّ أوصاف الفنادق هذه الفجوة على مستوى HM ID: نص واحد متسق وجاهز للبيع لكل فندق. وشرط ذلك مطابقة الفندق بشكل صحيح؛ ستجد الطريقة في دليل مطابقة الفنادق، والمنتج في صفحة مطابقة الفنادق.

ثلاثة أطوال وثلاثة استخدامات

النسخة الصيغة أين تُستخدم؟
قصيرة جملة واحدة بطاقة نتائج البحث، بطاقة الخريطة
متوسطة فقرة واحدة أعلى صفحة الفندق
طويلة عدة فقرات تبويب التفاصيل: الموقع والغرف والطعام والمرافق

تعتمد كل نسخة على المعلومات نفسها. والنسخة القصيرة ليست اقتطاعًا من الطويلة؛ بل تُكتب على حدة لمكانها.

كيف تُعدّ النصوص؟

يعتمد الوصف على معلومات موثّقة تُجمع من جميع سجلات الفندق لدى المورّدين. وتأتي المواعيد والأرقام والمسافات والسياسات من حقول بطاقة بيانات الفندق. وهكذا لا يتعارض موعد الدخول أو مسافة الشاطئ الواردان في النص مع القيمة في بطاقة البيانات.

يُنتج الذكاء الاصطناعي المسودة؛ وتُحذف العبارات المتكررة والمبالغ فيها والمتعارضة. ثم يراجع المحررون النص من حيث الدقة والأسلوب. وعند تغيّر معلومات المنشأة يُحدَّث الوصف أيضًا.

اللغات والتسليم

تتوفر في الإصدار الأول أوصاف بالتركية والإنجليزية والألمانية والروسية والعربية. ولأن جميع اللغات تُنتَج من المعلومات نفسها، فإن الصفحة بأي لغة تصف الفندق نفسه.

تُسلَّم الأوصاف على مستوى الفندق عبر REST API، وللمخزون كاملًا عبر ملفات dump اليومية الكاملة وdelta dump. والمعاملان include وlang في المثال مسودة API v1؛ ويُنشر المخطط النهائي في صفحة المطورين.

المنتجات ذات الصلة

المعلومات المنظّمة اللازمة للتصفية والمقارنة موجودة في منتج بطاقة بيانات الفندق. أما معرض صور الفندق فتُزال تكراراته ويُوسَم بالفئات في خدمة صور الفنادق. ولمعرفة النطاق والسعر يمكنك طلب عرض سعر.

ما هي مطابقة الفنادق؟ الدليل الشامل

مثال API

الطلب

طلب الأوصاف بالإنجليزية
curl "https://api.hotelmapping.org/v1/hotels/HM-1048213/content?include=descriptions&lang=en" \
  -H "X-API-Key: $HM_API_KEY"

الاستجابة

200 OK
{
  "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"
}

أمثلة الشيفرة توضيحية؛ وقد تتغير أسماء الحقول عند إصدار v1.

الأسئلة الشائعة

بأي لغات تتوفر أوصاف الفنادق؟

اللغات الأولى هي التركية والإنجليزية والألمانية والروسية والعربية. وتعتمد جميعها على المعلومات الموثّقة نفسها. لم يُحدَّد بعد جدول اللغات الجديدة.

من يكتب الأوصاف؟

ينتج الذكاء الاصطناعي النص ويراجع المحررون دقته وأسلوبه. أما المواعيد والأرقام والسياسات فتأتي من بيانات بطاقة البيانات (factsheet) المنظّمة.

ما الفرق بين الوصف وبطاقة البيانات (factsheet)؟

الوصف نص مكتوب للقراءة. أما بطاقة البيانات فتقدّم معلومات مثل موعد الدخول والخروج والشاطئ والمسبح وسياسة الأطفال في حقول منفصلة للتصفية والمقارنة. وكلاهما يعتمد على البيانات نفسها.

كيف تُسلَّم الأوصاف؟

على مستوى الفندق عبر REST API، وللمخزون كاملًا عبر ملفات dump اليومية الكاملة وdelta. ويُخطَّط لـ webhook للإشعار بالتغييرات.

هل يمكنني نشر الأوصاف على موقعي وتطبيقي؟

تُحدَّد شروط استخدام المحتوى وترخيصه في العقد.

اطلب عرض سعر

احصل على عرض سعر مخصص

أرسل طلبك في ثلاث خطوات، ونرسل العرض إلى بريدك الإلكتروني للعمل. الطلب غير ملزم.

  1. 1 اختر الحلول
  2. 2 اختر الموردين
  3. 3 اترك بيانات الاتصال