Google używa technologii AI do tłumaczenia treści na Twój preferowany język. Tłumaczenia wygenerowane przez AI mogą zawierać błędy.

Plik danych o ciekawych miejscach

Tworzenie i przesyłanie plików danych o ciekawych miejscach

Podczas tworzenia i przesyłania plików danych o ciekawych miejscach postępuj zgodnie z tymi instrukcjami:

W przypadku plików danych o ciekawych miejscach postępuj zgodnie ze specyfikacją opisaną w pliku danych o ciekawych miejscach. Zalecamy używanie unikalnych nazw plików danych o ciekawych miejscach przy każdym przesyłaniu. Dołącz sygnaturę czasową w nazwie pliku, na przykład POI_1633621547.json.
Codziennie przesyłaj pliki danych na lokalny serwer SFTP z ciekawymi miejscami jako pełne odświeżenia.
Szczegóły serwera SFTP znajdziesz w sekcji Konfiguracja > Pliki danych w Portalu dla partnerów.

Wybieranie serwerów plików danych

Przed przesłaniem pliku danych o miejscach sprawdź go za pomocą walidatora pliku danych o miejscach.
Stan przetwarzania pliku danych możesz sprawdzić w sekcji Przetwarzanie > Historia w Portalu dla partnerów.

Wytyczne dotyczące pakowania plików

Aby zapewnić prawidłowe przetwarzanie, przestrzegaj tych wymagań dotyczących pakowania:

Pojedyncze zagregowane archiwum JSON (wymagane): połącz wszystkie rekordy encji w jeden plik JSON. Zalecamy skompresowanie go do jednego archiwum GZIP i przesłanie.
Ostrzeżenie dotyczące antywzorca: nie używaj jednego pliku na podmiot ani wielu plików rozdzielonych według kraju w tym samym archiwum. Takie podejście nie jest obsługiwane i będzie powodować błędy wyodrębniania.

Obsługa wielu języków

Plik danych o atrakcjach turystycznych obsługuje podawanie zlokalizowanych treści w określonych polach. Te pola są typu Text i obsługują lokalizację:

name
description
display_address

Aby udostępniać treści w kilku językach, musisz określić default_locale w polu i podać zlokalizowane ciągi znaków na liście localizations. Podaj wszystkie lokalizacje danego podmiotu w jednym wpisie dotyczącym ciekawego miejsca. Nie dziel pojedynczego elementu między wiele plików JSON w różnych językach.

Przykład:

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

Wytyczne dotyczące obrazów

Format: JPEG, PNG lub WebP.
Maksymalny rozmiar pliku: poniżej 30 MB na obraz.
Maksymalne wymiary: łącznie mniej niż 75 megapikseli (szerokość × wysokość < 75 000 000).
Typ adresu URL: bezpośrednia ścieżka do komponentu z obrazem (np. kończąca się rozszerzeniem .jpg).
Uprawnienia: upewnij się, że serwer hostujący zezwala na dostęp robotom Googlebot lub innym robotom indeksującym i nie ma pliku robots.txt blokującego katalogi obrazów.
Filtr SafeSearch: obrazy muszą być zgodne z zasadami filtra SafeSearch Google.

Specyfikacje pliku danych

Wymagania dotyczące pól

VssPoi

Reprezentuje pojedynczy element będący ciekawym miejscem, np. hotel lub restaurację.

