‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

עדכון נקודות עניין (POI)

בדף הזה מפורטות המפרטים הטכניים של פיד נקודות העניין (POI). הוא כולל סיכום של שדות החובה, הגדרות מקיפות של הסכימה ודוגמה ל-JSON שתעזור לכם בהטמעה.

מפרט הפיד

בקטע הזה מוסבר על הדרישות וההגדרות של פיד נקודות העניין.

דרישות לגבי השדות

שם השדה	דרישה	תיאור
poi_id	חובה	מחרוזת שנוצרת על ידי השותף ומזהה נקודת עניין (מאפיין).
שם	חובה	שם נקודת העניין. השם הזה ישמש כשם המוצג של הנכס ביחידת האגרגטור.
טלפון	מומלץ	מספר הטלפון של נקודת העניין, כולל קידומת המדינה וקידומת האזור, למשל ‎+14567891234.
`url`	מומלץ	כתובת ה-URL של האתר הציבורי של הנקודה. הערה: הנתונים האלה ישמשו רק למטרות התאמה, ולא יוצגו.
location	חובה (כתובת) מומלץ (קו רוחב/אורך)	המיקום של נקודת העניין. חובה: צריך לציין את הכתובת ואת השדות הנלווים כדי להתאים את הנכס בצורה נכונה. מומלץ: לציין את קו הרוחב וקו האורך. אם תספקו את נתוני קווי הרוחב והאורך, Google תשתמש בהם כדי להציג את סיכות הנכסים במפה של יחידת הצבירה.
תמונות	מומלץ מאוד (תמונה אחת) כדאי להוסיף (כמה תמונות)	תמונות של נקודת העניין. תמונות הן רכיב חשוב בתצוגת הנכסים. מומלץ מאוד להוסיף לפחות תמונה אחת. אפשר לספק עד 5 תמונות. אם מספקים כמה תמונות, המערכת תשתמש בהן לפי הסדר שבו הן סופקו (במקרה שתמונה מסוימת לא ניתנת לשימוש). התמונות ייבדקו כדי לוודא שהן לא מפירות את כללי המדיניות של Google בנושא חיפוש בטוח.
סיווג	מומלץ	הדירוג הממוצע של הנכס.
num_ratings	מומלץ	מספר הדירוגים שתרמו לערך בשדה `rating`.
rating_scale	מומלץ	סולם הדירוג שמשמש בשדה `rating`. אם הדירוג המקסימלי הוא 5, אז הערך של מאפיין סולם הדירוג (rating_scale) הוא 5.
קטגוריה	מומלץ	מייצג את קטגוריית הנכס.
hotel_data	מומלץ	שדות ספציפיים למלון. פרטים נוספים זמינים במאמר הגדרת נתוני מלונות.
hotel_star_class	מומלץ	דירוג הכוכבים הרשמי של המלון. הערך צריך להיות מספר שלם בין 1 ל-5.
brand_ids	מומלץ	המותגים שיכולים להציג את המלון הזה. אם השדה הזה ריק, המלון יכול להופיע בכל אחד מהמותגים שמשויכים לפיד.
תיאור	מומלץ	תיאור מפורט של הנכס.
display_address	מומלץ	הכתובת שמוצגת בממשק המשתמש.

הנחיות לגבי תמונות

כל התמונות שמוסיפים לפיד צריכות לעמוד בהנחיות הבאות:

פורמט: JPEG,‏ PNG או WebP.
גודל קובץ מקסימלי: עד 30MB לכל תמונה.
מידות מקסימליות: פחות מ-75 מגה-פיקסל בסך הכול (רוחב x גובה < 75,000,000).
סוג כתובת ה-URL: נתיב ישיר לנכס התמונה (למשל, מסתיים ב-‎.jpg).
הרשאות: מוודאים ששרת האירוח מאפשר גישה ל-Googlebot או לסורקים, ואין קובץ robots.txt שחוסם את ספריות התמונות.

תמיכה בשפות רבות

פיד הנקודות המעניינות תומך באספקת תוכן מותאם לשוק המקומי בשדות ספציפיים. השדות הבאים הם מסוג Text ויש בהם תמיכה בלוקליזציה:

name
description
display_address

כדי לספק תוכן בכמה שפות, צריך לציין default_locale בשדה ולספק את המחרוזות המותאמות לשוק המקומי ברשימה localizations. צריך לספק את כל הלוקליזציות של נכס בערך אחד של נקודת עניין. אל תחלקו מאפיין יחיד בין כמה קובצי JSON בשפות שונות.

דוגמה:

"name": {
  "localizations": [
    {
      "locale": "en",
      "text": "Banana Hotel"
    },
    {
      "locale": "es",
      "text": "Hotel Plátano"
    }
  ],
  "default_locale": "en"
}

הנחיות לאריזת קבצים

כדי שההעלאה תתבצע בהצלחה, צריך לפעול לפי דרישות האריזה הבאות:

