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

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

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

При создании и загрузке фидов объектов инфраструктуры следуйте этим инструкциям:

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

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

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

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

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

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

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

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

name
description
display_address

Чтобы предоставить контент на нескольких языках, укажите default_locale в поле и добавьте локализованные строки в список localizations. Укажите все локализации для объекта в одной записи POI. Не разделяйте один объект между несколькими 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		Региональные настройки, которые будут использоваться в качестве языка по умолчанию. Они должны быть указаны в локализациях.

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-звездочный отель". Значение должно быть целым числом от 1 до 5.
`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]. Пример. Открыто по субботам с 09: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 до 02:00 воскресенья: time_ranges { open_day: SATURDAY open_time: { hours: 21, minutes: 0 } close_day: SUNDAY close_time: { hours: 2, minutes: 0 } }

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

TimeRange

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

Название поля	Тип	Описание
`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`	Массив строк		Ограничивает доступ к этой странице для пользователей с указанными языковыми настройками. Должен содержать теги языка, например "ru", "ru-RU" или "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 Definition

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

Примеры