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