Nazwa pola	Typ	Wymaganie	Opis
`poi_id`	tekst	Wymagane	Wymagane. Ciąg znaków wygenerowany przez partnera, który identyfikuje ważne miejsce.
`name`	object `(Text)`	Wymagane	Wymagane. Nazwa miejsca.
`telephone`	tekst		Numer telefonu kontaktowego do ciekawego miejsca wraz z kodem kraju i numerem kierunkowym, np. +14567891234.
`url`	tekst		Adres URL publicznej witryny ciekawego miejsca. Uwaga: te informacje będą używane tylko do dopasowywania, a nie do wyświetlania.
`location`	object `(GeoCoordinates)`	Wymagane	Wymagane. Lokalizacja ciekawego miejsca.
`display_address`	object `(Text)`		Adres wyświetlany w interfejsie.
`images`	tablica obiektów `(Image)`		zdjęcia ciekawego miejsca; Maksymalna liczba obrazów: 5.
`rating`	liczba		Średnia ocena miejsca.
`num_ratings`	liczba		Liczba ocen, które wpłynęły na wartość w polu `rating`.
`rating_scale`	liczba		Skala ocen używana w polu `rating`. Jeśli maksymalna ocena to 5, rating_scale to 5.
`category`	enum `(Category)`	Wymagane	Wymagane. Reprezentuje kategorię ciekawego miejsca.
`description`	object `(Text)`		Opis ciekawego miejsca.
	oneOf `(additional_data)`	Wymagane	Można ustawić tylko jedno z pól w tym elemencie oneOf.

Tekst

Reprezentuje tekst z lokalizacjami.

Nazwa pola	Typ	Wymaganie	Opis
`localizations`	tablica obiektów `(LocalizedString)`		Zlokalizowane ciągi znaków.
`default_locale`	tekst		Ustawienia regionalne, które mają być używane jako język domyślny. Muszą być obecne w lokalizacjach.

LocalizedString

Reprezentuje zlokalizowany ciąg znaków.

Nazwa pola	Typ	Wymaganie	Opis
`locale`	tekst		Tag języka tekstu, np. „pl”, „pl-PL” lub „sr-Latn”.
`text`	tekst		Tekst w określonym języku.

GeoCoordinates

Dane geograficzne lokalizacji, w tym szerokość i długość geograficzna oraz adres.

Nazwa pola	Typ	Wymaganie	Opis
`latitude`	liczba		[-90, +90] stopni (włącznie). Wymagane, jeśli ustawiono długość geograficzną. W przeciwnym razie zalecane.
`longitude`	liczba		[-180, +180] stopni (włącznie). Wymagane, jeśli ustawiono szerokość geograficzną. W przeciwnym razie zalecane.
	oneOf `(addresses)`	Wymagane	Można ustawić tylko jedno z pól w tym elemencie oneOf.

PostalAddress

Adres pocztowy lokalizacji.

Nazwa pola	Typ	Wymaganie	Opis
`country`	tekst	Wymagane	Wymagane. Kraj w formacie kodu kraju ISO 3166-1 alfa-2, np. „US”.
`locality`	tekst	Wymagane	Wymagane. Miejscowość/miasto, np. „Mountain View”.
`region`	tekst		Region/stan/województwo, np. „CA”. To pole jest wymagane tylko w krajach, w których region jest zwykle częścią adresu. (opcjonalnie)
`postal_code`	tekst	Wymagane	Wymagane. Kod pocztowy, np. „94043”.
`street_address`	tekst	Wymagane	Wymagane. Ulica i numer, np. „1600 Amphitheatre Pkwy”.

Obraz

Reprezentuje obraz ciekawego miejsca.

Nazwa pola	Typ	Wymaganie	Opis
`url`	tekst		Adres URL obrazu. Google będzie indeksować multimedia hostowane pod tym adresem URL. Maksymalna długość: 2000 znaków.
`alt_text`	object `(Text)`		Tekst alternatywny używany na potrzeby ułatwień dostępu.

HotelData

Dane pliku danych dotyczące konkretnego hotelu.

Nazwa pola	Typ	Wymaganie	Opis
`hotel_star_class`	liczba		Oficjalna liczba gwiazdek hotelu. Można go użyć w etykiecie, np. „hotel 5-gwiazdkowy”. Ta wartość powinna być liczbą całkowitą z zakresu od 0 do 5. Jeśli ocena jest niedostępna lub nie została określona, należy użyć wartości 0. Jeśli ustawisz wartość 0, użytkownikom nie będzie wyświetlana żadna klasa gwiazdek.
`brand_ids`	tablica ciągów znaków		Marki, które mogą wyświetlać ten hotel. Jeśli to pole jest puste, hotel może się wyświetlać pod dowolną marką powiązaną z plikiem danych.