ארכיון JSON מצטבר יחיד (חובה): צריך לשלב את כל הרשומות של הנכסים בקובץ JSON יחיד. מומלץ לדחוס אותו לארכיון GZIP אחד ולהעלות אותו.
אזהרה לגבי דפוסים לא מומלצים: אל תשתמשו בקובץ אחד לכל נכס או בכמה קבצים שמופרדים לפי מדינה באותו ארכיון. הגישה הזו לא נתמכת ותגרום לכשלים בחילוץ.

הגדרות

VssPoiFeed Definition

// Represents a Point of Interest (POI) data feed provided by a partner.
export message VssPoiFeed {
  // The POIs in the feed.
  repeated VssPoi data = 1;
}

הגדרה של VssPoi

// Represents a single Point of Interest (POI) entity e.g. a hotel or
// restaurant.
export message VssPoi {
  // Required. A string generated by the partner that identifies a POI.
  string poi_id = 1;

  // The entity name, telephone, url and location are used to support
  // matching partner inventory with entities already present on Google.

  // Required. The name of the POI.
  Text name = 2;

  // The contact telephone number of the POI including its country and
  // area codes, e.g. +14567891234.
  string telephone = 3 [(datapol.semantic_type) = ST_PHONE_NUMBER];

  // The url of the POI's public website.
  // Note: This will be used just for matching purposes, not for display.
  string url = 4;

  // Required. The location of the POI.
  GeoCoordinates location = 5;

  // The address displayed on the UI.
  Text display_address = 17;

  // Images of the POI.
  // Max number of images: 5.
  repeated Image images = 6;

  // Average rating for the POI.
  float rating = 12;

  // The number of contributing ratings for the `rating` field.
  int64 num_ratings = 13;

  // The rating scale used for the `rating` field. If max rating is 5, then
  // rating_scale is 5.
  int32 rating_scale = 14;

  // Represents the category of the POI.
  // It should match the `additional_data` oneof field below.
  export enum Category {

    UNKNOWN_CATEGORY = 0;
    HOTEL = 1;

    LOCAL = 4;
  }

  // Required. Represents the category of the POI.
  Category category = 9;

  // A description of the POI.
  Text description = 16;

  // Required. Category specific fields.
  // It should match the `category` field above.
  oneof additional_data {
    // Hotel specific fields.
    HotelData hotel_data = 10;


    // Local specific fields.
    LocalData local_data = 15;
  }

}

הגדרת טקסט

// Represents a text with localizations.
message Text {
  // Represents a localized string.
  message LocalizedString {
    // The text's language tag, such as "en", "en-US" or "sr-Latn".
    string locale = 1;

    // The text in the specified locale.
    string text = 2;
  }

  // The localized strings.
  repeated LocalizedString localizations = 1;

  // The locale to use as the default language it must be present in the
  // localizations.
  string default_locale = 2;
}

הגדרה של GeoCoordinates

// The Geo data of a location, including latitude, longitude, and address.
message GeoCoordinates {
  option (datapol.msg_semantic_type) = ST_LOCATION;

  // [-90, +90] degrees (inclusive).
  // Required if longitude is set, otherwise nice to have.
  double latitude = 1;

  // [-180, +180] degrees (inclusive).
  // Required if latitude is set, otherwise nice to have.
  double longitude = 2;

  // Required. Address for a location.
  oneof addresses {
    // Postal address of the location.
    PostalAddress address = 3;

  }
}

הגדרה של PostalAddress

// The postal address for the location.
message PostalAddress {
  option (datapol.msg_semantic_type) = ST_LOCATION;

  // Required. The country, using ISO 3166-1 alpha-2 country code, e.g. "US".
  string country = 1;

  // Required. The locality/city, e.g. "Mountain View".
  string locality = 2;

  // The region/state/province, e.g. "CA". This field is only required in
  // countries where region is commonly a part of the address. (optional)
  string region = 3;

  // Required. The postal code, e.g. "94043".
  string postal_code = 4;

  // Required. The street address, e.g. "1600 Amphitheatre Pkwy".
  string street_address = 5;
}

הגדרת התמונה

// Represents an image of the Point of Interest (POI).
export message Image {
  // The url of the image. Google will crawl the media hosted at this URL.
  // Max length: 2000.
  string url = 1;

  // The alternative text to be used for accessibility.
  Text alt_text = 2;
}

הגדרה של HotelData

// Hotel specific feed data.
message HotelData {
  // The official hotel class star value.
  // Can be used in a label like "5-star hotel."
  // This value is expected to be an integer between 1 and 5.
  int32 hotel_star_class = 1;

  // The brands that can display this hotel.
  // If this field is empty, the hotel can be displayed under any of the
  // brands associated with the feed.
  repeated string brand_ids = 2 [(datapol.semantic_type) = ST_PARTNER_ID];
}

דוגמאות