מאפיינים

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

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

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

  • רכיבי צאצא נדרשים של XML: id, name, latitude, longitude, address.
  • מאפיינים נדרשים: capacity וגם website.

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

למידע נוסף על יחידות אירוח, קראו את המאמר מאפיינים ייחודיים ליחידות אירוח.

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

ערכי ה-placeholder של מאפיין שם המאפיין

בטבלה הבאה ריכזנו רשימה של הערכים החוקיים של 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 מספר נקודה צפה (floating-point) שמייצג את הדירוג המצטבר של הנכס. המספר הוא בדרך כלל בין 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 במקום בשעה 14:00 או 14:00. כל הפורמטים האחרים לא ינותחו ולא יוצגו. Time
check_out_time Recommended השעה המדויקת ביום של הצ'ק אאוט מהנכס. המערכת מקבלת את הפורמטים HHMM, HH:MM או HH:MM:SS. לדוגמה, אפשר להשתמש ב-11:00 במקום ב-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
minimum_days_advance_purchase Recommended המספר המינימלי של ימים מראש שאפשר להזמין את הנכס. Non-negative integer value
minimum_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 המדינה שבה נמצא הדף העסקי. הערך צריך להיות קוד מדינה בן 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 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="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="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="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="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="smoking_free_property">Yes</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>