מאפיינים

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

המבנה הכללי של קובץ 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 המחבר של הביקורת. לדוגמה, Susan von Trapp. זה יכול להיות גם השם של אתר או פרסום שבהם הביקורת מופיעה, אם לא מצוין שם המבקר.
<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 מספר רישיון (תיירותי או עסקי) שחובה להציג בנכסים באזורים מסוימים בעולם. אפשר לחזור על הרישיון, ואם יש כמה רישיונות, מומלץ להוסיף את הרשות שהנפיקה את הרישיון כהקשר. לדוגמה: 'פריז: 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>

אפשר ליצור את הערך הזה באמצעות כלי המרת כתובות לקואורדינטות (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> 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>