Önemli yer (ÖY) feed'i

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 yardımcı olacak 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 Şartları

Alan Adı Gereksinim Açıklama
poi_id Zorunlu İş ortağı tarafından oluşturulan ve önemli yerleri (tesis) tanımlayan bir dize.
ad Zorunlu ÖY'nin adı. Bu ad, toplayıcı birimindeki mülkün 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 bilgi yalnızca eşleştirme amacıyla kullanılacak olup gösterilmeyecektir.
konum Zorunlu (Adres)
İsteğe bağlı (Enlem/Boylam)		 ÖY'nin konumu.
Zorunlu: Tesisin doğru şekilde eşleştirilmesi için adres ve ilgili alanlar zorunludur.
İsteğe bağlı: Enlem ve boylam. Sağlanırsa Google, Toplayıcı Birimi haritanızdaki tesis raptiyelerinin gösteriminde enlem/boylamı kullanır.
çekilen resim sayısı Zorunlu (Bir resim)
İsteğe bağlı (Birden fazla)		 ÖY'nin resimleri. Resimler, tesislerin gösteriminde önemli bir rol oynar. En az 1 resim eklemenizi önemle tavsiye ederiz. En fazla 5 resim sağlayabilirsiniz. Birden fazla resim sağlandığında, bunlar sağlandıkları sırayla kullanılır (bir resmin kullanılamaması durumunda).

Görseller, Google'ın güvenli arama politikalarını ihlal etmediğinden emin olmak için incelenir.
derecelendirme Önerilen Tesisin ortalama puanı.
num_ratings Önerilen rating alanı için katkıda bulunan puanların sayısı.
rating_scale Şunun faydası olabilir: rating alanı için kullanılan derecelendirme ölçeği. Maksimum puan 5 ise rating_scale 5'tir.
category Şunun faydası olabilir: Tesisin kategorisini temsil eder.
hotel_data Şunun faydası olabilir: Otele özgü alanlar. Ayrıntılar için HotelData Tanımı başlıklı makaleyi inceleyin.
hotel_star_class Önerilen Resmi otel sınıfı yıldız değeri. Bu değerin 0 ile 5 arasında bir tam sayı olması beklenir. Sisteminizde yarım yıldız veya ondalık değerler (ör. 3.5) kullanılıyorsa değeri tam sayıya (3) yuvarlayın. Yıldız sınıfı mevcut değilse, bilinmiyorsa veya belirtilmemişse lütfen 0 değerini girin. 0 değerine ayarlanırsa kullanıcı arayüzünde otel yıldız sınıfı gösterilmez.
brand_ids Şunun faydası olabilir: Bu oteli gösterebilecek markalar. Bu alan boşsa otel, feed ile ilişkili markalardan 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 kurallara uymalı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 öğesinin doğrudan yolu (ör. .jpg ile biter).
  • İzinler: Barındırma sunucusunun ve robots.txt dosyasının, Googlebot ve Googlebot-Image kullanıcı aracılarının erişimine izin verdiğinden ve resim dizinlerini engellemediğinden 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:

  • name
  • description
  • display_address

İçeriği birden fazla dilde sunmak için alanda bir default_locale belirtmeniz ve localizations listesinde yerelleştirilmiş dizeleri sağlamanız gerekir. Bir tesisle ilgili tüm yerelleştirmeleri tek bir ÖY girişinde sağlayın. Tek bir mülkü 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 Birleştirilmiş JSON Arşivi (Zorunlu): Tüm mülk kayıtlarını tek bir JSON dosyasında birleştirin. Dosyayı tek bir GZIP arşivinde sıkıştırıp yüklemenizi öneririz.
  • Anti-Pattern Uyarısı: Tesis başına bir dosya veya aynı arşivde ülkeye göre 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 Tanımı

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

Örnekler

Önemli Yer Özet Akışı

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"]
      }
    }
  ]
}