Posizione e punto d'interesse

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

Ogni prodotto option può specificare uno o più punti d'interesse (PDI) relativi all'opzione utilizzando il campo related_location (contenente un elenco di RelatedLocation oggetti). Ogni oggetto RelatedLocation contiene un elemento 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 le viste di un PDI, ad esempio, 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 il luogo è una piazza evidenziata in un tour della città.

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

  • SUPPLEMENTARY_ADDON: la relazione dichiara un servizio aggiuntivo che non indirizza l'utente nella località correlata. Ad esempio, il biglietto per il parcheggio, una mostra temporanea.

Esempi

relation_type Esempio
RELATED_NO_ADMISSION Tour a piedi della Torre Eiffel senza ingresso. Tour in elicottero intorno al Burj Khalifa.
ADMISSION_TICKET Il biglietto d'ingresso a uno zoo può includere altri componenti aggiuntivi.
SUPPLEMENTARY_ADDON Salta la fila senza entrare e audioguida senza entrare.
Non correlato Crociera in barca che vede il PDI da lontano. Ufficio del tour dove inizia il tour o è possibile acquistare il biglietto.

Ogni prodotto option può anche avere un meeting_point per tipi di tour specifici in cui il luogo di partenza non è chiaro e deve essere determinato (ad es. tour guidati).

Come richiedere l'aggiunta di una nuova attrazione

Se fornisci i biglietti ufficiali per le attrazioni e ti accorgi che una delle attrazioni con cui stai lavorando non è presente in Google Cose da fare, puoi compilare il modulo di richiesta nuovi PDI di TTD per richiedere l'aggiunta del PDI in Cose da fare.

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

Un PDI può essere definito a grandi linee come un segnaposto con nome su una posizione specifica (coordinate). Nell'ambito di Cose da fare, esempi pertinenti includono tour operator e attrazioni turistiche; tuttavia, in generale, un PDI può essere qualsiasi attività il cui nome e la località siano noti a Google.

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

Esistono diversi modi per inviare una località correlata a Google, a seconda della fonte dei dati sulla posizione, degli obblighi 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 suggerimenti

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

Può essere ottenuto direttamente dal proprietario dell'attività solo 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 avrà esito positivo solo se la sede dell'attività è stata verificata da Google.

Oltre ai PDI, questo formato supporta anche i tipi di aree coperte dal servizio e di attività 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 area coperta dal servizio o ibride, questo è il modo preferito per inviare queste località.
Informazioni sul luogo Rappresentazione strutturata di un PDI, con 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 località viene fornita dal fornitore o dal proprietario dei dati sotto forma di indirizzo, ad esempio utilizzando uno strumento rivolto ai fornitori.
  • Il luogo non ha un indirizzo preciso, ma può essere identificato mediante nome e coordinate, ad esempio un'attrazione o tour operator situato in un'area remota come un deserto o una strada senza nome.
  • Quando possibile, prediligi questo formato rispetto alla corrispondenza dell'indirizzo con 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 delle corrispondenze.
ID luogo Identifica in modo univoco un PDI su Google.

Può essere ricavato utilizzando gli endpoint dell'API Places, ad esempio Place Search o Place Autocomplete, oppure manualmente lo strumento Find Location Matches nel Centro Cose da fare.
  • La località proviene dal fornitore o dal proprietario dei dati mediante 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 non elaborate dell'indirizzo.
  • Questo è il metodo preferito se 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 a Google le informazioni non elaborate sul luogo.
Latitudine e longitudine Identifica in modo approssimativo una regione geografica o geopolitica, come una città, una località o una destinazione di viaggio.
  • Utilizza questo formato se vuoi inviare una posizione approssimativa che non rappresenta alcun PDI specifico. Ad esempio, quando vuoi associare un prodotto a una città o una località in modo che il prodotto possa essere attivato negli annunci di Cose da fare.
  • Questo formato non è adatto per rappresentare un PDI. Per inviare le località dei PDI utilizzando le coordinate, utilizza il formato delle informazioni sul luogo.
Indirizzo Rappresenta una località del PDI come un indirizzo non strutturato a una riga, che facoltativamente include il nome del luogo.

Deprecato.
Questo formato non sarà più supportato a partire dal 1° maggio 2024.
  • Qualsiasi utilizzo di questo formato dovrà eseguire la migrazione al nuovo formato di informazioni sul luogo, che include un campo obbligatorio per il nome del luogo e supporta i formati degli indirizzi strutturati e non strutturati.
  • In alternativa, puoi eseguire la migrazione dei suggerimenti relativi alle località interessate 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 degli indirizzi 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. Rilascia il campo address esistente dal feed
    4. Vai al passaggio 3
  2. Se i dati dell'indirizzo in tuo possesso sono strutturati:
    1. Aggiungi il nome dell'attività al campo place_info/name
    2. Aggiungi le informazioni dell'indirizzo, come street_address, postal_address, in place_info/structured_address.
    3. Rilascia 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 delle corrispondenze