السمات

تتناول هذه الصفحة الأوصاف والقيم والمتطلبات المتعلقة بالسمات التابعة. تنطبق هذه القيم فقط على أماكن الاستئجار.

تستخدم بنية 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:00 أو 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 string or Object

تمثّل هذه السمة الموقع الجغرافي الكامل للموقع الإلكتروني كسلسلة. يجب أن يتضمن العنوان اسم الشارع ورقمه. في حال عدم وجوده، يجب أن يتضمّن العنوان رمز الموقع المفتوح. يجب أيضًا تضمين رقم الشقة أو الوحدة، إذا كان ذلك منطبقًا.

وبدلاً من ذلك، يمكنك توفير حقل "مركب" الخاص بك. استخدام حساب طفل واحد (<component>) العناصر لوصف كل جزء من الأجزاء التالية من العنوان:

  • addr1: عنوان الشارع الأساسي
  • addr2: عنوان الشارع الثانوي، بما في ذلك رقم الوحدة، إذا لزم الأمر.
  • city: المدينة
  • province: الولاية أو المنطقة أو المقاطعة إذا لزم الأمر
  • postal_code: الرمز البريدي
  • country: البلد

يُرجى العِلم أنّ طلب الشراء المربعات أو العناوين الأخرى المخصصة للبريد فقط ليست تُعتبر عناوين فعلية كاملة.

في ما يلي أمثلة على عنوان كامل:

<address> 6 Acacia Ave Apt. 2, Sidney, V8L 3B8, Canada</address>
<address>
  <component name="addr1">6 Acacia Ave</component>
  <component name="addr2">Apt. 2</component>
  <component name="city">Sidney</component>
  <component name="postal_code">V8L 3B8 9TQ</component>
  <component name="country">Canada</component>
</address>

في ما يلي أمثلة على عنوان كامل باستخدام رمز الموقع المفتوح:

<address>84WRMJ53+HM, Sidney, V8L 3B8, Canada</address>
<address>
  <component name="addr1">84WRMJ53+HM</component>
  <component name="city">Sidney</component>
  <component name="postal_code">V8L 3B8 9TQ</component>
  <component name="country">Canada</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>