Località e punto d'interesse

Il feed dei prodotti offre diversi modi per specificare i punti di interesse associati al prodotto. Google utilizza queste informazioni per mostrare il prodotto agli utenti quando vengono cercati PDI o destinazioni pertinenti.

Ogni prodotto option può specificare uno o più punti di interesse (POI) correlati all'opzione utilizzando il campo related_location (contenente un elenco di oggetti RelatedLocation). Ogni oggetto RelatedLocation contiene un location che descrive il punto d'interesse in questione e un relation_type che descrive la relazione tra il punto d'interesse e il prodotto option.

Un'opzione di prodotto deve essere contrassegnata come correlata solo se fornisce un'esperienza significativa della località oltre alla sua visita fisica. La definizione di "significativo" può variare a seconda del luogo, ma ciò che di solito non deve essere contrassegnato come correlato include la vista di un PDI ad esempio da una crociera in barca o durante un tour in autobus, oppure i punti di ritrovo per i tour (utilizza invece il campo meeting_point). I tre relation_types sono:

  • RELATED_NO_ADMISSION: La località è correlata, ma l'opzione del prodotto non include l'ingresso o l'ingresso non è pertinente. Ad esempio, se la posizione è una piazza evidenziata in un tour della città.

  • ADMISSION_TICKET: la relazione concede l'accesso a questa posizione correlata.

  • SUPPLEMENTARY_ADDON: Relation dichiara un servizio aggiuntivo che non porta l'utente nella posizione correlata. Ad esempio, una multa per divieto di sosta o una mostra temporanea.

Esempi

relation_type Esempio
RELATED_NO_ADMISSION Tour a piedi intorno alla Torre Eiffel senza ingresso. Tour in elicottero intorno al Burj Khalifa.
ADMISSION_TICKET Biglietto d'ingresso per uno zoo, può includere componenti aggiuntivi.
SUPPLEMENTARY_ADDON Salta la coda senza ingresso, audioguida senza ingresso.
Non correlato Crociera in barca che mostra il PDI da lontano. Ufficio del tour da cui inizia il tour o in cui è possibile acquistare il biglietto.

Ogni prodotto option può anche avere un meeting_point per tipi di tour specifici in cui la posizione di partenza non è chiara e deve essere determinata (ad es. visite guidate).

Come richiedere l'aggiunta di una nuova attrazione

Se fornisci i biglietti ufficiali per le attrazioni e noti che una delle attrazioni con cui collabori non è presente in Google Things to Do, puoi compilare il modulo di richiesta di un nuovo PDI di Things to Do per richiedere l'aggiunta del PDI a Things to Do.

Quando elabora un feed in entrata, Google tenta di abbinare i suggerimenti sulla località forniti come stringhe di testo a entità interne di Google che rappresentano queste località, note come punti di interesse (POI).

Un punto d'interesse può essere definito in modo generico come un segnaposto denominato in una posizione specifica (coordinate). Nel contesto di Cose da fare, esempi pertinenti includono tour operator e attrazioni turistiche; tuttavia, in generale, un PDI può essere qualsiasi struttura con un nome e una posizione noti a Google.

La corrispondenza della posizione si riferisce al processo di abbinamento di una posizione correlata, sotto forma di suggerimento testuale, a un PDI noto a Google, se esiste nel database di Google.

Esistono diversi modi per inviare una posizione correlata a Google, a seconda dell'origine dei dati sulla posizione, dei requisiti contrattuali con i fornitori e del livello di controllo che si desidera esercitare sul processo di corrispondenza.

Sono supportati i seguenti tipi di suggerimenti (in ordine di preferenza):

Tipi di suggerimento

Tipo Descrizione Utilizzo consigliato
ID profilo dell'attività Identifica in modo univoco un'attività su Google.

Può essere ottenuto solo direttamente dal proprietario dell'attività utilizzando la pagina delle impostazioni avanzate del profilo dell'attività, come descritto in Impostazioni avanzate del profilo.

È mappato sul PDI che rappresenta l'attività su Google. La mappatura andrà a buon fine solo se la sede dell'attività è stata verificata da Google.

Oltre ai PDI, questo formato supporta anche i tipi di attività al domicilio del cliente e ibride, definiti in Come utilizzare un'area coperta dal servizio su Google.
  • Il partner ha un rapporto commerciale diretto con il proprietario dell'attività.
  • Per le attività di tipo ibrido o al domicilio del cliente, questo è il modo preferito per inviare queste sedi.
Informazioni sul luogo Rappresentazione strutturata di un POI, che fornisce campi separati per nome del luogo, componenti dell'indirizzo e suggerimenti aggiuntivi come numero di telefono, sito web e coordinate.

Questo è il metodo preferito quando non è possibile ottenere un ID profilo dell'attività dal proprietario del PDI.
  • La posizione proviene dal fornitore o dal proprietario dei dati in un formato di indirizzo, ad esempio utilizzando uno strumento rivolto ai fornitori.
  • La posizione non ha un indirizzo preciso, ma può essere identificata per nome e coordinate, ad esempio un'attrazione o un tour operator situato in una zona remota come un deserto o una strada senza nome.
  • Se possibile, preferisci questo formato all'abbinamento dell'indirizzo a un ID luogo utilizzando l'API Places, in modo che Google possa utilizzare informazioni aggiuntive come il numero di telefono o il sito web per migliorare la precisione della corrispondenza.
