السمات

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

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

في حال عدم تضمين العناصر المطلوبة التالية، سيتم إيقاف بطاقة البيانات تلقائيًا.

للحصول على تفاصيل حول عناصر XML الثانوية المطلوبة، يمكنك الاطّلاع على عناصر XML الثانوية.

لمزيد من المعلومات عن أماكن الاستئجار، يُرجى الاطّلاع على السمات الخاصة بأماكن الاستئجار.

أخيرًا، عندما يحدّد محرّك بحث Google من مصادر أخرى أنّ قيمة سمة معيّنة مختلفة عن ما هو محدّد في الخلاصة الخاصة بالأماكن المخصّصة للاستئجار، سنعرض قيمة للمكان المخصّص للاستئجار. على سبيل المثال، إذا تبيّن لنا من صور البيانات أنّها تتضمّن مطبخًا، لكنّ السمة kitchen غير متوفّرة أو تم ضبطها على No، سنتعامل مع البيانات على أنّها تتضمّن مطبخًا. يُطلق على هذه السمات اسم "السمات المستنتَجة"، ولن يتم عرضها إلا عندما نكون واثقين جدًا من دقة الاستنتاج.

قيم العنصر النائب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
minimum_days_advance_purchase Recommended الحد الأدنى لعدد الأيام التي يمكن حجز الفندق خلالها مسبقًا. Non-negative integer value
minimum_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

تمثّل هذه السمة الموقع الجغرافي الكامل للمكان.

يأخذ هذا العنصر سمة واحدة، وهي format، التي يجب ضبطها على simple.

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

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

مثال:

<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="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="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="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="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="smoking_free_property">Yes</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>