LocalData

Dane pliku danych dotyczące konkretnej placówki.

Nazwa pola	Typ	Wymaganie	Opis
`business_hours`	object `(BusinessHours)`		Standardowe godziny otwarcia placówki.
`price_range`	object `(PriceRange)`		Przedział cenowy usług oferowanych przez firmę.
`establishment_category`	object `(Text)`		Typ placówki.
`brand_landing_pages`	tablica obiektów `(BrandLandingPages)`	Wymagane	Wymagane. Strony docelowe marki. Musisz podać co najmniej 1 wartość.

BusinessHours

Określa przedziały czasu, w których ta lokalizacja jest otwarta. Zawiera kolekcję instancji [TimeRange][madden.vss_poi_feed.TimeRange]. Przykład: otwarte w soboty w godzinach 9:00–12:00 i 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 } } Przykład: otwarte w soboty od 21:00 do niedzieli do 2:00: time_ranges { open_day: SATURDAY open_time: { hours: 21, minutes: 0 } close_day: SUNDAY close_time: { hours: 2, minutes: 0 } }

Nazwa pola	Typ	Wymaganie	Opis
`time_ranges`	tablica obiektów `(TimeRange)`		Zbiór godzin, w których to ważne miejsce jest otwarte. Każdy okres reprezentuje zakres godzin, w których ciekawe miejsce jest otwarte w ciągu tygodnia.

TimeRange

Reprezentuje przedział czasu, w którym ciekawe miejsce jest otwarte, zaczynając od określonego dnia i godziny otwarcia, a kończąc na określonym dniu i godzinie zamknięcia. Godzina zamknięcia musi być późniejsza niż godzina otwarcia, np. późniejsza tego samego dnia lub następnego dnia.

Nazwa pola	Typ	Opis
`open_day`	enum `(DayOfWeek)`	Dzień otwarcia w zakresie czasu.
`open_time`	object `(TimeOfDay)`	Godzina otwarcia w danym zakresie czasu.
`close_day`	enum `(DayOfWeek)`	Dzień zamknięcia w zakresie czasu.
`close_time`	object `(TimeOfDay)`	Godzina zamknięcia w zakresie czasu.

TimeOfDay

Nazwa pola	Typ	Opis
`hours`	liczba	Godziny w formacie 24-godzinnym. Wartość musi być równa lub większa niż 0 i zwykle nie może być większa niż 23. Interfejs API może zezwalać na wartość „24:00:00” w przypadku takich scenariuszy jak godzina zamknięcia firmy.
`minutes`	liczba	Minuty w godzinie. Wartość musi być równa lub większa niż 0 i równa lub mniejsza niż 59.
`seconds`	liczba	Sekundy w minucie. Wartość musi być równa lub większa niż 0 i zwykle nie może być większa niż 59. Interfejs API może zezwalać na wartość 60, jeśli dopuszcza sekundy przestępne.
`nanos`	liczba	Ułamki sekund w nanosekundach. Wartość musi być równa lub większa niż 0 i mniejsza lub równa 999 999 999.

PriceRange

Przedział cenowy usług oferowanych przez ważne miejsce.

Nazwa pola	Typ	Wymaganie	Opis
`min_price`	object `(Money)`		Cena minimalna usług oferowanych przez ważne miejsce.
`max_price`	object `(Money)`		Cena maksymalna usług oferowanych przez ważne miejsce.

Pieniądze

Reprezentuje kwotę pieniężną z rodzajem waluty.

