حلول بطاقة بيانات الفندق

تقدّم بطاقة بيانات الفندق (factsheet) المعلومات الأساسية عن الفندق في حقول منفصلة وقابلة للتصفية بدل النص الحر: نوع المنشأة والنجوم وعدد الغرف ومواعيد الدخول والخروج والشاطئ والمسابح وسياسة الأطفال والحيوانات الأليفة والمطاعم وبيانات الاتصال. تجتمع المعلومات القادمة من جميع المورّدين تحت HM ID الفندق، وتُعلَّم القيم المتعارضة؛ وتُسلَّم البيانات عبر API وملفات dump.

ما الذي تكسبه

  • جاهزة للتصفية

    موعد الدخول وسياسة الأطفال ونوع الشاطئ وعدد الغرف حقول منفصلة، فتُستخدم مباشرة في عوامل التصفية والمقارنة.

  • فندق واحد وحقيقة واحدة

    تُجمع معلومات الفندق لدى جميع المورّدين تحت HM ID واحد. ولا تتغير صفحة الفندق بحسب المورّد الذي جاء منه الزائر.

  • التعارضات ظاهرة

    عندما يعطي المورّدون قيمًا مختلفة للحقل نفسه يُعلَّم الحقل. وترى في الاستجابة أي المعلومات تنتظر المراجعة.

  • متسقة مع الأوصاف

    تُنتَج أوصاف الفنادق من بيانات بطاقة البيانات نفسها؛ فلا يتعارض النص مع الحقول.

قبل وبعد

معلومات منشأة خام من مورّدين اثنين

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

بطاقة بيانات قياسية تحت HM ID

بطاقة بيانات 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"]
  }
}

هذه بيانات مثال؛ الفندق والرموز لا تخص منشأة حقيقية. تُعلَّم الحقول التي يتعارض فيها المورّدون (هنا موعد الدخول وعدد الغرف) في review_flags.

كيف يعمل

  1. 1

    دمج المصادر

    تُجمع معلومات الفندق من جميع سجلات المورّدين المرتبطة بـ HM ID نفسه. وتُحفظ البيانات الخام كما هي، وتُسجَّل التغييرات بإصدارات.

  2. 2

    التقسيم إلى حقول

    تتحول المواعيد والأرقام والمسافات والسياسات الواردة في النص الحر إلى حقول منفصلة؛ وتُوحَّد صيغ الوقت والمسافة والعمر.

  3. 3

    فحص التعارض

    عندما تعطي المصادر معلومات مختلفة تُقارن القيم. وتُعلَّم الحقول الملتبسة وتدخل في قائمة مراجعة فريق البيانات.

  4. 4

    التسليم والتحديث

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

لماذا بطاقة البيانات في حقول منفصلة؟

يرسل المورّدون معلومات الفندق في الغالب داخل نص حر. يكتب مورّد موعد الدخول 14:00 وآخر 15:00؛ وأحدهما يقول 412 غرفة والآخر 410. وتضيع معلومة الشاطئ داخل جملة، وتصل حدود عمر الأطفال بصيغ مختلفة. وبهذا الشكل لا يمكن بناء عامل تصفية مثل «فنادق ذات شاطئ رملي خاص» أو «إقامة مجانية للأطفال من 0 إلى 6 سنوات».

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

حقول بطاقة البيانات

المجموعة الحقول مثال على القيمة
معلومات المنشأة نوع المنشأة، النجوم، السلسلة والعلامة، عدد الغرف والطوابق، سنة الافتتاح والتجديد منتجع، 5 نجوم، 412 غرفة
السياسات موعد الدخول والخروج؛ سياسة الأطفال والحيوانات الأليفة والتدخين والدفع 14:00 / 12:00، مجاني للأطفال من 0 إلى 6.99 سنة
الشاطئ والمسبح نوع الشاطئ، وهل هو تابع للفندق، والمسافة؛ وعدد المسابح المفتوحة والمغلقة رملي، تابع للفندق، 250 م؛ 3 مفتوحة، 1 مغلق
الطعام والشراب المطاعم والبارات وأنواع المطابخ ومواعيد العمل مطعم مأكولات تركية، بار المسبح
الاتصال والعنوان عنوان موثّق، هاتف، بريد إلكتروني، موقع إلكتروني [email protected]

أسماء الحقول وقيمها مستقلة عن اللغة؛ وتعرض في واجهتك التسمية بلغتك.

المعلومات المتعارضة

عندما يعطي المورّدون قيمًا مختلفة للفندق نفسه تُقارن القيم. وتُعلَّم الحقول التي تبقى ملتبسة في review_flags ويراجعها فريق البيانات. وبذلك ترى من الاستجابة أي المعلومات مؤكدة وأيها ينتظر المراجعة.

الأوصاف والتسليم

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

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

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

مثال API

الطلب

طلب بطاقة البيانات
curl "https://api.hotelmapping.org/v1/hotels/HM-1048213/content?include=factsheet" \
  -H "X-API-Key: $HM_API_KEY"

الاستجابة

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"
}

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

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

ما هي بطاقة بيانات الفندق (factsheet)؟

هي تقديم المعلومات الأساسية عن الفندق (نوع المنشأة والنجوم وعدد الغرف ومواعيد الدخول والخروج والسياسات والطعام والاتصال) في حقول منظّمة.

ما الفرق بين بطاقة البيانات ووصف الفندق؟

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

أي معلومة تُستخدم إذا أعطى المورّدون معلومات مختلفة؟

تُقارن القيم؛ وتُعلَّم الحقول التي تبقى ملتبسة ويراجعها فريق البيانات. وتظهر في الاستجابة الحقول المنتظرة للمراجعة في review_flags.

بأي صيغ يمكنني الحصول على بيانات بطاقة البيانات؟

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

اطلب عرض سعر

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

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

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