Чтобы переводить контент на ваш предпочитаемый язык, Google использует технологии на основе искусственного интеллекта. Переводы от ИИ могут содержать ошибки.

Фид объектов инфраструктуры

На этой странице приведены технические характеристики фида объектов инфраструктуры. В ней есть сводка обязательных полей, подробные определения схем и пример JSON, который поможет вам в реализации.

Спецификация фида

В этом разделе описаны требования к фиду объектов инфраструктуры и определения, которые в нем используются.

Требования к полям

Название поля	Требования	Описание
poi_id	Обязательно	Строка, созданная партнером и идентифицирующая объект инфраструктуры (недвижимость).
name	Обязательно	Название объекта инфраструктуры. Это название будет использоваться в качестве отображаемого названия ресурса в блоке агрегаторов.
телефон	Желательно:	Контактный номер телефона объекта инфраструктуры, включая коды страны и региона, например +14567891234.
url	Желательно:	URL общедоступного сайта объекта инфраструктуры. Примечание. Это значение будет использоваться только для сопоставления, а не для показа.
местоположение	Обязательно (адрес) Желательно (широта/долгота)	Местоположение объекта инфраструктуры. Обязательно: адрес и сопутствующие поля, необходимые для правильного сопоставления объекта. Желательно: широта и долгота. Если вы укажете эти данные, Google будет использовать их для отображения маркеров объектов на карте в блоке агрегаторов.
изображения	Обязательно (одно изображение) Желательно (несколько изображений)	Изображения объекта. Изображения играют важную роль в показе объектов недвижимости. Мы настоятельно рекомендуем добавить хотя бы одно изображение. Вы можете добавить до пяти изображений. Если вы добавите несколько изображений, они будут использоваться в том порядке, в котором вы их указали (на случай, если одно из них не подойдет). Изображения будут проверены на соответствие правилам Безопасного поиска.
оценка	Рекомендуется	Средняя оценка объекта.
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 мегапикселей (ширина x высота < 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;
  }

}

Text: определение

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

Примеры