السمات

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

تستخدم بنية 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

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

يأخذ هذا العنصر سمة واحدة، 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="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>