تتناول هذه الصفحة الأوصاف والقيم والمتطلبات للسمات والعناصر التابعة. لا تنطبق هذه القيم إلا على مواقع الاستئجار.
تتّبع بنية XML العامة تنسيقًا مشابهًا لخلاصات بيانات الفنادق. اطّلِع على مرجع XML لقوائم الفنادق.
يؤدي عدم تضمين العناصر المطلوبة التالية إلى إيقاف listing تلقائيًا:
- العناصر الفرعية المطلوبة بتنسيق 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 | الحد الأقصى لعدد الضيوف الذين يمكن أن يستوعبهم الفندق يجب أن تكون هذه القيمة مساوية أو أكبر من "عدد_الغرف". | 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 | الحد الأقصى للتصنيف الممكن لموقع. على سبيل المثال، يجب أن تكون قيمة تقييم الفندق
هي 3 أو 4 إذا كان مقياس التقييم هو 5.
ملاحظة: تكون قيمة مقياس_التقييم التلقائية من 0 إلى 10 إذا لم يتم تحديدها. |
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 |
room_type | Recommended | نوع الغرفة ENTIRE_PLACE هي القيمة الوحيدة المسموح بها. |
ENTIRE_PLACE
|
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> يمكن إنشاء هذه القيمة باستخدام أدوات ترميز المواقع الجغرافية، مثل Google Maps API. |
<longitude> | Required | float | خط الطول الذي يمثّل الموقع الجغرافي للفندق ضمن البيانات. على سبيل المثال:
<longitude>-122.090101</longitude> يمكن إنشاء هذه القيمة باستخدام أدوات ترميز المواقع الجغرافية، مثل Google Maps API. |
<name> | Required | string | اسم الموقع. 300 حرف كحدّ أقصى |
<address> | Required | string or Object | الموقع الجغرافي الكامل للمكان كسلسلة. يجب أن يتضمّن العنوان اسم الشارع ورقمه. وإذا لم يتوفّر أيّ منها، يجب أن يتضمّن العنوان رمز Plus Codes. يجب أيضًا تضمين أرقام الشقق أو الوحدات، إن توفّرت. بدلاً من ذلك، يمكنك تقديم عنوان "مركب". استخدِم عناصر
يُرجى العلم أنّ صناديق البريد أو غير ذلك من العناوين المخصّصة للبريد فقط لا تُعتبر عناوين جغرافية كاملة. في ما يلي أمثلة على عنوان كامل: <address>6 Acacia Ave Apt. 2, Nottingham NG8 6FT, UK/address> <address> <component name="addr1">6 Acacia Ave</component> <component name="addr2">Apt. 2</component> <component name="city">Nottingham </component> <component name="postal_code">NG8 6FT</component> <component name="country">UK</component> </address> في ما يلي أمثلة على عنوان كامل باستخدام رمز موقع مفتوح: <address>XQHM+7VF Nottingham NG8 6FT, UK/address> <address> <component name="addr1">XQHM+7VF</component> <component name="city">Nottingham </component> <component name="postal_code">NG8 6FT</component> <component name="country">UK</component> </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>