حلول بطاقة بيانات الفندق
معلومات الفندق مثل الدخول والخروج والشاطئ والمسبح وسياسة الأطفال في حقول منفصلة مرتبطة بـ HM ID.
تقدّم أوصاف الفنادق لكل HM ID نصًا تعريفيًا متعدد اللغات وجاهزًا للبيع. لكل فندق ثلاث نسخ: قصيرة ومتوسطة وطويلة؛ واللغات الأولى هي التركية والإنجليزية والألمانية والروسية والعربية. تُنتَج النصوص من بيانات بطاقة بيانات الفندق (factsheet) ونصوص المورّدين، وتمر بمراجعة المحررين، وتُسلَّم عبر API وملفات 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ı.)"
}
} النص القصير يناسب بطاقة نتائج البحث، والمتوسط أعلى صفحة الفندق، والطويل قسم التفاصيل. لا تحتاج إلى اقتطاع النص لكل شاشة على حدة.
الأوصاف بالتركية والإنجليزية والألمانية والروسية والعربية مبنية على المعلومات الموثّقة نفسها. عند دخول سوق جديدة لا تحتاج إلى كتابة المحتوى من الصفر.
يُنتج الذكاء الاصطناعي المسودة، ويراجع المحررون الدقة والأسلوب. أما المواعيد والأرقام والسياسات فتأتي من حقول بطاقة البيانات (factsheet).
كل وصف مرتبط بـ HM ID واحد. وحتى لو غيّرت المورّد أو أضفت مورّدًا جديدًا يبقى النص عند الفندق نفسه.
نص الفندق القادم من ثلاثة مورّدين
[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_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).
تُجمع كل نصوص المورّدين وبيانات بطاقة البيانات (factsheet) للفندق الذي اجتمع في HM ID واحد عبر مطابقة الفنادق.
ينتج الذكاء الاصطناعي وصفًا قصيرًا ومتوسطًا وطويلًا من بيانات بطاقة البيانات ونصوص المورّدين؛ وتُحذف العبارات المتكررة والمتعارضة.
يراجع المحررون النص من حيث الدقة والأسلوب. وتعتمد جميع اللغات على المعلومات نفسها.
عند تغيّر معلومات المنشأة يُحدَّث الوصف أيضًا؛ فلا يتعارض النص مع بطاقة البيانات.
تعود الأوصاف من نقطة النهاية GET /v1/hotels/{hm_id}/content بحسب معامل اللغة؛ ويصل المخزون كاملًا في ملفات dump اليومية الكاملة وdelta.
تجمع المطابقة الفندق نفسه في HM ID واحد، لكن النص التعريفي يبقى مختلفًا بعدد المورّدين. مورّد يرسل نصًا بالإنجليزية فقط بجمل مكررة، وآخر ملاحظة تركية من سطر واحد، وثالث لا يرسل أي نص. وتتغير صفحة الفندق بحسب المورّد المستخدَم؛ وعند دخول سوق ناطقة بالألمانية أو الروسية تضطر إلى كتابة النص من جديد.
تسدّ أوصاف الفنادق هذه الفجوة على مستوى HM ID: نص واحد متسق وجاهز للبيع لكل فندق. وشرط ذلك مطابقة الفندق بشكل صحيح؛ ستجد الطريقة في دليل مطابقة الفنادق، والمنتج في صفحة مطابقة الفنادق.
| النسخة | الصيغة | أين تُستخدم؟ |
|---|---|---|
| قصيرة | جملة واحدة | بطاقة نتائج البحث، بطاقة الخريطة |
| متوسطة | فقرة واحدة | أعلى صفحة الفندق |
| طويلة | عدة فقرات | تبويب التفاصيل: الموقع والغرف والطعام والمرافق |
تعتمد كل نسخة على المعلومات نفسها. والنسخة القصيرة ليست اقتطاعًا من الطويلة؛ بل تُكتب على حدة لمكانها.
يعتمد الوصف على معلومات موثّقة تُجمع من جميع سجلات الفندق لدى المورّدين. وتأتي المواعيد والأرقام والمسافات والسياسات من حقول بطاقة بيانات الفندق. وهكذا لا يتعارض موعد الدخول أو مسافة الشاطئ الواردان في النص مع القيمة في بطاقة البيانات.
يُنتج الذكاء الاصطناعي المسودة؛ وتُحذف العبارات المتكررة والمبالغ فيها والمتعارضة. ثم يراجع المحررون النص من حيث الدقة والأسلوب. وعند تغيّر معلومات المنشأة يُحدَّث الوصف أيضًا.
تتوفر في الإصدار الأول أوصاف بالتركية والإنجليزية والألمانية والروسية والعربية. ولأن جميع اللغات تُنتَج من المعلومات نفسها، فإن الصفحة بأي لغة تصف الفندق نفسه.
تُسلَّم الأوصاف على مستوى الفندق عبر REST API، وللمخزون كاملًا عبر ملفات dump اليومية الكاملة وdelta dump. والمعاملان include وlang في المثال مسودة API v1؛ ويُنشر المخطط النهائي في صفحة المطورين.
المعلومات المنظّمة اللازمة للتصفية والمقارنة موجودة في منتج بطاقة بيانات الفندق. أما معرض صور الفندق فتُزال تكراراته ويُوسَم بالفئات في خدمة صور الفنادق. ولمعرفة النطاق والسعر يمكنك طلب عرض سعر.
الطلب
curl "https://api.hotelmapping.org/v1/hotels/HM-1048213/content?include=descriptions&lang=en" \
-H "X-API-Key: $HM_API_KEY" الاستجابة
{
"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) المنظّمة.
الوصف نص مكتوب للقراءة. أما بطاقة البيانات فتقدّم معلومات مثل موعد الدخول والخروج والشاطئ والمسبح وسياسة الأطفال في حقول منفصلة للتصفية والمقارنة. وكلاهما يعتمد على البيانات نفسها.
على مستوى الفندق عبر REST API، وللمخزون كاملًا عبر ملفات dump اليومية الكاملة وdelta. ويُخطَّط لـ webhook للإشعار بالتغييرات.
تُحدَّد شروط استخدام المحتوى وترخيصه في العقد.
اطلب عرض سعر
أرسل طلبك في ثلاث خطوات، ونرسل العرض إلى بريدك الإلكتروني للعمل. الطلب غير ملزم.