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

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

Как создать и загрузить фид объектов инфраструктуры

При создании и загрузке фидов POI следуйте инструкциям ниже.

Для файлов с данными об объектах инфраструктуры следуйте спецификации, описанной в статье Фид объектов инфраструктуры. Рекомендуем использовать уникальные названия файлов данных POI для каждой загрузки. Включите в название файла временную метку, например POI_1633621547.json.
Загружайте фиды на локальный SFTP-сервер POI ежедневно, полностью обновляя их.
Сведения о сервере SFTP можно найти в разделе Конфигурация > Фиды на Партнерском портале.

Выбор серверов фидов

Статус загрузки фида можно посмотреть в разделе Загрузка > История на Партнерском портале.

Требования к упаковке файлов

Чтобы загрузка прошла успешно, соблюдайте следующие требования к упаковке:

Единый агрегированный архив JSON (обязательно). Объедините все записи об объектах в один файл JSON. Рекомендуем сжать его в один архив GZIP и загрузить.
Предупреждение о нарушении шаблона. Не используйте один файл для каждой организации или несколько файлов, разделенных по странам, в одном архиве. Такой подход не поддерживается и приведет к ошибкам извлечения.

Поддержка нескольких языков

Фид объектов интереса поддерживает локализованный контент для определенных полей. Следующие поля имеют тип Text и поддерживают локализацию:

name
description
display_address

Чтобы предоставить контент на нескольких языках, укажите default_locale в поле и добавьте локализованные строки в список localizations. Укажите все локализации объекта в одной записи об объекте инфраструктуры. Не разделяйте один объект между несколькими JSON-файлами на разных языках.

Пример:

"name": {
  "localizations": [
    {
      "locale": "en",
      "text": "Tasty Bites Test Restaurant"
    },
    {
      "locale": "es",
      "text": "Restaurante de prueba Tasty Bites"
    }
  ],
  "default_locale": "en"
}

Требования к изображениям

Формат: JPEG, PNG или WebP.
Максимальный размер файла: до 30 МБ на изображение.
Максимальные размеры: менее 75 мегапикселей (ширина x высота < 75 000 000).
Тип URL: прямой путь к объекту изображения (например, заканчивается на .jpg).
Разрешения. Убедитесь, что хостинг-сервер разрешает доступ к Googlebot или поисковым роботам и что в файле robots.txt нет блокировки каталогов изображений.
Безопасный поиск. Изображения должны соответствовать правилам Безопасного поиска.

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

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

VssPoi

Представляет один объект инфраструктуры, например гостиницу или ресторан.

Название поля	Тип	Требования	Описание
`poi_id`	string	Обязательно	Обязательно. Строка, созданная партнером и идентифицирующая объект инфраструктуры.
`name`	object `(Text)`	Обязательно	Обязательно. Название достопримечательности.
`telephone`	string		Контактный номер телефона POI, включая код страны и код региона, например +14567891234.
`url`	string		URL общедоступного сайта объекта инфраструктуры. Примечание. Это значение будет использоваться только для сопоставления, а не для показа.
`location`	object `(GeoCoordinates)`	Обязательно	Обязательно. Местоположение объекта.
`display_address`	object `(Text)`		Адрес, который показывается в интерфейсе.
`images`	Массив объектов `(Image)`		Изображения объекта. Максимальное количество изображений – 5.
`rating`	число		Средняя оценка POI.
`num_ratings`	число		Количество оценок, на основе которых рассчитывается значение поля `rating`.
`rating_scale`	число		Оценочная шкала, используемая для поля `rating`. Если максимальная оценка равна 5, то rating_scale также будет равен 5.
`category`	enum `(Category)`	Обязательно	Обязательно. Категория объекта.
`description`	object `(Text)`		Описание достопримечательности.
	oneOf `(additional_data)`	Обязательно	Можно задать только одно из полей в этом разделе.

Текст

Представляет текст с локализациями.

Название поля	Тип	Требования	Описание
`localizations`	Массив объектов `(LocalizedString)`		Локализованные строки.
`default_locale`	string		Локаль, которая будет использоваться в качестве языка по умолчанию, должна быть указана в разделе localizations.

LocalizedString

Представляет локализованную строку.

Название поля	Тип	Требования	Описание
`locale`	string		Тег языка текста, например "ru", "ru-RU" или "sr-Latn".
`text`	string		Текст на указанном языке.

GeoCoordinates

Геоданные места, в том числе широта, долгота и адрес.

