מאפיינים

בדף הזה מוסבר על התיאורים, הערכים והדרישות של מאפיינים ורכיבי צאצא. הערכים האלה רלוונטיים רק לנכסי אירוח תיירותי.

המבנה הכללי של ה-XML דומה לפורמט של פידים של כרטיסי מלונות. למידע נוסף, ראו מקור מידע בנושא קובץ XML של רשימת מלונות.

אם לא תכללו את הפריטים הנדרשים הבאים, כרטיס המוצר יושבת באופן אוטומטי:

  • רכיבי הצאצא הנדרשים ב-XML: id, ‏ name, ‏ latitude, ‏ longitude, ‏ address.
  • מאפיינים נדרשים: capacity ו-website. קישורים ישירים ליחידות אירוח בפיד הדפים העסקיים. כך המשתמשים יכולים להיכנס לאתר של הנכס.

פרטים על רכיבי הצאצאים הנדרשים ב-XML מופיעים במאמר רכיבי צאצאים של XML.

מידע נוסף על יחידות אירוח זמין במאמר מאפיינים ייחודיים ליחידות אירוח.

לסיום, אם Google קובעת ממקורות אחרים שהערך של מאפיין שונה מהערך שצוין בפיד של כרטיס יחידת אירוח, Google מציגה את הערך של כרטיס האירוח. לדוגמה, אם Google קובעת מהתמונות של דף פרטי האירוח שיש בו מטבח, אבל המאפיין kitchen חסר או מוגדר כ-No, Google מתייחסת לדף הפרטים ככזה שכולל מטבח. המאפיינים האלה נקראים 'מאפיינים משוערים', והם מוצגים רק כשיש ודאות גבוהה ברמת הדיוק של ההשערה.

ערכים ל-placeholder attribute_name

בטבלה הבאה מופיעה רשימה של ערכים חוקיים ל-attribute_name ברכיב <client_attr name="attribute_name">. עם זאת, מומלץ לספק את הערכים הנוספים של attribute_name, אם יש כאלה.

ערכים של attribute_name חובה? תיאור ערכים חוקיים של תוכן
capacity Required מספר האורחים המקסימלי שיכולים להתארח בנכס. הערך הזה צריך להיות שווה ל-"number_of_bedrooms" או גדול ממנו. 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 כשהערך של rating_scale הוא 5.

הערה: אם לא מציינים ערך, ערך ברירת המחדל של rating_scale הוא 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:00 במקום ב-11:00 או ב-11:00am. כל הפורמטים האחרים לא יינתחו או יוצגו. 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 מספר הרישיון (תיירותי או עסקי) שצריך להציג בנכסים באזורים מסוימים בעולם. אפשר לחזור עליו, ואם יש כמה רישיונות, מומלץ להוסיף את הרשות שהנפיקה את הרישיון כחלק מההקשר. לדוגמה: 'Paris: 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

המיקום הפיזי המלא של הנכס כמחרוזת. הכתובת חייבת לכלול שם רחוב ומספר בית. אם אין כתובת, צריך לכלול את קוד ה-OLC. אם רלוונטי, יש לכלול גם את מספר הדירה או היחידה.

לחלופין, אפשר לספק כתובת 'מורכבת'. משתמשים באלמנטים הצאצאים של <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>

ריכזנו כאן דוגמאות לכתובת מלאה עם קוד OLC:

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