ID luogo Identifica in modo univoco un POI su Google.

Può essere recuperato utilizzando gli endpoint dell'API Places, ad esempio Place Search o Place Autocomplete, oppure manualmente utilizzando lo strumento Trova località corrispondenti nel Things to Do Center.
  • La posizione viene recuperata dal fornitore o dal proprietario dei dati tramite uno strumento UI rivolto ai fornitori, che può, ad esempio, utilizzare Place Autocomplete per consentire al proprietario dei dati di selezionare la corrispondenza corretta da un elenco di possibili candidati.
  • Preferisci avere un maggiore controllo sulla procedura di corrispondenza o non vuoi condividere le informazioni sull'indirizzo non elaborate.
  • Questo è il metodo preferito quando ottenere un ID profilo dell'attività dal proprietario del PDI non è fattibile e preferisci abbinare l'indirizzo a un PDI dalla tua parte utilizzando l'API Places, anziché inviare a Google le informazioni non elaborate sul luogo.
Latitudine e longitudine Identifica in modo approssimativo una regione geografica o geopolitica, ad esempio una città, una località o una destinazione di viaggio.
  • Utilizza questo formato quando vuoi inviare una posizione approssimativa che non rappresenta un PDI specifico. Ad esempio, quando vuoi associare un prodotto a una città o località in modo che il prodotto possa essere attivato negli annunci Things to Do.
  • Questo formato non è adatto a rappresentare un POI. Per inviare le posizioni dei PDI utilizzando le coordinate, utilizza il formato Informazioni sul luogo.
Indirizzo Rappresenta la posizione di un PDI come indirizzo su una sola riga non strutturato, che include facoltativamente il nome del luogo.

Deprecato.
Questo formato non sarà più supportato a partire dal 1° maggio 2024.
  • Tutto l'utilizzo di questo formato dovrà essere migrato al nuovo formato Place Info, che include un campo obbligatorio per il nome del luogo e supporta i formati di indirizzo strutturati e non strutturati.
  • In alternativa, i suggerimenti per le località interessate possono essere migrati all'ID profilo dell'attività o all'ID luogo.

Esempi

// Example 1: Business Profile ID, copied from the Advanced settings page
// of the Google Business Profile that manages the POI.
"location": {
  "business_profile_id": 11458995034835395294
}

// Example 2: Place Info with structured address, coordinates, website URL,
// and phone number.
"location": {
  "place_info": {
    "name": "Colosseum",
    "phone_number": "+39 063 99 67 700",
    "website_url": "https://colosseo.it/",
    "coordinates": {
      "latitude": 41.8902102,
      "longitude": 12.4922309
    },
    "structured_address" {
      "street_address": "Piazza del Colosseo, 1",
      "locality": "Roma",
      "administrative_area": "RM",
      "postal_code": "00184",
      "country_code": "IT"
    }
  }
}

// Example 3: Place Info with unstructured address.
"location": {
  "place_info": {
    "name": "Eiffel Tower",
    "unstructured_address": "5 Av. Anatole France, 75007 Paris, France"
  }
}

// Example 4: Place Info using place name and coordinates only. This
// configuration is useful for matching POIs located in remote areas without
// an exact street address, such as POIs located in deserts or on unnamed
// roads.
"location": {
  "place_info": {
   "name": "Mutitjulu Waterhole",
   "coordinates": {
     "latitude": -25.3511774,
     "longitude": 131.0326859
    }
  }
}

// Example 5: Latitude and longitude.
// This format maintains the old behavior and will only match to the city or
// region.
// For more accurate matching using coordinates, use PlaceInfo instead,
// which includes a mandatory field for the place name.
"location": {
  "lat_lng": {
    "latitude": 51.5072178,
    "longitude": -0.1275862
  }
}

Come eseguire la migrazione del campo address al nuovo campo place_info

Puoi eseguire la migrazione del campo address non strutturato esistente al nuovo campo place_info seguendo questi passaggi:

  1. Se i dati dell'indirizzo che hai non sono strutturati:
    1. Aggiungi il nome dell'attività al campo place_info/name
    2. Inserisci l'indirizzo senza il nome dell'attività in place_info/unstructured_address
    3. Elimina il campo address esistente dal feed
    4. Vai al passaggio 3
  2. Se i dati degli indirizzi che hai sono strutturati:
    1. Aggiungi il nome dell'attività al campo place_info/name
    2. Aggiungi i dati dell'indirizzo, ad esempio street_address, postal_address in place_info/structured_address.
    3. Elimina il campo address esistente dal feed
    4. Vai al passaggio 3
  3. Aggiungi dati aggiuntivi come website_url e phone_number per migliorare l'accuratezza della corrispondenza