מאפיינים

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

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

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

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

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

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

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

<review>

הביקורת היא ביקורת משתמש או ביקורת מערכת. אין צורך לכלול את כל הביקורות על כרטיס מוצר ברכיב <listing>. האלמנט הזה נועד לכלול ביקורות נבחרות שמעידות על התכונות או האיכות של כרטיס המוצר הזה.

האלמנט <review> מופיע במיקום הבא בהיררכיית ה-XML של פיד רשימת המלונות:

+ <listings>
    + <language>
    + <listing>
        + <content>
            + <review>

תחביר

התחביר של רכיב <review> הוא:

<?xml version="1.0" encoding="UTF-8"?>
<listings ... >
  <listing>
    <content>
      ...
      <!-- Specify <review>'s child elements in the order shown below. -->
      <review type="editorial">
        <link>review_link</link>
        <title>review_title</title> <!-- Title is for reviews of type "editorial" only -->
        <author>review_author</author>
        <rating>review_rating</rating>
        <body>review_text</body>
        <date>review_date</date>
        <servicedate>review_servicedate</servicedate>
      </review>
      <review type="user">
        <link>review_link</link>
        <author>review_author</author>
        <date month="MM" day="DD" year="YYYY"/>  <!-- Date is for reviews of type "user" only -->
        <servicedate month="MM" day="DD" year="YYYY"/>  <!-- Service Date is for reviews of type "user" only -->
        <rating>review_rating</rating>
        <body>review_text</body>
      </review>
    </content>
  </listing>
</listings>

מאפיינים

לרכיב <review> יש את המאפיינים הבאים:

מאפיין חובה? תיאור
type Required סוג הביקורת. מגדירים לאחד מהערכים הבאים:
  • ‫editorial: ביקורת של אתר או של גורם אחר שמבצע ביקורות.
  • ‫user: ביקורת של משתמש קצה.

רכיבי צאצא

הרכיב <review> כולל את רכיבי הבן הבאים:

רכיב צאצא חובה? סוג תיאור
<link> Optional string קישור לביקורת. צריך לכלול את המחרוזת "http://‎" או "https://‎" ברכיב הזה.
<title> Optional string (ביקורות המערכת בלבד) הכותרת של הביקורת.
<author> Optional string המחבר של הביקורת, לדוגמה, 'סוזן פון טראפ'. זה יכול להיות גם השם של אתר או פרסום שבהם מופיעה הביקורת, אם לא מצוין מי כתב אותה.
<rating> Optional string מספר נקודה צפה (floating-point) בין 0 ל-10 (כולל) שמייצג את הניקוד של הביקורת. לדוגמה, "8.9".
<body> Optional string הטקסט של הביקורת. האלמנט הזה לא יכול להכיל HTML.
<date month="MM" day="DD" year="YYYY"/> Optional Object (ביקורות משתמשים בלבד) התאריך של הביקורת, שאתם מציינים באמצעות המאפיינים הבאים של הרכיב הזה:
  • ‫day: היום בחודש. לדוגמה, '7'.
  • ‫month: החודש, כאשר 1 = ינואר ... 12 = דצמבר.
  • ‫year: השנה בת 4 ספרות. לדוגמה,'2023'.

לדוגמה, התאריך 7 ביוני 2023 נכתב כך:

<date month="6" day="7" year="2023"/>
<servicedate month="MM" day="DD" year="YYYY"/> Optional Object (ביקורות משתמשים בלבד) התאריך שבו המבקר ביקר בדף העסק שמופיע בביקורת. הפורמט זהה לפורמט של <date>.

לדוגמה, התאריך 7 ביוני 2023 נכתב כך:

<servicedate month="6" day="7" year="2023"/>

יכול להיות שלא נציג ביקורות שלא צוינו בהן לפחות החודש והשנה של <servicedate>. לא חובה להזין יום.

דוגמה

בדוגמה הבאה מוצגת רשימה חלקית של מלונות עם כרטיס מוצר שמכיל ביקורת של עורך וביקורת של משתמש:

<?xml version="1.0" encoding="UTF-8"?>
<listings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:noNamespaceSchemaLocation="http://www.gstatic.com/localfeed/local_feed.xsd">
  <language>en</language>
  <listing>
    <id>123456</id>
    <name>My Apartment</name>
    <address format="simple">
      <component name="addr1">1 Sandstone Building</component>
      <component name="city">Los Angeles</component>
      <component name="postal_code">90210</component>
      <component name="province">CA</component>
    </address>
    <country>US</country>
    <latitude>40.730610</latitude>
    <longitude>-73.935242</longitude>
    <phone type="main">12345678</phone>
    <category>hotel</category> <!-- You can use whatever property type categories you wish -->
    <content>
      <text type="description">
        <link>https://examplelisting.com/listings/12345</link>
        <title>3 bedrooms with ocean views</title>
        <body>Stay in this newly renovated 3BR house with ocean views.</body>
        <date month="7" day="23" year="2023"/>
      </text>
      <review type="editorial">
        <link>https://example.com/reviews/42</link>
        <title>A little piece of heaven</title>
        <author>EXAMPLE.COM</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="2023"/>
        <servicedate day="16" month="6" year="2023"/>
      </review>
      <attributes>
        <website>https://hotel.example.com</website>
        <client_attr name="rating">8.2</client_attr>
        <client_attr name="num_reviews">14</client_attr>
      </attributes>
      <image type="photo" url="https://image_url">
        <link>https://image_url</link>
        <title>Main hotel picture</title>
      </image>
    </content>
  </listing>
  ...
</listings>

ערכים של ה-placeholder ‏attribute_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 הדירוג המקסימלי שאפשר לקבל על נכס. לדוגמה, אם הערך של rating_scale הוא 5, הערך של המאפיין rating צריך להיות 3 או 4.

הערה: אם לא מציינים את ערך ברירת המחדל של 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 במקום ב-2pm או ב-2:00pm. פורמטים אחרים לא ינותחו ולא יוצגו. Time
check_out_time Recommended השעה המדויקת ביום הצ'ק-אאוט מהמלון. הפורמטים הנתמכים הם HHMM,‏ HH:MM או HH:MM:SS. לדוגמה, צריך להשתמש ב-11:00 במקום ב-11am או ב-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 המדינה שבה נמצאת כרטיס המוצר. הערך חייב להיות קוד מדינה בן 2 אותיות לפי תקן 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

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

אפשרות אחרת היא לספק כתובת 'מורכבת'. משתמשים באלמנטים <component> child כדי לתאר כל אחד מהחלקים הבאים של הכתובת:

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