Название поля	Тип	Требования	Описание
`latitude`	число		[-90, +90] градусов (включительно). Обязательно, если задана долгота. В остальных случаях желательно.
`longitude`	число		[-180, +180] градусов (включительно). Обязательно, если задана широта. В остальных случаях рекомендуется.
	oneOf `(addresses)`	Обязательно	Можно задать только одно из полей в этом oneOf.

PostalAddress

Почтовый адрес местоположения.

Название поля	Тип	Требования	Описание
`country`	string	Обязательно	Обязательно. Страна, указанная с помощью кода ISO 3166-1 alpha-2, например "US".
`locality`	string	Обязательно	Обязательно. Населенный пункт, например "Маунтин-Вью".
`region`	string		Регион, область или штат, например "CA". Это поле обязательно только в тех странах, где регион обычно указывается в адресе. (необязательно)
`postal_code`	string	Обязательно	Обязательно. Почтовый индекс: "94043"
`street_address`	string	Обязательно	Обязательно. Почтовый адрес, например "Амфитеатр Парквей, 1600"

Изображение

Изображение объекта инфраструктуры.

Название поля	Тип	Требования	Описание
`url`	string		URL изображения. Google просканирует медиаконтент, размещенный по этому URL. Максимальная длина: 2000 символов.
`alt_text`	object `(Text)`		Альтернативный текст для специальных возможностей.

HotelData

Данные фида для гостиниц.

Название поля	Тип	Требования	Описание
`hotel_star_class`	число		Официальная категория отеля (количество звезд). Можно использовать в ярлыке, например "5-звездочный отель". Значение должно быть целым числом от 0 до 5. Если оценка недоступна или не указана, используйте значение 0. Если задано значение 0, в интерфейсе не будет показываться класс звезды.
`brand_ids`	Массив строк		Бренды, которые могут показывать эту гостиницу. Если поле пустое, отель может показываться под любым брендом, связанным с фидом.

LocalData

Данные фида, относящиеся к заведению.

Название поля	Тип	Требования	Описание
`business_hours`	object `(BusinessHours)`		Обычные часы работы заведения.
`price_range`	object `(PriceRange)`		Диапазон цен на услуги, предлагаемые в заведении.
`establishment_category`	object `(Text)`		Тип заведения.
`brand_landing_pages`	Массив объектов `(BrandLandingPages)`	Обязательно	Обязательно. Целевые страницы бренда. Необходимо указать хотя бы один.

BusinessHours

Периоды времени, в которые компания открыта для клиентов. Содержит коллекцию экземпляров [TimeRange][madden.vss_poi_feed.TimeRange]. Пример: компания работает по субботам с 9:00 до 12:00 и с 13:00 до 17:00: time_ranges { open_day: SATURDAY open_time: { hours: 9, minutes: 0 } close_day: SATURDAY close_time: { hours: 12, minutes: 0 } } time_rages { open_day: SATURDAY open_time: { hours: 13, minutes: 0 } close_day: SATURDAY close_time: { hours: 17, minutes: 0 } } Пример: компания работает по субботам с 21:00 до 2:00 воскресенья: time_ranges { open_day: SATURDAY open_time: { hours: 21, minutes: 0 } close_day: SUNDAY close_time: { hours: 2, minutes: 0 } }

Название поля	Тип	Требования	Описание
`time_ranges`	Массив объектов `(TimeRange)`		Часы работы объекта инфраструктуры. Каждый период представляет собой диапазон часов, когда POI открыт в течение недели.

TimeRange

Представляет собой период времени, в течение которого объект инфраструктуры открыт, начиная с указанного дня/времени открытия и заканчивая указанным днем/временем закрытия. Время закрытия должно быть позже времени открытия, например в тот же день или на следующий.

Название поля	Тип	Описание
`open_day`	enum `(DayOfWeek)`	День начала диапазона дат.
`open_time`	object `(TimeOfDay)`	Время открытия в диапазоне времени.
`close_day`	enum `(DayOfWeek)`	Последний день диапазона дат.
`close_time`	object `(TimeOfDay)`	Время закрытия.

TimeOfDay

Название поля	Тип	Описание
`hours`	число	Часы в 24-часовом формате. Значение должно быть больше или равно 0 и обычно меньше или равно 23. В API допустимо значение "24:00:00" для таких сценариев, как время закрытия компании.
`minutes`	число	Минуты часа. Значение должно быть больше или равно 0 и меньше или равно 59.
`seconds`	число	Секунды. Значение должно быть больше или равно 0 и обычно меньше или равно 59. В API допустимо значение "60", если разрешены високосные секунды.
`nanos`	число	Доли секунды в наносекундах. Значение должно быть больше или равно 0 и меньше или равно 999 999 999.