Nazwa pola	Typ	Opis
`currency_code`	tekst	Trzyliterowy kod waluty zdefiniowany w normie ISO 4217.
`units`	liczba	Całe jednostki kwoty. Jeśli na przykład `currencyCode` to `"USD"`, 1 jednostka to 1 USD.
`nanos`	liczba	Liczba jednostek nano (10^-9) kwoty. Wartość musi się zawierać w przedziale od -999 999 999 do +999 999 999 (włącznie). Jeśli `units` jest dodatnia, `nanos` musi być dodatnia lub wynosić zero. Jeśli `units` wynosi zero, `nanos` może być liczbą dodatnią, ujemną lub zerem. Jeśli parametr `units` ma wartość ujemną, parametr `nanos` musi mieć wartość ujemną lub wynosić zero. Na przykład kwota -1,75 USD jest reprezentowana jako `units`=-1 i `nanos`=-750 000 000.

BrandLandingPages

Zlokalizowane strony docelowe marki dla jednego ciekawego miejsca.

Nazwa pola	Typ	Wymaganie	Opis
`brand_id`	tekst	Wymagane	Wymagane. Marka, której dotyczy ta konfiguracja.
`localized_landing_pages`	tablica obiektów `(LocalizedLandingPage)`		Zlokalizowane strony docelowe. Wartości pól url i locales muszą być unikalne we wszystkich zlokalizowanych stronach docelowych.
`default_url`	tekst	Wymagane	Wymagane. Domyślny adres URL strony docelowej, który będzie używany, gdy żadna ze zlokalizowanych stron docelowych nie będzie pasować do języka użytkownika.

LocalizedLandingPage

Zlokalizowana strona docelowa ciekawego miejsca.

Nazwa pola	Typ	Wymaganie	Opis
`url`	tekst		Adres URL strony docelowej. Maksymalna długość: 2000 znaków.
`locales`	tablica ciągów znaków		Ogranicza dostęp do tej strony do użytkowników z określonym ustawieniem języka. Musi zawierać tagi języka, takie jak „en”, „en-US” lub „sr-Latn”.

Kategoria

Reprezentuje kategorię ciekawego miejsca. Powinien on odpowiadać polu additional_data oneof poniżej.

Nazwa	Opis
`UNKNOWN_CATEGORY`
`HOTEL`
`LOCAL`

DzieńTygodnia

Reprezentuje dzień tygodnia.

Nazwa	Opis
`DAY_OF_WEEK_UNSPECIFIED`	Dzień tygodnia nie został określony.
`MONDAY`	Poniedziałek
`TUESDAY`	Tuesday (wtorek)
`WEDNESDAY`	Wednesday (środa)
`THURSDAY`	Thursday (czwartek)
`FRIDAY`	Friday (piątek)
`SATURDAY`	Saturday (sobota)
`SUNDAY`	Niedziela

additional_data

Wymagane. Pola dotyczące konkretnej kategorii. Powinna być zgodna z polem category powyżej.

Nazwa pola	Typ	Wymaganie	Opis
`hotel_data`	object `(HotelData)`	Wyklucza się wzajemnie z: `local_data`	Pola dotyczące hoteli.
`local_data`	object `(LocalData)`	Wyklucza się wzajemnie z: `hotel_data`	Pola dotyczące konkretnych lokalizacji.

adresy

Wymagane. Adres lokalizacji.

Nazwa pola	Typ	Wymaganie	Opis
`address`	object `(PostalAddress)`		Adres pocztowy lokalizacji.

Definicje

Definicja pliku danych 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;
}

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

}

Definicja tekstu

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

Definicja współrzędnych geograficznych

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

  }
}

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

Definicja obrazu

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

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

Definicja 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".
    // Empty list means this page is not restricted by language.
    repeated string locales = 3;

    // Restricts this page to users from the specified countries.
    // Must contain ISO 3166-1 alpha-2 country codes, e.g. "US".
    // Empty list means this page is not restricted by country.
    // If `is_default_for_country` is true, this field must not be empty.
    repeated string countries = 4;

    // Whether this page should be used as the default fallback for users in
    // `countries` when no entry for that country matches the user's
    // language preference.
    bool is_default_for_country = 5;
  }

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

Przykłady