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

Ta strona zawiera szczegółowe informacje o specyfikacjach technicznych pliku danych o ciekawych miejscach. Obejmuje ona podsumowanie wymaganych pól, obszerne definicje schematów i przykładowy plik JSON, który ułatwi wdrożenie.

Specyfikacje pliku danych

Ta sekcja zawiera opis wymagań i definicji dotyczących pliku danych o ciekawych miejscach.

Wymagania dotyczące pól

Nazwa pola	Wymaganie	Opis
poi_id	Wymagane	Ciąg znaków wygenerowany przez partnera, który identyfikuje ciekawe miejsce (obiekt).
nazwa	Wymagane	Nazwa ciekawego miejsca. Ta nazwa będzie używana jako wyświetlana nazwa obiektu w jednostce agregatora.
telefon	Przydatne	Numer telefonu kontaktowego ciekawego miejsca wraz z kodem kraju i numerem kierunkowym, np. +14567891234.
`url`	Przydatne	URL publicznej witryny ciekawego miejsca. Uwaga: będzie on używany tylko do dopasowywania, a nie do wyświetlania.
lokalizacja	Wymagane (adres) Przydatne (szerokość i długość geograficzna)	Lokalizacja ciekawego miejsca. Wymagane: adres i powiązane pola są wymagane, aby prawidłowo dopasować obiekt. Przydatne: szerokość i długość geograficzna. Jeśli podasz te dane, Google użyje szerokości i długości geograficznej do wyświetlania pinezek obiektów na mapie w jednostce agregatora.
obrazy	Zdecydowanie zalecane (1 obraz) Przydatne (wiele obrazów)	Obrazy ciekawego miejsca. Obrazy będą ważne w przypadku wyświetlania obiektów. Zdecydowanie zalecamy dodanie co najmniej 1 obrazu. Możesz podać maksymalnie 5 obrazów. Jeśli podasz kilka obrazów, będą one używane w kolejności, w jakiej zostały podane (w przypadku, gdy obraz jest nieużyteczny). Obrazy będą sprawdzane pod kątem zgodności z zasadami bezpiecznego wyszukiwania Google.
ocena	Przydatne	Średnia ocena obiektu.
num_ratings	Przydatne	Liczba ocen, które składają się na wartość w polu `rating`.
rating_scale	Przydatne	Skala ocen używana w polu `rating`. Jeśli maksymalna ocena to 5, wartość rating_scale wynosi 5.
kategoria	Przydatne	Reprezentuje kategorię obiektu.
hotel_data	Przydatne	Pola dotyczące hoteli. Szczegółowe informacje znajdziesz w definicji HotelData.
hotel_star_class	Przydatne	Oficjalna klasa hotelu wyrażona w gwiazdkach. Ta wartość powinna być liczbą całkowitą z zakresu od 1 do 5.
brand_ids	Przydatne	Marki, które mogą wyświetlać ten hotel. Jeśli to pole jest puste, hotel może być wyświetlany pod dowolną marką powiązaną z plikiem danych.
opis	Przydatne	Szczegółowy opis obiektu.
display_address	Przydatne	Adres wyświetlany w interfejsie.

Wytyczne dotyczące zdjęć

Wszystkie obrazy dodane do pliku danych muszą być zgodne z tymi wytycznymi:

Format: musi to być plik JPEG, PNG lub WebP.
Maksymalny rozmiar pliku: poniżej 30 MB na obraz.
Maksymalne wymiary: mniej niż 75 megapikseli łącznie (szerokość x wysokość < 75 000 000).
Typ adresu URL: bezpośrednia ścieżka do komponentu z obrazem (np. kończy się ciągiem .jpg).
Uprawnienia: upewnij się, że serwer hostujący umożliwia dostęp robotowi Googlebot lub innym robotom indeksującym i że nie ma pliku robots.txt blokującego katalogi obrazów.

Obsługa wielu języków

Plik danych o ciekawych miejscach umożliwia podawanie zlokalizowanych treści w przypadku określonych pól. Te pola są typu Text i obsługują lokalizację:

name
description
display_address

Aby podać treści w wielu językach, musisz określić default_locale w polu i podać zlokalizowane ciągi znaków na liście localizations. Wszystkie lokalizacje obiektu podaj w jednym wpisie o ciekawym miejscu. Nie dzielaj jednego obiektu na kilka plików JSON w różnych językach.

Przykład:

"name": {
  "localizations": [
    {
      "locale": "en",
      "text": "Banana Hotel"
    },
    {
      "locale": "es",
      "text": "Hotel Plátano"
    }
  ],
  "default_locale": "en"
}

Wytyczne dotyczące przygotowywania pakietów plików

Aby zapewnić prawidłowe wczytanie danych, przestrzegaj tych wymagań dotyczących przygotowywania pakietów:

Pojedyncze zagregowane archiwum JSON (wymagane): połącz wszystkie rekordy obiektów w jeden plik JSON. Zalecamy skompresowanie go do jednego archiwum GZIP i przesłanie.
Ostrzeżenie przed nieprawidłowym wzorcem: nie używaj jednego pliku na obiekt ani wielu plików podzielonych według kraju w tym samym archiwum. To podejście nie jest obsługiwane i spowoduje błędy podczas wyodrębniania.

Definicje

Definicja 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 {

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

}

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

  }
}

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

Przykłady