На этой странице подробно описаны технические характеристики канала данных о точках интереса (POI). Здесь вы найдете краткое описание необходимых полей, исчерпывающие определения схемы и пример JSON-данных для руководства по внедрению.
Технические характеристики корма
В этом разделе описаны требования и определения для потока данных о точках интереса (POI).
Полевые требования
| Название поля | Требование | Описание |
|---|---|---|
| poi_id | Необходимый | Строка, сгенерированная партнером, которая идентифицирует интересующий объект (объект недвижимости). |
| имя | Необходимый | Название объекта POI. Это название будет использоваться в качестве отображаемого названия объекта в агрегаторном блоке. |
| телефон | Приятно иметь | Контактный телефонный номер объекта интереса, включая коды страны и региона, например, +14567891234. |
| url | Приятно иметь | URL общедоступного веб-сайта объекта интереса. Примечание: Этот адрес будет использоваться только для сопоставления, а не для отображения. |
| расположение | Обязательно (адрес) Приятно иметь (широта/долгота) | Местоположение объекта интереса. Обязательно: Адрес и сопутствующие поля будут обязательными для корректного сопоставления объекта недвижимости. Полезно иметь: широту и долготу. Если они указаны, Google будет использовать широту и долготу при отображении меток объектов недвижимости на карте агрегатора. |
| изображения | Обязательно (одно изображение) Желательно иметь (несколько) | Изображения объектов POI. Изображения будут важны для отображения объектов недвижимости. Мы настоятельно рекомендуем добавить как минимум одно изображение. Вы можете предоставить несколько изображений, максимум — 5. При предоставлении нескольких изображений они будут использоваться в порядке их предоставления (в случае, если какое-либо изображение окажется непригодным). Изображения будут проверены на соответствие правилам безопасного поиска Google. |
| рейтинг | Рекомендуется | Средняя оценка объекта недвижимости. |
| num_ratings | Рекомендуется | Количество оценок, предоставленных пользователем для rating поля. |
| рейтинговая_шкала | Приятно иметь | Шкала оценок, используемая для поля rating . Если максимальная оценка равна 5, то rating_scale равно 5. |
| категория | Приятно иметь | Обозначает категорию объекта недвижимости. |
| отель_данные | Приятно иметь | Поля, специфичные для отеля. Подробности см. в разделе «Определение HotelData» . |
| отель_звездный_класс | Рекомендуется | Официальное значение звездного рейтинга отеля. Ожидается, что это целое число от 0 до 5. Пожалуйста, укажите значение 0, если звездный рейтинг недоступен, неизвестен или не указан. Если установлено значение 0, звездный рейтинг отеля не будет отображаться в пользовательском интерфейсе. |
| бренд_идентификаторы | Приятно иметь | Список брендов, которые могут отображать этот отель. Если это поле пустое, отель может отображаться под любым из брендов, связанных с данной лентой. |
| описание | Приятно иметь | Подробное описание объекта недвижимости. |
| display_address | Приятно иметь | Адрес, отображаемый в пользовательском интерфейсе. |
Рекомендации по использованию изображений
Все изображения, добавляемые в ленту, должны соответствовать следующим правилам:
- Формат: Должен быть JPEG, PNG или WebP.
- Максимальный размер файла: менее 30 МБ на изображение.
- Максимальные размеры: менее 75 мегапикселей (ширина x высота < 75 000 000).
- Тип URL: Прямой путь к изображению (например, заканчивается на .jpg).
- Права доступа: Убедитесь, что хостинг-сервер разрешает доступ Googlebot или поисковым роботам и что файл robots.txt не блокирует каталоги с изображениями.
Многоязычная поддержка
Лента «Точки интереса» поддерживает предоставление локализованного контента для определенных полей. Следующие поля имеют Text тип и поддерживают локализацию:
-
name -
description -
display_address
Для предоставления контента на нескольких языках необходимо указать значение default_locale в соответствующем поле и предоставить локализованные строки в списке localizations . Укажите все локализации для объекта недвижимости в одной записи POI. Не разделяйте один объект недвижимости на несколько 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; }
Определение геокоординат
// 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; } }
Определение почтового адреса
// 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; // 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]; }
Образцы
Лента новостей о достопримечательностях
Имя файла: poi_1707240000.json
{ "data": [ { "poi_id": "hotel_banana", "name": { "localizations": [ { "locale": "en", "text": "Banana Hotel" } ], "default_locale": "en" }, "telephone": "+16195550100", "url": "https://www.example-banana-hotel.com", "location": { "latitude": 32.7157, "longitude": -117.1611, "address": { "country": "US", "locality": "San Diego", "region": "CA", "postal_code": "92101", "street_address": "2845 W 7th St" } }, "images": [ { "url": "https://www.example.com/banana_hotel.jpg", "alt_text": { "localizations": [ { "locale": "en", "text": "Banana Hotel Exterior" } ] } } ], "rating": 4.5, "category": "HOTEL", "hotel_data": { "hotel_star_class": 4, "brand_ids": ["brand_a", "brand_b"] } }, { "poi_id": "hotel_kiwi", "name": { "localizations": [ { "locale": "en", "text": "Kiwi Hotel" } ], "default_locale": "en" }, "telephone": "+41445550100", "url": "https://www.example-kiwi-hotel.com", "location": { "latitude": 47.3769, "longitude": 8.5417, "address": { "country": "CH", "locality": "Zurich", "postal_code": "8001", "street_address": "Bahnhofstrasse 10" } }, "images": [ { "url": "https://www.example.com/kiwi_hotel.jpg", "alt_text": { "localizations": [ { "locale": "en", "text": "Kiwi Hotel Lobby" } ] } } ], "rating": 4.0, "category": "HOTEL", "hotel_data": { "hotel_star_class": 3, "brand_ids": ["brand_c"] } }, { "poi_id": "hotel_croissant", "name": { "localizations": [ { "locale": "en", "text": "Croissant Hotel" } ], "default_locale": "en" }, "telephone": "+41445550200", "url": "https://www.example-croissant-hotel.com", "location": { "latitude": 47.3686, "longitude": 8.5392, "address": { "country": "CH", "locality": "Zurich", "postal_code": "8002", "street_address": "Paradeplatz 1" } }, "images": [ { "url": "https://www.example.com/croissant_hotel.jpg", "alt_text": { "localizations": [ { "locale": "en", "text": "Croissant Hotel View" } ] } } ], "rating": 5.0, "category": "HOTEL", "hotel_data": { "hotel_star_class": 5 } }, { "poi_id": "hotel_tiburon", "name": { "localizations": [ { "locale": "en", "text": "Hotel Tiburon" } ], "default_locale": "en" }, "telephone": "+15105550100", "url": "https://www.example-tiburon-hotel.com", "location": { "latitude": 37.7652, "longitude": -122.2416, "address": { "country": "US", "locality": "Alameda", "region": "CA", "postal_code": "94501", "street_address": "1100 Atlantic Ave" } }, "images": [ { "url": "https://www.example.com/tiburon_hotel.jpg", "alt_text": { "localizations": [ { "locale": "en", "text": "Hotel Tiburon Pool" } ] } } ], "rating": 4.2, "category": "HOTEL", "hotel_data": { "hotel_star_class": 5, "brand_ids": ["brand_a"] } } ] }
Многоязычная лента POI
Имя файла: poi_multilingual.json
{ "data": [ { "poi_id": "hotel_banana_multilingual", "name": { "localizations": [ { "locale": "en", "text": "Banana Hotel" }, { "locale": "es", "text": "Hotel Plátano" }, { "locale": "fr", "text": "Hôtel Banane" } ], "default_locale": "en" }, "description": { "localizations": [ { "locale": "en", "text": "A beautiful hotel shaped like a banana." }, { "locale": "es", "text": "Un hermoso hotel con forma de plátano." }, { "locale": "fr", "text": "Un bel hôtel en forme de banane." } ], "default_locale": "en" }, "display_address": { "localizations": [ { "locale": "en", "text": "123 Banana Way, Fruit City, CA 90000" }, { "locale": "es", "text": "123 Vía Plátano, Ciudad Fruta, CA 90000" } ], "default_locale": "en" }, "telephone": "+16195550100", "url": "https://www.example-banana-hotel.com", "location": { "latitude": 32.7157, "longitude": -117.1611, "address": { "country": "US", "locality": "Fruit City", "region": "CA", "postal_code": "90000", "street_address": "123 Banana Way" } }, "images": [ { "url": "https://www.example.com/banana_hotel.jpg", "alt_text": { "localizations": [ { "locale": "en", "text": "Banana Hotel Exterior" }, { "locale": "es", "text": "Exterior del Hotel Plátano" } ] } } ], "rating": 4.5, "category": "HOTEL", "hotel_data": { "hotel_star_class": 4, "brand_ids": ["brand_mango", "brand_apricot"] } } ] }