Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.

Feed dei punti d'interesse (PDI)

Creare e caricare feed di PDI

Quando crei e carichi feed di PDI, segui queste istruzioni:

Segui le specifiche descritte nel feed POI per i file di dati POI. Ti consigliamo di utilizzare nomi di file univoci per i dati dei PDI per ogni caricamento. Includi un timestamp nel nome del file, ad esempio POI_1633621547.json.
Carica i feed sul server SFTP dei PDI locali ogni giorno come aggiornamenti completi.
Puoi trovare i dettagli del server SFTP nella sezione Configurazione > Feed del Partner Portal.

Selezione dei server di feed

Visualizza lo stato dell'importazione dei feed nella sezione Importazione > Cronologia del Partner Portal.

Specifiche del feed

Requisiti dei campi

VssPoi

Rappresenta una singola entità di punto d'interesse (PDI), ad esempio un hotel o un ristorante.

Nome campo	Tipo	Requisito	Descrizione
`poi_id`	stringa	Obbligatorio	Obbligatorio. Una stringa generata dal partner che identifica un PDI.
`name`	oggetto `(Text)`	Obbligatorio	Obbligatorio. Il nome del PDI.
`telephone`	stringa		Il numero di telefono di contatto del punto d'interesse, inclusi il codice paese e il prefisso, ad es. +14567891234.
`url`	stringa		L'URL del sito web pubblico del punto d'interesse. Nota: questo valore verrà utilizzato solo a scopo di corrispondenza, non per la visualizzazione.
`location`	oggetto `(GeoCoordinates)`	Obbligatorio	Obbligatorio. La posizione del PDI.
`display_address`	oggetto `(Text)`		L'indirizzo visualizzato nell'UI.
`images`	array di object `(Image)`		Immagini del PDI. Numero massimo di immagini: 5.
`rating`	numero		Valutazione media del PDI.
`num_ratings`	numero		Il numero di valutazioni che contribuiscono al campo `rating`.
`rating_scale`	numero		La scala di valutazione utilizzata per il campo `rating`. Se la valutazione massima è 5, allora rating_scale è 5.
`category`	enum `(Category)`	Obbligatorio	Obbligatorio. Rappresenta la categoria del punto d'interesse.
`description`	oggetto `(Text)`		Una descrizione del PDI.
	oneOf `(additional_data)`	Obbligatorio	È possibile impostare solo uno dei campi in questo oneOf.

Testo

Rappresenta un testo con localizzazioni.

Nome campo	Tipo	Requisito	Descrizione
`localizations`	array di object `(LocalizedString)`		Le stringhe localizzate.
`default_locale`	stringa		Le impostazioni internazionali da utilizzare come lingua predefinita devono essere presenti nelle localizzazioni.

LocalizedString

Rappresenta una stringa localizzata.

Nome campo	Tipo	Requisito	Descrizione
`locale`	stringa		Il tag della lingua del testo, ad esempio "en", "en-US" o "sr-Latn".
`text`	stringa		Il testo nella lingua specificata.

GeoCoordinates

I dati geografici di una posizione, inclusi latitudine, longitudine e indirizzo.

Nome campo	Tipo	Requisito	Descrizione
`latitude`	numero		Gradi [-90, +90] (inclusi). Obbligatorio se la longitudine è impostata, altrimenti consigliato.
`longitude`	numero		[-180, +180] gradi (inclusi). Obbligatorio se la latitudine è impostata, altrimenti consigliato.
	oneOf `(addresses)`	Obbligatorio	È possibile impostare solo uno dei campi in questo oneOf.

PostalAddress

L'indirizzo postale della località.

Nome campo	Tipo	Requisito	Descrizione
`country`	stringa	Obbligatorio	Obbligatorio. Il paese, utilizzando il codice paese ISO 3166-1 alpha-2, ad es. "US".
`locality`	stringa	Obbligatorio	Obbligatorio. La località/città, ad es. "Mountain View".
`region`	stringa		La regione/lo stato/la provincia, ad es. "CA". Questo campo è obbligatorio solo nei paesi in cui la regione fa comunemente parte dell'indirizzo. (facoltativo)
`postal_code`	stringa	Obbligatorio	Obbligatorio. Il codice postale, ad es. "94043".
`street_address`	stringa	Obbligatorio	Obbligatorio. L'indirizzo stradale, ad es. "1600 Amphitheatre Pkwy".

