Guida alla migrazione

Importante: questa guida è destinata agli utenti che eseguono la migrazione dalla versione di anteprima iniziale. Tutti gli altri utenti utilizzano già le schede e non devono eseguire la migrazione.

Questa release di Places Insights del 4 settembre 2025 include le seguenti modifiche rispetto alla release iniziale:

• Supporta la possibilità di abbonarsi a Places Insights nella posizione BigQuery di tua scelta.

• Sposta i set di dati Places Insights dalle data clean room agli elenchi BigQuery Data Exchange.

• I campi indirizzo nello schema del set di dati separano i campi id e name in campi stringa o array di stringhe discreti.

Nota:per usufruire dei nuovi campi dell'indirizzo, devi eseguire la migrazione alle schede. Se decidi di non eseguire la migrazione alle schede e di continuare a utilizzare le data clean room, continua a utilizzare i campi indirizzo e lo schema del set di dati della release iniziale.

Eseguire la migrazione alle schede

La release di anteprima iniziale di Places Insights ha eseguito il deployment dei dati nelle data clean room di BigQuery. Con la release del 4 settembre 2025, abbiamo spostato i set di dati negli elenchi di BigQuery per consentirti di abbonarti al set di dati in una regione BigQuery specifica. Questa modifica non influisce sulle funzionalità del prodotto e sull'usabilità di Places Insights.

Per abbonarti a Places Insights in una regione specifica, devi abbonarti ai nuovi elenchi nella condivisione BigQuery. Una volta effettuato l'abbonamento ai nuovi elenchi, non è necessario modificare le query SQL. Continueranno a funzionare allo stesso modo.

• Nuovi utenti:se non hai mai utilizzato Places Insights, segui i passaggi descritti in Configurare Places Insights per configurare l'ambiente di sviluppo per l'accesso alle schede.

• Utenti esistenti:segui i passaggi riportati di seguito per eseguire la migrazione all'utilizzo delle schede

Nota: se sei un cliente esistente, non è necessario eseguire la migrazione alle schede durante l'anteprima. Tuttavia, quando Places Insights diventerà disponibile a livello generale, supporterà solo le schede.

Passi per la migrazione

Per eseguire la migrazione alle schede devi:

1. Iscriviti agli annunci della città e del paese che hai scelto. Per istruzioni, vedi Configurare Places Insights.

   Nota: quando configuri Places Insights, imposta il nome del set di dati in modo da utilizzare la tua convenzione di denominazione. Se lasci il nome del set di dati predefinito, si verificherà un conflitto con il nome della data clean room legacy.

2. Aggiorna il nome del set di dati nelle query o nelle funzioni con il nome del set di dati che hai scelto sopra.

3. Se in precedenza hai utilizzato funzioni, rimuovi il nome del progetto utilizzato con le data clean room (maps-platform-analytics-hub).

4. Modifica le query o le funzioni esistenti per includere il nome del progetto (facoltativo) e i nuovi campi dell'indirizzo.

Includi il nome del progetto quando fai riferimento alla scheda (facoltativo)

Con le schede, puoi includere il nome del progetto nella query. Se non specifichi un nome del progetto, la query utilizzerà per impostazione predefinita il progetto attivo.

Ti consigliamo di includere il nome del progetto se hai collegato set di dati con lo stesso nome in progetti diversi o se stai eseguendo query su una tabella al di fuori del progetto attivo.

Esempio di query aggiornata con il nome del progetto e del set di dati

Questa query include un nome di progetto e utilizza il nome del set di dati my_dataset_name:

SELECT WITH AGGREGATION_THRESHOLD
COUNT(*) AS count
FROM `PROJECT_NAME.my_dataset_name.places`

Esegui la migrazione ai nuovi campi dell'indirizzo

Nella versione iniziale di Places Insights, lo schema del set di dati rappresentava un campo indirizzo come STRUCT o RECORD contenente un campo secondario id e name. Questa release appiattisce lo schema per definire campi separati di primo livello per id e name. I nuovi campi sono campi stringa o array di stringhe.

Nota: per sfruttare i nuovi campi indirizzo, devi eseguire la migrazione dalle clean room dei dati alle schede. Se decidi di non eseguire la migrazione alle schede, continua a utilizzare i campi dell'indirizzo della release iniziale.

Ad esempio, lo schema del componente dell'indirizzo della località per la release iniziale è mostrato di seguito:

locality		STRUCT
	locality.id	STRING
	locality.name	STRING

In questa release, il set di dati ora contiene due campi di array di stringhe di primo livello. Ad esempio, di seguito è mostrato lo schema dei dati della località aggiornato:

locality_ids	ARRAY<string>
locality_names	ARRAY<string>

Consulta il riferimento allo schema completo.

Nota :non tutti i campi sono disponibili in tutti i paesi. Per l'elenco specifico dei campi disponibili per il tuo paese, consulta il riferimento allo schema specifico per paese.

Campi non di array

In questa release, i campi id e name ora sono campi STRING di primo livello per i campi indirizzo non di tipo array:

administrative_area_level_1_id	STRING
administrative_area_level_1_name	STRING

Questo nuovo formato si applica a tutti i campi del modulo administrative_area_level_N, dove N è un numero compreso tra 1 e 7.

Nota: non tutti i campi administrative_area_level_N sono disponibili in tutti i paesi. Per l'elenco specifico dei campi disponibili per il tuo paese, consulta il riferimento allo schema specifico per paese.

Esempio di utilizzo dei nuovi campi

Nella release iniziale di Places Insights, utilizzavi il campo administrative_area_level_1.name in una clausola WHERE per filtrare i risultati:

SELECT WITH AGGREGATION_THRESHOLD
COUNT(*) AS count
FROM `PROJECT_NAME.places_insights___us.places`
WHERE administrative_area_level_1.name = "New York";

Con i nuovi campi, scrivi la query utilizzando il campo administrative_area_level_1_name:

SELECT WITH AGGREGATION_THRESHOLD
COUNT(*) AS count
FROM `PROJECT_NAME.places_insights___us.places`
WHERE administrative_area_level_1_name = "New York";