Bu sayfada, önemli yer (ÖY) feed'inin teknik özellikleri ayrıntılı olarak açıklanmaktadır. Bu dokümanda, zorunlu alanların özeti, kapsamlı şema tanımları ve uygulamaya rehberlik edecek bir JSON örneği yer alır.
Feed Spesifikasyonları
Bu bölümde, ÖY feed'iyle ilgili koşullar ve tanımlar açıklanmaktadır.
Alan koşulları
| Alan Adı | Gereksinim | Açıklama |
|---|---|---|
| poi_id | Zorunlu | İş ortağı tarafından oluşturulan ve ilgi çekici bir noktayı (tesis) tanımlayan dize. |
| ad | Zorunlu | ÖY'nin adı. Bu ad, toplayıcı biriminde tesisin görünen adı olarak kullanılır. |
| telephone | Şunun faydası olabilir: | ÖY'nin ülke ve alan kodları dahil olmak üzere iletişim telefon numarası (ör. +14567891234). |
url |
Şunun faydası olabilir: | ÖY'nin herkese açık web sitesinin URL'si. Not: Bu yalnızca eşleştirme amacıyla kullanılır, görüntüleme amacıyla kullanılmaz. |
| konum | Zorunlu (Adres) Faydalı (Enlem/Boylam) |
ÖY'nin konumu. Zorunlu: Tesisin doğru şekilde eşleştirilmesi için adres ve beraberindeki alanlar gereklidir. Faydalı: Enlem ve boylam. Sağlanması durumunda Google, toplayıcı birimi haritanızdaki tesis pinlerinin gösteriminde enlem/boylam bilgilerini kullanır. |
| çekilen resim sayısı | Önemle tavsiye edilir (bir resim) Faydalı (birden fazla) |
ÖY'nin resimleri. Resimler, mülklerin gösterilmesinde önemli bir rol oynar. En az 1 resim eklemenizi önemle tavsiye ederiz. En fazla 5 resim sağlayabilirsiniz. Birden fazla resim sağlandığında, kullanılamayan bir resim olması durumunda sağlanan sırayla kullanılır. Resimlerin Google'ın güvenli arama politikalarını ihlal etmediğinden emin olmak için inceleme yapılır. |
| derecelendirme | Şunun faydası olabilir: | Tesisin ortalama puanı. |
| num_ratings | Şunun faydası olabilir: | rating alanı için katkıda bulunan puan sayısı. |
| rating_scale | Şunun faydası olabilir: | rating alanı için kullanılan derecelendirme ölçeği. Maksimum puan 5 ise rating_scale 5 olur. |
| category | Şunun faydası olabilir: | Tesisin kategorisini gösterir. |
| hotel_data | Şunun faydası olabilir: | Otele özgü alanlar. Ayrıntılar için HotelData Tanımı başlıklı makaleyi inceleyin. |
| hotel_star_class | Şunun faydası olabilir: | Resmi otel sınıfı yıldız değeri. Bu değerin 1 ile 5 arasında bir tam sayı olması beklenir. |
| brand_ids | Şunun faydası olabilir: | Bu oteli gösterebilecek markalar. Bu alan boşsa otel, feed ile ilişkili markaların herhangi birinin altında gösterilebilir. |
| açıklama | Şunun faydası olabilir: | Tesisin ayrıntılı açıklaması. |
| display_address | Şunun faydası olabilir: | Kullanıcı arayüzünde gösterilen adres. |
Resim Kuralları
Feed'e eklenen tüm resimler aşağıdaki yönergelere uygun olmalıdır:
- Biçim: JPEG, PNG veya WebP olmalıdır.
- Maksimum dosya boyutu: Resim başına 30 MB'tan az.
- Maksimum boyutlar: Toplamda 75 megapikselden az (genişlik x yükseklik < 75.000.000).
- URL Türü: Resim öğesine doğrudan giden yol (ör. .jpg ile biter).
- İzinler: Barındırma sunucusunun Googlebot veya tarayıcılara erişime izin verdiğinden ve resim dizinlerini engelleyen bir robots.txt dosyası olmadığından emin olun.
Çok Dilli Destek
Önemli yer feed'i, belirli alanlar için yerelleştirilmiş içerik sağlamayı destekler. Aşağıdaki alanlar Text türündedir ve yerelleştirmeyi destekler:
namedescriptiondisplay_address
İçeriği birden fazla dilde sunmak için default_locale alanında bir dil belirtmeniz ve localizations listesinde yerelleştirilmiş dizeleri sağlamanız gerekir.
Bir mülkle ilgili tüm yerelleştirmeleri tek bir ÖY girişinde sağlayın. Tek bir özelliği birden fazla dil JSON dosyasına bölmeyin.
Örnek:
"name": {
"localizations": [
{
"locale": "en",
"text": "Banana Hotel"
},
{
"locale": "es",
"text": "Hotel Plátano"
}
],
"default_locale": "en"
}
Dosya Paketleme Kuralları
Başarılı bir besleme için aşağıdaki paketleme koşullarına uyun:
- Tek Toplu JSON Arşivi (Zorunlu): Tüm mülk kayıtlarını tek bir JSON dosyasında birleştirin. Dosyayı tek bir GZIP arşivine sıkıştırıp yüklemenizi öneririz.
- Anti-Pattern Uyarısı: Her mülk için bir dosya veya aynı arşivde ülke bazında ayrılmış birden fazla dosya kullanmayın. Bu yaklaşım desteklenmez ve ayıklama hatalarına neden olur.
Tanımlar
VssPoiFeed Tanımı
// 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 Definition
// 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; } }
Metin tanımı
// 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 Tanımı
// 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 Tanımı
// 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; }
Resim Tanımı
// 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 Tanımı
// 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 1 and 5. 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]; }
Örnekler
Önemli Yer Feed'i
Dosya adı: 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"] } } ] }
Çok dilli ÖY feed'i
Dosya adı: 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"] } } ] }