Immagine

Rappresenta un'immagine del punto d'interesse (PDI).

Nome campo	Tipo	Requisito	Descrizione
`url`	stringa		L'URL dell'immagine. Google eseguirà la scansione dei contenuti multimediali ospitati a questo URL. Lunghezza massima: 2000.
`alt_text`	oggetto `(Text)`		Il testo alternativo da utilizzare per l'accessibilità.

HotelData

Dati del feed specifici per gli hotel.

Nome campo	Tipo	Requisito	Descrizione
`hotel_star_class`	numero		Il valore ufficiale della categoria hotel in stelle. Può essere utilizzato in un'etichetta come "Hotel a 5 stelle". Questo valore deve essere un numero intero compreso tra 1 e 5.
`brand_ids`	array di stringhe		I brand che possono mostrare questo hotel. Se questo campo è vuoto, l'hotel può essere visualizzato in uno qualsiasi dei brand associati al feed.

LocalData

Dati del feed specifici per la struttura.

Nome campo	Tipo	Descrizione
`business_hours`	oggetto `(BusinessHours)`	L'orario di apertura normale dell'attività.
`price_range`	oggetto `(PriceRange)`	Fascia di prezzo dei servizi offerti dalla struttura.
`establishment_category`	oggetto `(Text)`	Il tipo di struttura.
`brand_landing_pages`	array di object `(BrandLandingPages)`	Le pagine di destinazione del brand.

BusinessHours

Rappresenta i periodi di tempo in cui questa sede è aperta. Contiene una raccolta di istanze [TimeRange][madden.vss_poi_feed.TimeRange]. Esempio: aperto il sabato dalle 09:00 alle 12:00 e dalle 13:00 alle 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 } } Esempio: aperto il sabato dalle 21:00 alla domenica alle 02:00: time_ranges { open_day: SATURDAY open_time: { hours: 21, minutes: 0 } close_day: SUNDAY close_time: { hours: 2, minutes: 0 } }

Nome campo	Tipo	Requisito	Descrizione
`time_ranges`	array di object `(TimeRange)`		Un insieme di orari in cui questo PDI è aperto. Ogni periodo rappresenta un intervallo di ore in cui il POI è aperto durante la settimana.

TimeRange

Rappresenta un periodo di tempo in cui il punto d'interesse è aperto, a partire dal giorno/ora di apertura specificato e fino al giorno/ora di chiusura specificato. L'orario di chiusura deve essere successivo all'orario di apertura, ad esempio più tardi nello stesso giorno o in un giorno successivo.

Nome campo	Tipo	Descrizione
`open_day`	enum `(DayOfWeek)`	Il giorno di apertura dell'intervallo di tempo.
`open_time`	oggetto `(TimeOfDay)`	L'orario di apertura dell'intervallo di tempo.
`close_day`	enum `(DayOfWeek)`	Il giorno di chiusura dell'intervallo di tempo.
`close_time`	oggetto `(TimeOfDay)`	L'ora di chiusura dell'intervallo di tempo.

TimeOfDay

Nome campo	Tipo	Descrizione
`hours`	numero	Le ore di un giorno nel formato 24 ore. Deve essere maggiore o uguale a 0 e in genere deve essere minore o uguale a 23. Un'API può scegliere di consentire il valore "24:00:00" per scenari come l'orario di chiusura dell'attività.
`minutes`	numero	Minuti di un'ora. Deve essere maggiore o uguale a 0 e minore o uguale a 59.
`seconds`	numero	Secondi di un minuto. Deve essere maggiore o uguale a 0 e in genere deve essere minore o uguale a 59. Un'API potrebbe consentire il valore 60 se consente i secondi intercalari.
`nanos`	numero	Frazioni di secondi, in nanosecondi. Deve essere maggiore o uguale a 0 e minore o uguale a 999.999.999.

PriceRange

Fascia di prezzo dei servizi offerti dal PDI.

Nome campo	Tipo	Requisito	Descrizione
`min_price`	oggetto `(Money)`		Il prezzo minimo dei servizi offerti dal punto d'interesse.
`max_price`	oggetto `(Money)`		Il prezzo massimo dei servizi offerti dal punto d'interesse.

Denaro

Rappresenta un importo di denaro con il relativo tipo di valuta.

