تستخدم 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).
الأذونات: تأكَّد من أنّ خادم الاستضافة وملف robots.txt يسمحان بالوصول إلى وكيلَي المستخدم Googlebot و Googlebot-Image ولا يحظران أدلة الصور.

دعم لغات متعددة

تتيح خلاصة "نقطة الاهتمام" تقديم محتوى مترجَم لحقول معيّنة. الحقول التالية هي من النوع 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 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;

  // Deprecated. Use `brand_landing_pages` instead.
  //
  // 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, deprecated = true];

  // The brand landing pages.
  repeated BrandLandingPages brand_landing_pages = 3;
}

نماذج