تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.

خلاصة نقاط الاهتمام

توضّح هذه الصفحة المواصفات الفنية لخلاصة نقاط الاهتمام. وتتضمّن ملخّصًا للحقول المطلوبة وتعريفات شاملة للمخطّط ونموذج JSON للإرشاد في عملية التنفيذ.

مواصفات الخلاصة

يصف هذا القسم المتطلبات والتعريفات لخلاصة نقاط الاهتمام.

متطلبات الحقول

اسم الحقل	المتطلبات	الوصف
poi_id	مطلوب	سلسلة ينشئها الشريك وتحدّد نقطة اهتمام (موقعًا)
الاسم	مطلوب	اسم نقطة الاهتمام سيتم استخدام هذا الاسم كاسم العرض للموقع في "وحدة التجميع".
هاتف	من المستحسن:	رقم هاتف التواصل مع نقطة الاهتمام، بما في ذلك رموز البلد والمنطقة، مثلاً ‎+14567891234
`url`	من المستحسن:	عنوان URL للموقع الإلكتروني العلني لنقطة الاهتمام ملاحظة: سيتم استخدام هذا العنوان لأغراض المطابقة فقط، وليس للعرض.
الموقع	مطلوب (العنوان) من المستحسن: (خط الطول/خط العرض)	موقع نقطة الاهتمام. مطلوب: يجب إدخال العنوان والحقول المصاحبة لمطابقة الموقع بشكل صحيح. من المستحسن: خط الطول وخط العرض. إذا تم توفير خط الطول وخط العرض، ستستخدمهما Google لعرض دبابيس المواقع في خريطة "وحدة التجميع".
صور	يُنصح بشدة بإضافة صورة واحدة من المستحسن: (صور متعدّدة)	صور نقطة الاهتمام ستكون الصور مهمة في عرض المواقع. ننصحك بشدة بإضافة صورة واحدة على الأقل. يمكنك تقديم صور متعدّدة يصل عددها إلى 5 كحد أقصى. عند تقديم صور متعدّدة، سيتم استخدامها بالترتيب الذي تم تقديمها به (في حال تعذّر استخدام إحدى الصور). ستتم مراجعة الصور للتأكّد من أنّها لا تنتهك سياسات البحث الآمن من Google.
rating	من المستحسن:	متوسط تقييم الموقع
num_ratings	من المستحسن:	عدد التقييمات المساهمة في حقل `rating`
rating_scale	من المستحسن:	مقياس التقييم المستخدَم لحقل `rating` إذا كان الحد الأقصى للتقييم هو 5، تكون قيمة `rating_scale` هي 5.
category	من المستحسن:	فئة الموقع
hotel_data	من المستحسن:	حقول خاصة بالفنادق راجِع تعريف HotelData للحصول على التفاصيل.
hotel_star_class	من المستحسن:	القيمة الرسمية لنجوم فئة الفندق يُتوقَّع أن تكون هذه القيمة عددًا صحيحًا بين 1 و5.
brand_ids	من المستحسن:	العلامات التجارية التي يمكنها عرض هذا الفندق إذا كان هذا الحقل فارغًا، يمكن عرض الفندق ضمن أي من العلامات التجارية المرتبطة بالخلاصة.
description	من المستحسن:	وصف مفصّل للموقع
display_address	من المستحسن:	العنوان المعروض على واجهة المستخدِم

إرشادات الصور

يجب أن تلتزم جميع الصور المضافة إلى الخلاصة بهذه الإرشادات:

التنسيق: يجب أن يكون JPEG أو PNG أو WebP.
الحد الأقصى لحجم الملف: أقل من 30 ميغابايت لكل صورة
الحد الأقصى للأبعاد: أقل من 75 ميغابكسل إجمالاً (العرض × الارتفاع < 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

// 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];
}

نماذج