Nome campo	Tipo	Descrizione
`currency_code`	stringa	Il codice valuta di tre lettere definito nello standard ISO 4217.
`units`	numero	Le unità intere dell'importo. Ad esempio, se `currencyCode` è `"USD"`, un'unità corrisponde a un dollaro statunitense.
`nanos`	numero	Numero di unità nano (10^-9) dell'importo. Il valore deve essere compreso tra -999.999.999 e +999.999.999 inclusi. Se `units` è positivo, `nanos` deve essere positivo o zero. Se `units` è zero, `nanos` può essere positivo, zero o negativo. Se `units` è negativo, `nanos` deve essere negativo o zero. Ad esempio, -1,75 $ è rappresentato come `units`=-1 e `nanos`=-750.000.000.

BrandLandingPages

Le pagine di destinazione del brand localizzate per un singolo punto d'interesse (PDI).

Nome campo	Tipo	Descrizione
`brand_id`	stringa	Il brand a cui si applica questa configurazione.
`localized_landing_pages`	array di object `(LocalizedLandingPage)`	Le pagine di destinazione localizzate. I valori dei campi url e impostazioni internazionali devono essere univoci in tutte le pagine di destinazione localizzate.
`default_url`	stringa	L'URL pagina di destinazione predefinito da utilizzare quando nessuna delle pagine di destinazione localizzate corrisponde alla lingua dell'utente.

LocalizedLandingPage

Pagina di destinazione localizzata per il punto d'interesse (PDI).

Nome campo	Tipo	Requisito	Descrizione
`url`	stringa		L'URL della pagina di destinazione. Lunghezza massima: 2000.
`locales`	array di stringhe		Limita questa pagina agli utenti con la preferenza di lingua specificata. Devono contenere tag di lingua, ad esempio "en", "en-US" o "sr-Latn".

Categoria

Rappresenta la categoria del punto d'interesse. Deve corrispondere al campo additional_data oneof riportato di seguito.

Nome	Descrizione
`UNKNOWN_CATEGORY`
`HOTEL`
`LOCAL`

DayOfWeek

Rappresenta un giorno della settimana.

Nome	Descrizione
`DAY_OF_WEEK_UNSPECIFIED`	Il giorno della settimana non è specificato.
`MONDAY`	Lunedì
`TUESDAY`	Martedì
`WEDNESDAY`	Mercoledì
`THURSDAY`	Giovedì
`FRIDAY`	Venerdì
`SATURDAY`	Sabato
`SUNDAY`	Domenica

additional_data

Obbligatorio. Campi specifici per categoria. Deve corrispondere al campo category sopra.

Nome campo	Tipo	Requisito	Descrizione
`hotel_data`	oggetto `(HotelData)`	Esclusivo con `local_data`	Campi specifici dell'hotel.
`local_data`	oggetto `(LocalData)`	Esclusivo con `hotel_data`	Campi specifici per la località.

indirizzi

Obbligatorio. Indirizzo di una località.

Nome campo	Tipo	Requisito	Descrizione
`address`	oggetto `(PostalAddress)`		Indirizzo postale della sede.

Formato: deve essere JPEG, PNG o WebP.
Dimensione massima del file: inferiore a 30 MB per immagine.
Dimensioni massime: meno di 75 megapixel totali (larghezza x altezza < 75.000.000).
Tipo di URL: percorso diretto all'asset immagine (ad es. termina con .jpg).
Autorizzazioni: assicurati che il server di hosting consenta l'accesso a Googlebot o ai crawler e che non ci siano file robots.txt che bloccano le directory delle immagini.

Definizioni

VssPoiFeed Definition

// Represents a Point of Interest (POI) data feed provided by a partner.
export message VssPoiFeed {
  // The POIs in the feed.
  repeated VssPoi data = 1;
}

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

}

Definizione del testo

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

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

  }
}

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

Definizione dell'immagine

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

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

  // The brand landing pages.
  repeated BrandLandingPages brand_landing_pages = 4;
}

BrandLandingPages Definition

// The Localized brand landing pages for a single Point of Interest (POI).
message BrandLandingPages {
  // 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".
    repeated string locales = 3;
  }

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

  // The default landing page url to be used when none of the localized
  // landing pages matches the user's language.
  string default_url = 3;
}

Esempi