PriceRange

Диапазон цен на услуги, предлагаемые объектом инфраструктуры.

Название поля	Тип	Требования	Описание
`min_price`	object `(Money)`		Минимальная цена услуг, предлагаемых объектом инфраструктуры.
`max_price`	object `(Money)`		Максимальная цена услуг, предлагаемых в объекте.

Деньги

Представляет сумму денег с указанием типа валюты.

Название поля	Тип	Описание
`currency_code`	string	Трехбуквенный код валюты по стандарту ISO 4217.
`units`	число	Целые единицы суммы. Например, если `currencyCode` – это `"USD"`, то одна единица равна одному доллару США.
`nanos`	число	Количество наноединиц (10^-9) суммы. Значение должно быть в диапазоне от -999 999 999 до +999 999 999 включительно. Если значение `units` положительное, то значение `nanos` должно быть положительным или нулевым. Если значение `units` нулевое, то значение `nanos` может быть положительным, отрицательным или нулевым. Если значение `units` отрицательное, то значение `nanos` должно быть отрицательным или нулевым. Например, -1,75 доллара США будет представлено как `units`=-1 и `nanos`=-750 000 000.

BrandLandingPages

Локализованные целевые страницы бренда для одного объекта инфраструктуры.

Название поля	Тип	Требования	Описание
`brand_id`	string	Обязательно	Обязательно. Бренд, к которому применяется эта конфигурация.
`localized_landing_pages`	Массив объектов `(LocalizedLandingPage)`		Локализованные целевые страницы. Значения полей url и locales должны быть уникальными для всех локализованных целевых страниц.
`default_url`	string	Обязательно	Обязательно. URL целевой страницы по умолчанию, который будет использоваться, если ни одна из локализованных целевых страниц не соответствует языку пользователя.

LocalizedLandingPage

Локализованная целевая страница для объекта инфраструктуры.

Название поля	Тип	Требования	Описание
`url`	string		URL целевой страницы. Максимальная длина: 2000 символов.
`locales`	массив строк;		Ограничивает доступ к этой странице для пользователей с указанными языковыми настройками. Должен содержать теги языка, например "en", "en-US" или "sr-Latn".

Категория

Категория объекта. Оно должно совпадать с полем additional_data, указанным ниже.

Название	Описание
`UNKNOWN_CATEGORY`
`HOTEL`
`LOCAL`

День недели

Представляет день недели.

Название	Описание
`DAY_OF_WEEK_UNSPECIFIED`	День недели не указан.
`MONDAY`	Понедельник
`TUESDAY`	Tuesday (вторник)
`WEDNESDAY`	Wednesday (среда)
`THURSDAY`	Thursday (четверг)
`FRIDAY`	Friday (пятница)
`SATURDAY`	Saturday (суббота)
`SUNDAY`	Воскресенье

additional_data

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

Название поля	Тип	Требования	Описание
`hotel_data`	object `(HotelData)`	Несовместимо с `local_data`	Поля, относящиеся к гостиницам.
`local_data`	object `(LocalData)`	Несовместимо с `hotel_data`	Поля, относящиеся к определенной стране.

адреса

Обязательно. Адрес местоположения.

Название поля	Тип	Требования	Описание
`address`	object `(PostalAddress)`		Почтовый адрес местоположения.

Определения

Определение 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 {


    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 {


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

Определение LocalData

// Establishment specific feed data.
message LocalData {
  // The regular business hours of the establishment.
  BusinessHours business_hours = 1;

  // Price range of the services offered by the establishment.
  PriceRange price_range = 2;

  // The type of establishment.
  Text establishment_category = 3;

  // Required. The brand landing pages. At least one must be provided.
  repeated BrandLandingPages brand_landing_pages = 4;
}

Определение BrandLandingPages

// The Localized brand landing pages for a single Point of Interest (POI).
message BrandLandingPages {
  // Required. The brand this configuration applies to.
  string brand_id = 1 [(datapol.semantic_type) = ST_PARTNER_ID];

  // Localized landing page for the Point of Interest (POI).
  message LocalizedLandingPage {

    // The url of the landing page.
    // Max length: 2000.
    string url = 1;

    // Restricts this page to users with the specified language preference.
    // Must contain language tags, such as "en", "en-US" or "sr-Latn".
    repeated string locales = 3;
  }

  // The localized landing pages.
  // The url and locales fields values must be unique across all the localized
  // landing pages.
  repeated LocalizedLandingPage localized_landing_pages = 2;

  // Required. The default landing page url to be used when none of the
  // localized landing pages matches the user's language.
  string default_url = 3;
}

Примеры