ویژگی های

این صفحه توضیحات، مقادیر و الزامات ویژگی ها و عناصر فرزند را پوشش می دهد. این مقادیر فقط برای املاک Vacation Rentals قابل اعمال است.

ساختار کلی XML فرمتی مشابه فیدهای فهرست هتل دارد. به مرجع XML لیست هتل مراجعه کنید.

عدم درج موارد مورد نیاز زیر به طور خودکار فهرست را غیرفعال می کند:

  • عناصر فرزند XML مورد نیاز: id ، name ، latitude ، longitude ، address .
  • ویژگی های مورد نیاز: capacity و website . به پیوندهای مستقیم اجاره تعطیلات در فید لیست خود مراجعه کنید. این به کاربران این امکان را می دهد که از وب سایت ملک بازدید کنند.

برای جزئیات عناصر فرزند XML مورد نیاز، به عناصر فرزند XML مراجعه کنید.

برای اطلاعات بیشتر در مورد اجاره تعطیلات، به ویژگی های منحصر به فرد برای اجاره تعطیلات مراجعه کنید.

در نهایت، وقتی Google از منابع دیگر تشخیص می‌دهد که ارزش یک ویژگی با آنچه در فید برای فهرست اجاره تعطیلات مشخص شده است متفاوت است، Google مقدار فهرست را نمایش می‌دهد. برای مثال، اگر Google از روی عکس‌های فهرستی تشخیص دهد که آشپزخانه دارد، اما مشخصه kitchen وجود ندارد یا روی No تنظیم شده است، Google فهرست را به‌عنوان داشتن آشپزخانه در نظر می‌گیرد. این ویژگی‌ها «ویژگی‌های استنباط‌شده» نامیده می‌شوند و تنها زمانی نمایش داده می‌شوند که اطمینان بالایی به دقت استنتاج وجود داشته باشد.

مقادیر برای مکان نگهدار ویژگی_name

جدول زیر فهرستی از مقادیر معتبر attribute_name را در عنصر <client_attr name="attribute_name"> ارائه می‌کند. با این حال، توصیه می شود در صورت وجود attribute_name اضافی خود را ارائه دهید.

مقادیر attribute_name مورد نیاز؟ توضیحات مقادیر محتوای معتبر
capacity Required حداکثر تعداد مهمانانی که ملک می تواند در خود جای دهد. این مقدار باید برابر یا بیشتر از "تعداد_خواب_ها" باشد. Non-negative integer value
website Required آدرس وب سایت برای ملک. 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 یا 14:00 از ساعت 14:00 استفاده کنید. همه قالب‌های دیگر تجزیه یا نمایش داده نمی‌شوند. Time
check_out_time Recommended زمان دقیق روز برای خروج از ملک. فرمت HHMM، HH:MM، یا HH:MM:SS پذیرفته شد. به عنوان مثال، به جای 11 صبح یا 11:00 از ساعت 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, 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>
،

این صفحه توضیحات، مقادیر و الزامات ویژگی ها و عناصر فرزند را پوشش می دهد. این مقادیر فقط برای املاک Vacation Rentals قابل اعمال است.

ساختار کلی XML فرمتی مشابه فیدهای فهرست هتل دارد. به مرجع XML لیست هتل مراجعه کنید.

عدم درج موارد مورد نیاز زیر به طور خودکار فهرست را غیرفعال می کند:

  • عناصر فرزند XML مورد نیاز: id ، name ، latitude ، longitude ، address .
  • ویژگی های مورد نیاز: capacity و website . به پیوندهای مستقیم اجاره تعطیلات در فید لیست خود مراجعه کنید. این به کاربران این امکان را می دهد که از وب سایت ملک بازدید کنند.

برای جزئیات عناصر فرزند XML مورد نیاز، به عناصر فرزند XML مراجعه کنید.

برای اطلاعات بیشتر در مورد اجاره تعطیلات، به ویژگی های منحصر به فرد برای اجاره تعطیلات مراجعه کنید.

در نهایت، وقتی Google از منابع دیگر تشخیص می‌دهد که ارزش یک ویژگی با آنچه در فید برای فهرست اجاره تعطیلات مشخص شده است متفاوت است، Google مقدار فهرست را نمایش می‌دهد. برای مثال، اگر Google از روی عکس‌های فهرستی تشخیص دهد که آشپزخانه دارد، اما مشخصه kitchen وجود ندارد یا روی No تنظیم شده است، Google فهرست را به‌عنوان داشتن آشپزخانه در نظر می‌گیرد. این ویژگی‌ها «ویژگی‌های استنباط‌شده» نامیده می‌شوند و تنها زمانی نمایش داده می‌شوند که اطمینان بالایی به دقت استنتاج وجود داشته باشد.

مقادیر برای مکان نگهدار ویژگی_name

جدول زیر فهرستی از مقادیر معتبر attribute_name را در عنصر <client_attr name="attribute_name"> ارائه می‌کند. با این حال، توصیه می شود در صورت وجود attribute_name اضافی خود را ارائه دهید.

مقادیر attribute_name مورد نیاز؟ توضیحات مقادیر محتوای معتبر
capacity Required حداکثر تعداد مهمانانی که ملک می تواند در خود جای دهد. این مقدار باید برابر یا بیشتر از "تعداد_خواب_ها" باشد. Non-negative integer value
website Required آدرس وب سایت برای ملک. 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 یا 14:00 از ساعت 14:00 استفاده کنید. همه قالب‌های دیگر تجزیه یا نمایش داده نمی‌شوند. Time
check_out_time Recommended زمان دقیق روز برای خروج از ملک. فرمت HHMM، HH:MM، یا HH:MM:SS پذیرفته شد. به عنوان مثال، به جای 11 صبح یا 11:00 از ساعت 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, 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>