السمات

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

تتّبع بنية 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. يجب أيضًا تضمين أرقام الشقق أو الوحدات، إن توفّرت.

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

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

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

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

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