Posizione e punto d'interesse

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

Ogni prodotto option può specificare uno o più punti di interesse (PDI) correlati all'opzione utilizzando il campo related_location (che contiene un elenco di oggetti RelatedLocation). Ogni oggetto RelatedLocation contiene un location che descrive il PDI in questione e un relation_type che descrive la relazione tra il PDI 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 di prodotto non include l'ingresso o l'ingresso non è pertinente. Ad esempio, se la località è una piazza evidenziata in un tour della città.

  • ADMISSION_TICKET: la relazione concede l'ingresso a questa località correlata.

  • SUPPLEMENTARY_ADDON: la relazione dichiara un servizio aggiuntivo che non consente all'utente di accedere alla stazione di ricarica correlata. Ad esempio, una multa per parcheggio, un'esibizione temporanea.

Esempi

relation_type Esempio
RELATED_NO_ADMISSION Tour a piedi intorno alla Torre Eiffel senza ingresso. Tour in elicottero intorno alla Burj Khalifa.
ADMISSION_TICKET Biglietto d'ingresso a uno zoo, può includere ulteriori componenti aggiuntivi.
SUPPLEMENTARY_ADDON Salta la fila senza entrare, audioguida senza ingresso.
Non correlata Crociera in barca che vede il PDI da lontano. Ufficio tour dove il tour inizia o è 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. tour guidati).

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 Cose da fare di Google, puoi compilare il modulo di richiesta di nuovi PDI di Cose da fare per richiedere l'aggiunta del PDI in Cose da fare.

Durante l'elaborazione di un feed in arrivo, Google tenta di abbinare i suggerimenti di località forniti come stringhe di testo a entità interne a Google che rappresentano queste località, note come punti di interesse (PDI).

Un PDI può essere definito in modo approssimativo come un segnaposto denominato in una posizione specifica (coordinate). Nel contesto di Cose da fare, alcuni esempi pertinenti sono gli operatori turistici e le attrazioni turistiche. Tuttavia, in generale, un PDI può essere qualsiasi azienda con un nome e una posizione noti a Google.

Con corrispondenza della località si intende il processo di associazione di una località correlata, sotto forma di un suggerimento di testo, a un PDI noto a Google, se esistente nel database di Google.

Esistono diversi modi per inviare una posizione correlata a Google, a seconda della fonte dei dati sulla posizione, dei requisiti contrattuali con i fornitori e del livello di controllo che si desidera avere sulla procedura 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.

L'ID 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 al 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 al domicilio del cliente o ibride, questo è il modo preferito per inviare queste sedi.
Informazioni sul luogo Rappresentazione strutturata di un PDI, che fornisce campi separati per il nome del luogo, i 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 località non ha un indirizzo preciso, ma può essere identificata da nome e coordinate, ad esempio un'attrazione o un tour operator situato in un'area remota come un deserto o una strada senza nome.
  • Se possibile, prediligi questo formato rispetto alla corrispondenza 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 PDI su Google.

Possono essere utilizzati gli endpoint dell'API Places, ad esempio Place Search o Place Autocomplete, oppure lo strumento Trova località corrispondenti nel Centro Cose da fare.
  • La posizione proviene dal fornitore o dal proprietario dei dati tramite uno strumento dell'interfaccia utente rivolto al fornitore, che potrebbe, ad esempio, utilizzare il completamento automatico dei luoghi 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 oppure preferisci non condividere le informazioni non elaborate dell'indirizzo.
  • Questo è il metodo preferito quando non è possibile ottenere un ID Profilo dell'attività dal proprietario del PDI e preferisci associare l'indirizzo a un PDI utilizzando l'API Places, anziché inviare le informazioni non elaborate sul luogo a Google.
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 a una località in modo che possa essere attivato negli annunci Cose da fare.
  • Questo formato non è adatto alla rappresentazione di un PDI. Per inviare le posizioni dei PDI utilizzando le coordinate, utilizza il formato Informazioni sul luogo.
Indirizzo Rappresenta la posizione di un PDI come indirizzo a una riga non strutturato, optionally including the place name.

Deprecato.
Questo formato non sarà più supportato a partire dal 1° maggio 2024.
  • Sarà necessario eseguire la migrazione di tutto l'utilizzo di questo formato al nuovo formato Informazioni sui luoghi, che include un campo obbligatorio per il nome del luogo e supporta i formati di indirizzo sia strutturati che non strutturati.
  • In alternativa, è possibile eseguire la migrazione dei suggerimenti relativi alla località interessati 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

Per eseguire la migrazione del campo address non strutturato esistente al nuovo campo place_info:

  1. Se i dati sugli indirizzi di cui disponi 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 sugli indirizzi di cui disponi sono strutturati:
    1. Aggiungi il nome dell'attività al campo place_info/name
    2. Aggiungi i dati dell'indirizzo, come street_address, postal_address in place_info/structured_address.
    3. Elimina il campo address esistente dal feed
    4. Vai al passaggio 3
  3. Aggiungi altri dati, come website_url e phone_number, per migliorare la precisione della corrispondenza