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

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

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

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

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

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

التوافق مع لغات متعددة

تتيح خلاصة "نقاط الاهتمام" توفير محتوى ملائم للغة المحلية لحقول معيّنة. الحقول التالية هي من النوع 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" }

التعريفات

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

نماذج