تستخدم 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	ما يُنصح به	قيمة النجوم الرسمية لفئة الفندق. من المتوقّع أن تكون هذه القيمة عددًا صحيحًا بين 0 و5. إذا كان نظامك يستخدم قيمًا بنصف نجمة أو قيمًا عشرية (مثل `3.5`)، عليك تقريبها إلى عدد صحيح (`3`). يُرجى تقديم القيمة 0 إذا كانت فئة النجوم غير متاحة أو غير معروفة أو غير محدّدة. عند ضبط القيمة على 0، لن يتم عرض أي فئة نجوم للفندق على واجهة المستخدم.
brand_ids	من المستحسن:	العلامات التجارية التي يمكنها عرض هذا الفندق إذا كان هذا الحقل فارغًا، يمكن عرض الفندق ضمن أي من العلامات التجارية المرتبطة بالخلاصة.
الوصف	من المستحسن:	تقدّم هذه السمة وصفًا تفصيليًا حول المكان المخصّص للاستئجار.
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 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 Definition

// 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 0 and 5. A rating of 0
  // should be used if a rating is unavailable or not specified. When
  // set to 0, no star class will be displayed on the UI for users.
  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];
}

نماذج