تتناول هذه الصفحة الأوصاف والقيم والمتطلبات الخاصة بالسمات والعناصر التابعة. تنطبق هذه القيم فقط على أماكن الاستئجار.
تستخدم بنية XML العامة تنسيقًا مشابهًا لخلاصات بيانات الفنادق. يُرجى الاطّلاع على مرجع XML لقائمة الفنادق.
يؤدي عدم تضمين العناصر المطلوبة التالية إلى إيقاف بطاقة البيانات تلقائيًا:
- عناصر XML الثانوية المطلوبة:
id
وname
وlatitude
وlongitude
وaddress
. - السمتان المطلوبتان:
capacity
وwebsite
. اطّلِع على الروابط المباشرة الخاصة بأماكن للاستئجار في خلاصة بياناتك. يمنح ذلك المستخدمين الفرصة لزيارة موقع الويب الخاص بالعقار.
للحصول على تفاصيل عناصر XML الثانوية المطلوبة، يمكنك الرجوع إلى عناصر XML الثانوية.
لمزيد من المعلومات حول أماكن الاستئجار، يُرجى الاطّلاع على السمات الفريدة لأماكن الاستئجار.
أخيرًا، عندما يحدّد محرّك بحث Google من مصادر أخرى أنّ قيمة السمة مختلفة عن القيمة المحدّدة في خلاصة المكان المخصّص للاستئجار، يعرض Google قيمة تلك السمة. على سبيل المثال، إذا تبيّن لمحرّك بحث Google من صور بطاقة البيانات أنّه يتضمّن مطبخًا، لكنّ السمة kitchen
غير موجودة أو تم ضبطها على No
،
سيتعامل محرّك بحث Google مع بطاقة البيانات على أنّها تتضمّن مطبخًا. ويُطلق على هذه السمات
"السمات المستنتَجة"، ولا يتم عرضها إلا إذا كان هناك ثقة كبيرة
في دقة الاستنتاج.
قيم العنصر النائبattribute_name
يوفّر الجدول التالي قائمة بالقيم الصالحة للسمة attribute_name
في العنصر <client_attr name="attribute_name">
، ولكن ننصحك بتقديم سمة attribute_name
الإضافية إذا توفّرت.
قيم attribute_name |
مطلوب؟ | الوصف | قيم المحتوى الصالحة |
---|---|---|---|
capacity | Required | يمكن أن يستوعب الفندق الحدّ الأقصى لعدد النزلاء. ويجب أن تكون هذه القيمة مساوية لـ "number_of_rooms" أو أكبر منها. | Non-negative integer value |
website | Required | تمثّل هذه السمة عنوان URL للموقع الإلكتروني. | Free text |
partner_hygiene_link | Strongly recommended | رابط يؤدّي إلى موقع إلكتروني خارجي خاص بشريك يقدّم مزيدًا من المعلومات حول تفاصيل الحالة الصحية لعرض الإعلانات | Free text (the site's URL) |
number_of_bathrooms | Strongly recommended | عدد الحمّامات | Non-negative float value, for example, 1, 1.5, 2 |
number_of_bedrooms | Strongly recommended | عدد غرف النوم. | Non-negative integer value |
number_of_beds | Strongly recommended | عدد الأسرّة في كل الغرف. | Non-negative integer value |
self_checkin_checkout | Recommended | تُستخدَم لتحديد ما إذا كان المكان المخصّص للاستئجار يوفّر إمكانية تسجيل الوصول والمغادرة ذاتيًا. | Yes/No/Unknown |
rating | Strongly recommended | رقم نقطة عائمة يمثّل تقييم الموقع المجمَّع. يتراوح هذا الرقم عادةً بين 0 و5 أو 0-10 أو 0-100، ولكن يمكنك استخدام أي نطاق يمثّل نظام التقييم الخاص بك. | Non-negative float value |
rating_num | Strongly recommended | تمثّل هذه السمة عدد التقييمات التي يتضمّنها الموقع. | Non-negative integer value |
rating_scale | Strongly recommended | أقصى تقييم ممكن لأحد المواقع | Non-negative integer value |
instant_bookable | Strongly recommended | تُستخدَم لتحديد ما إذا كان المكان المخصّص للاستئجار قابلاً للحجز بشكل فوري عبر إتمام عملية إتمام الدفع. والخيار البديل هو انتظار الحصول على موافقة. | Yes/No/Unknown |
description | Strongly recommended | نص حر يصف السمات الفريدة للمكان | Free text |
category | Strongly recommended | نوع العقار، مثل فيلا أو أكواخ بنغالو أو كوخ خشبي أو شقة | Free text |
ac | Recommended | تُستخدَم لتحديد ما إذا كان المكان المخصّص للاستئجار يوفّر مكيفات هواء. | Yes/No/Unknown |
beach_access | Recommended | تُستخدَم لتحديد ما إذا كان المكان المخصّص للاستئجار يتيح استخدام شاطئ عام بالقرب منه. | Yes/No/Unknown |
check_in_time | Recommended | الوقت الدقيق من اليوم لتسجيل الوصول إلى الموقع. يتم قبول التنسيق HHMM أو HH:MM أو HH:MM:SS، على سبيل المثال، استخدم 14:00 بدلاً من 2 بعد الظهر أو 2:00 بعد الظهر. ولن يتم تحليل جميع التنسيقات الأخرى أو عرضها. | Time |
check_out_time | Recommended | الوقت المحدَّد من اليوم لتسجيل المغادرة من الفندق. يتم قبول التنسيق HHMM أو HH:MM أو HH:MM:SS، على سبيل المثال، استخدم 11:00 بدلاً من 11 صباحًا أو 11:00 صباحًا. ولن يتم تحليل جميع التنسيقات الأخرى أو عرضها. | Time |
child_friendly | Recommended | تُستخدَم لتحديد ما إذا كان المكان المخصّص للاستئجار مناسبًا للأطفال. | Yes/No/Unknown |
crib | Recommended | تُستخدَم لتحديد ما إذا كان المكان المخصّص للاستئجار يوفّر سرير أطفال. | Yes/No/Unknown |
elevator | Recommended | تُستخدَم لتحديد ما إذا كان المكان المخصّص للاستئجار يضم مصعدًا. | Yes/No/Unknown |
gym_fitness_equipment | Recommended | تُستخدَم لتحديد ما إذا كان المكان المخصّص للاستئجار يوفّر صالة تمارين أو معدّات رياضية. | Yes/No/Unknown |
heating | Recommended | تُستخدَم لتحديد ما إذا كان المكان المخصّص للاستئجار يوفّر التدفئة. | Yes/No/Unknown |
hot_tub | Recommended | تُستخدَم لتحديد ما إذا كان المكان المخصّص للاستئجار يوفّر مغطس مياه ساخنة. | Yes/No/Unknown |
ironing_board | Recommended | تُستخدَم لتحديد ما إذا كان المكان المخصّص للاستئجار يوفّر ألواح كي. | Yes/No/Unknown |
kitchen | Recommended | تُستخدَم لتحديد ما إذا كان المكان المخصّص للاستئجار يوفّر مطبخًا. | Yes/No/Unknown |
microwave | Recommended | تُستخدَم لتحديد ما إذا كان المكان المخصّص للاستئجار يوفّر ميكروويف. | Yes/No/Unknown |
min_days_advance_purchase | Recommended | الحدّ الأدنى لعدد الأيام التي يمكن حجز الفندق خلالها مسبقًا. | Non-negative integer value |
min_night_stay | Recommended | الحدّ الأدنى لعدد الليالي التي يمكن للنزلاء حجزها في الفندق. | Positive integer (more than zero) |
max_night_stay | Recommended | الحدّ الأقصى لعدد الليالي التي يمكن أن يحجزها النزلاء في الفندق. | Positive integer (more than zero) |
outdoor_grill | Recommended | تُستخدَم لتحديد ما إذا كان المكان المخصّص للاستئجار يوفّر أدوات الشواء. | Yes/No/Unknown |
oven_stove | Recommended | تُستخدَم لتحديد ما إذا كان المكان المخصّص للاستئجار يوفّر موقد طهي. | Yes/No/Unknown |
parking_type | Recommended | تحدّد هذه السمة نوع موقف السيارات المتاح في المكان المخصّص للاستئجار. | Free/Paid/None |
patio | Recommended | تُستخدَم لتحديد ما إذا كان المكان المخصّص للاستئجار يوفّر فناء. | Yes/No/Unknown |
pets_allowed | Recommended | يسمح بعض الغرف أو كلّها للنزلاء بإحضار الحيوانات الأليفة، أي الكلاب أو القطط التي ليست خدمة للحيوانات. | Yes/No/Unknown |
pool_type | Recommended | نوع حوض السباحة (إمكانية الوصول إلى المسبح) الذي يضمّه الفندق: | Indoors, Outdoors, Indoors/Outdoors, None |
smoking_free_property | Recommended | تُستخدَم لتحديد ما إذا كان المكان المخصّص للاستئجار محظورًا أو لا يُسمح بالتدخين فيه. | Yes/No/Unknown |
special_service_level | Recommended | ما إذا كان مستوى خدمة البيانات مميّزًا بطريقة ما.
على سبيل المثال، verified وluxury وpremium |
Yes/No/Unknown |
square_footage | Recommended | مساحة العقار بالقدم المربّعة | Non-negative float value |
square_meters | Recommended | مساحة العقار بالمتر المربّع | Non-negative float |
tv | Recommended | تُستخدَم لتحديد ما إذا كان المكان المخصّص للاستئجار يوفّر جهاز تلفزيون. | Yes/No/Unknown |
washer_dryer | Recommended | تُستخدَم لتحديد ما إذا كان المكان المخصّص للاستئجار يوفّر غسالات ملابس. | Yes/No/Unknown |
wheelchair_accessible | Recommended | تُستخدَم لتحديد ما إذا كان المكان المخصّص للاستئجار مناسبًا لأصحاب الكراسي المتحرّكة. | Yes/No/Unknown |
internet_type | Recommended | تحدّد هذه السمة نوع خدمة Wi-Fi التي يوفّرها الفندق. | Free/Paid/None |
airport_shuttle | Optional | تُستخدَم لتحديد ما إذا كان المضيف يوفّر خدمات نقل من وإلى المطار أو محطات النقل الأخرى. | Yes/No/Unknown |
balcony | Optional | تُستخدَم لتحديد ما إذا كان المكان المخصّص للاستئجار يوفّر شرفة. | Yes/No/Unknown |
fire_place | Optional | تُستخدَم لتحديد ما إذا كان المكان المخصّص للاستئجار يضم موقد تدفئة. | Yes/No/Unknown |
free_breakfast | Optional | تُستخدَم لتحديد ما إذا كانت الإقامة تشمل وجبة فطور مجانية. | Yes/No/Unknown |
host_description | Optional | تمثّل هذه السمة وصف المضيف في المكان المخصّص للاستئجار. | Free text |
host_language | Optional | اللغات التي يتحدّثها المضيف | قائمة
رموز اللغات مفصولة بفواصل، مثل: de وen |
host_name | Optional | تمثّل هذه السمة اسم مضيف المكان المخصّص للاستئجار. | Free text |
host_response_rate | Optional | متوسط معدّل استجابة المضيف. | Non-negative float value, for example, 1, 0.75, 0.5 |
host_response_time | Optional | متوسط وقت استجابة المضيف. | Free text |
license_num | Optional | تشير هذه السمة إلى رقم الترخيص (السياحي أو التجاري) المطلوب عرضه للأماكن المخصّصة للاستئجار في مناطق معيّنة من العالم. ويمكن تكرارها، وفي حال توفُّر عدة تراخيص، ننصح بإضافة جهة إصدار الترخيص كسياق. على سبيل المثال: "باريس: 123456ABC". | Free text |
number_of_half_bathrooms | Optional | عدد الحمّامات نصفها. | Non-negative integer value |
number_of_living_rooms | Optional | عدد غرف المعيشة. | Non-negative integer value |
private_beach_access | Optional | تُستخدَم لتحديد ما إذا كان المكان المخصّص للاستئجار يوفّر إمكانية استخدام شاطئ خاص. | Yes/No/Unknown |
refund_policy | Optional | سياسة ردّ الأموال الخاصة بالموقع الإلكتروني | Free text |
عناصر XML الثانوية
يجب إدخال عناصر XML الثانوية التالية:
العنصر الفرعي | مطلوب؟ | النوع | الوصف |
---|---|---|---|
<country> | Strongly recommended | string | البلد الذي تقع فيه بطاقة البيانات هذه. يجب أن تكون القيمة
رمز بلد مكوّنًا من حرفَين وفقًا لمعيار
ISO 3116. على سبيل المثال، الولايات المتحدة هي US
وكندا CA :
<country>US</country> |
<id> | Required | string | تشير هذه السمة إلى المعرّف الفريد الخاص بالمكان المخصّص للاستئجار. يُرجى العِلم أنّه يجب أن يكون لكل مكان للاستئجار معرّف فريد لموقعك الإلكتروني، ويجب عدم إعادة استخدام هذا المعرّف مطلقًا. |
<latitude> | Required | float | خط العرض الذي يمثّل الموقع الجغرافي للفندق ضمن البيانات. مثلاً:
<latitude>37.423738</latitude> ويمكن إنشاء هذه القيمة باستخدام أدوات GeoCoding مثل Google Maps API. |
<longitude> | Required | float | خط الطول الذي يمثّل الموقع الجغرافي للفندق ضمن البيانات. مثلاً:
<longitude>-122.090101</longitude> ويمكن إنشاء هذه القيمة باستخدام أدوات GeoCoding مثل Google Maps API. |
<name> | Required | string | تمثّل هذه السمة اسم المكان المخصّص للاستئجار. 300 حرف كحدّ أقصى |
<address> | Required | Object or string | تمثّل هذه السمة الموقع الجغرافي الكامل للفندق. يأخذ هذا العنصر سمة واحدة، على الأقل، عليك تقديم عنوان الشارع والمدينة والولاية أو المنطقة
والرمز البريدي للموقع. استخدِم عناصر
مثلاً: <address format="simple"> <component name="addr1">6 Acacia Ave</component> <component name="addr2">Floor 5</component> <component name="city">London</component> <component name="province">Greater London</component> <component name="postal_code">SW1W 9TQ</component> </address> ويمكنك بدلاً من ذلك تقديم عنوان بتصميم مرن، ولكننا لا ننصح بذلك. مثلاً: <address>6 Elm Ave Unit 3, Boston, MA, 02472</address> يُرجى العلم أنّ صناديق البريد أو غير ذلك من العناوين المخصّصة للبريد فقط لا تُعتبر عناوين جغرافية كاملة. |
مثال على أماكن للاستئجار
<?xml version="1.0" encoding="UTF-8"?> <listings> <language>en</language> <listing> <id>123456</id> <name>Apartment Name</name> <address format="simple"> <component name="addr1">18733 Clark Way</component> <component name="addr2">#C10</component> <component name="city">Mountain View</component> <component name="postal_code">94043</component> <component name="province">California</component> </address> <country>US</country> <latitude>37.4182515</latitude> <longitude>-122.0742354</longitude> <phone type="main">12345678</phone> <category>vacation_villa</category> <date day="21" month="12" year="2017"/> <content> <text type="description"> <link>https://list_url</link> <title>Description Title</title> <body>Description Body</body> </text> <review type="editorial"> <link>https://example.com/reviews/42</link> <title>A little piece of heaven</title> <author>EXAMPLE</author> <rating>8</rating> <body>This place is really good.</body> </review> <review type="user"> <link>https://exampleperson.org/reviews/82</link> <author>Susan von Trapp</author> <rating>6</rating> <body>Not a bad place, but I prefer to be closer to the beach.</body> <date day="6" month="7" year="2017"/> <servicedate day="16" month="6" year="2017"/> </review> <attributes> <website>https://hotel.example.com/123456</website> <client_attr name="capacity">7</client_attr> <client_attr name="cleaning_disinfection">Yes</client_attr> <client_attr name="min_days_between_stays">3</client_attr> <client_attr name="enhanced_cleaning_practices">Yes</client_attr> <client_attr name="partner_hygiene_link">http://www.example.com/hygiene/</client_attr> <client_attr name="number_of_bathrooms">2</client_attr> <client_attr name="number_of_bedrooms">3</client_attr> <client_attr name="number_of_beds">4</client_attr> <client_attr name="self_checkin_checkout">Yes</client_attr> <client_attr name="rating">4.8</client_attr> <client_attr name="rating_num">5373</client_attr> <client_attr name="rating_scale">5</client_attr> <client_attr name="ac">Yes</client_attr> <client_attr name="airport_shuttle">Yes</client_attr> <client_attr name="balcony">No</client_attr> <client_attr name="beach_access">Yes</client_attr> <client_attr name="check_in_time">15:00</client_attr> <client_attr name="check_out_time">11:00</client_attr> <client_attr name="child_friendly">Yes</client_attr> <client_attr name="crib">Unknown</client_attr> <client_attr name="elevator">Yes</client_attr> <client_attr name="fire_place">Unknown</client_attr> <client_attr name="free_breakfast">Yes</client_attr> <client_attr name="gym_fitness_equipment">Yes</client_attr> <client_attr name="heating">Yes</client_attr> <client_attr name="host_description">A short description about the host and their interests</client_attr> <client_attr name="host_name">The name of the host</client_attr> <client_attr name="host_language">en, da, el</client_attr> <client_attr name="host_response_rate">0.75</client_attr> <client_attr name="host_response_time">1 hour</client_attr> <client_attr name="hot_tub">Yes</client_attr> <client_attr name="instant_bookable">Yes</client_attr> <client_attr name="internet_type">Free</client_attr> <client_attr name="ironing_board">No</client_attr> <client_attr name="kitchen">Yes</client_attr> <client_attr name="license_num">Free text. If multiple licenses exist, we suggest adding authority of the licence as context</client_attr> <client_attr name="license_num">Paris: 123456ABC</client_attr> <client_attr name="microwave">Yes</client_attr> <client_attr name="max_night_stay">7</client_attr> <client_attr name="min_days_advance_purchase">2</client_attr> <client_attr name="min_night_stay">3</client_attr> <client_attr name="number_of_living_rooms">1</client_attr> <client_attr name="outdoor_grill">No</client_attr> <client_attr name="oven_stove">Yes</client_attr> <client_attr name="parking_type">Free</client_attr> <client_attr name="patio">Unknown</client_attr> <client_attr name="pets_allowed">Yes</client_attr> <client_attr name="pool_type">Indoors</client_attr> <client_attr name="private_beach_access">Unknown</client_attr> <client_attr name="room_type">Entire Place</client_attr> <client_attr name="refund_policy">The refund policy for the property</client_attr> <client_attr name="smoking_free_property">Yes</client_attr> <client_attr name="special_service_level">No</client_attr> <client_attr name="square_footage">1200</client_attr> <client_attr name="tv">Yes</client_attr> <client_attr name="washer_dryer">Yes</client_attr> <client_attr name="wheelchair_accessible">Yes</client_attr> </attributes> </content> </listing> </listings>