Esegui una query sul set di dati utilizzando le funzioni di conteggio dei luoghi

Le funzioni di conteggio dei luoghi sono query SQL predefinite eseguite in BigQuery e sono complementari all'esecuzione di query direttamente sul set di dati. La differenza principale tra l'esecuzione di query sui dati direttamente e l'utilizzo di una funzione è che le funzioni non impongono una soglia minima di conteggio, ma una superficie di ricerca minima:

• Le query sui set di dati sui luoghi possono restituire solo conteggi pari o superiori a 5, ma non impongono limitazioni alle dimensioni dell'area di ricerca.
• Le funzioni di conteggio dei luoghi possono restituire qualsiasi conteggio, incluso 0, ma impongono un'area di ricerca minima di 40 x 40 metri (1600 m²). Le funzioni possono anche restituire ID luogo, che possono essere utilizzati per cercare informazioni sui singoli luoghi.

Potresti voler utilizzare le funzioni di conteggio dei luoghi se è importante sapere quando una query non restituisce risultati o se hai bisogno di conoscere conteggi bassi di luoghi inferiori a 5. È utile anche se devi ottenere informazioni individuali sui luoghi per controllare i risultati.

Le funzioni di conteggio dei luoghi forniscono solo conteggi, quindi se devi eseguire query più complesse come unioni di dati o ottenere ulteriori approfondimenti come la valutazione media di un gruppo di luoghi, esegui query direttamente sul set di dati.

Funzioni e paesi supportati per il conteggio dei luoghi

Places Insights supporta le seguenti funzioni:

• PLACES_COUNT: restituisce una singola riga contenente un conteggio dei luoghi.
• PLACES_COUNT_PER_TYPE: restituisce una tabella BigQuery con i conteggi dei luoghi per tipo di luogo.
• PLACES_COUNT_PER_GEO: restituisce una tabella BigQuery con i conteggi dei luoghi per aree geografiche.
• PLACES_COUNT_PER_H3: restituisce una tabella BigQuery con i conteggi dei luoghi per cella H3.

Oltre ai conteggi dei luoghi, le funzioni PLACES_COUNT_PER_TYPE, PLACES_COUNT_PER_GEO e PLACES_COUNT_PER_H3 restituiscono anche fino a 250 ID luogo per elemento della risposta. Visualizza tutti i parametri di filtro.

Gli ID luogo possono essere utilizzati con:

• API Places (New)
• API Geocoding
• Places UI Kit

Nota: puoi accedere alle funzioni Conteggio luoghi per le stesse città e gli stessi paesi a cui hai accesso.

Scrivere query con funzioni

Utilizza il seguente formato per chiamare le funzioni: [project name (optional)].[table name].[function name].

Se hai modificato il nome del set di dati collegato durante la configurazione di Places Insights, utilizza il nome personalizzato anziché i nomi delle tabelle predefiniti elencati in Funzioni di conteggio dei luoghi di riferimento in BigQuery. Puoi anche includere facoltativamente il nome del progetto. Se non ne viene incluso uno, la query utilizzerà per impostazione predefinita il progetto attivo.

Ad esempio:

PROJECT_NAME.places_insights___us.PLACES_COUNT

Utilizza un JSON_OBJECT per passare argomenti alla funzione.

Nota: quando utilizzi una funzione di conteggio dei luoghi, la funzione viene specificata nella clausola FROM e WITH_AGGREGATION_THRESHOLD viene omesso.

Filtrare i risultati

Le funzioni Conteggio luoghi supportano molti filtri per perfezionare la ricerca. Questi parametri (ad esempio price_level o types) sono sensibili alle maiuscole e devono corrispondere esattamente ai nomi dei parametri. Consulta il riferimento ai parametri del filtro per un elenco completo delle opzioni.

Nell'esempio successivo applichi filtri per limitare la ricerca in base alla valutazione minima degli utenti, al livello di prezzo, allo stato dell'attività e alla possibilità di portare cani nel ristorante:

SELECT `PROJECT_NAME.places_insights___us.PLACES_COUNT`(
  JSON_OBJECT(
      'geography', ST_GEOGPOINT(-73.9857, 40.7484), -- Empire State Building
      'geography_radius', 1000, -- Radius in meters
      'business_status', ['OPERATIONAL'],
      'types', ["restaurant"],
      'min_rating', 1.3,
      'price_level', ['PRICE_LEVEL_INEXPENSIVE', 'PRICE_LEVEL_MODERATE'],
      'allows_dogs', TRUE
      )
) as count;

Nota: includi il filtro business_status per assicurarti di ottenere il conteggio delle attività OPERATIONAL. In caso contrario, il conteggio include le attività chiuse.

Esempio di funzione Places Count

L'esempio seguente utilizza la funzione PLACES_COUNT per restituire il numero di ristoranti operativi entro 1000 metri dall'Empire State Building a New York:

SELECT `PROJECT_NAME.places_insights___us.PLACES_COUNT`(
  JSON_OBJECT(
      'geography', ST_GEOGPOINT(-73.9857, 40.7484), -- Empire State Building
      'geography_radius', 1000, -- Radius in meters
      'business_status', ['OPERATIONAL'],
      'types', ["restaurant"]
      )
) as count;

La risposta contiene un singolo conteggio:

Questo esempio utilizza la funzione BigQuery ST_GEOGPOINT per restituire un valore GEOGRAPHY da un punto e poi passarlo al parametro geography. Viene passato anche il raggio di ricerca intorno al punto e il tipo di luogo, "restaurant", da cercare.

Nota :i parametri obbligatori e facoltativi variano per ogni funzione di conteggio dei luoghi come descritto nei filtri.

Esempio di conteggio dei luoghi per tipo, posizione geografica o H3

Oltre ai conteggi dei luoghi, le funzioni PLACES_COUNT_PER_TYPE, PLACES_COUNT_PER_GEO e PLACES_COUNT_PER_H3 restituiscono anche fino a 250 ID luogo per i luoghi inclusi nella risposta.

Ad esempio, la funzione PLACES_COUNT_PER_TYPE restituisce una tabella dei conteggi dei luoghi per tipo di luogo. La risposta include un array di ID luogo per i luoghi che corrispondono a ogni tipo. Puoi utilizzare gli ID luogo restituiti per cercare informazioni su ogni luogo.

La seguente chiamata di funzione restituisce un conteggio dei luoghi con i tipi: restaurant, cafe e bar:

SELECT * FROM `PROJECT_NAME.places_insights___us.PLACES_COUNT_PER_TYPE`(
  JSON_OBJECT(
      'geography', ST_GEOGPOINT(-73.9857, 40.7484), -- Empire State Building
      'geography_radius', 1000, -- Radius in meters
      'types', ["restaurant", "cafe", "bar"],
      'business_status', ['OPERATIONAL']
      )
);

Questa funzione restituisce una tabella con tre colonne: type, count e sample_place_ids. Le colonne count mostrano il conteggio dei luoghi per ogni type, mentre la colonna sample_place_ids mostra fino a 250 ID luogo per ogni type.

Nota: per ottenere informazioni su un luogo, utilizza l'ID luogo per chiamare l'API Places o il kit UI Places. Convalida i dati di Places Insights utilizzando ID luogo di esempio fornisce un esempio.

Visualizzare i risultati

Gli strumenti di analisi e business intelligence sono fondamentali per aiutarti a scoprire insight dai tuoi dati BigQuery. BigQuery supporta diversi strumenti di visualizzazione dei dati di Google e di terze parti che puoi utilizzare per analizzare i risultati delle tue funzioni sui dati di Places Insights.

Per un esempio di visualizzazione dei risultati di una funzione, consulta Visualizzare i risultati. Per ulteriori informazioni ed esempi sulla visualizzazione dei risultati di Places Insights, vedi Visualizzare i risultati delle query.

Limitazioni e requisiti

Le funzioni Places Count presentano i seguenti limiti e requisiti:

• Sono supportati solo gli approfondimenti COUNT.
• È richiesta un'area di ricerca minima di 40 metri per 40 metri (1600 m²).
• La dimensione dell'input del parametro di conteggio delle funzioni di posizionamento è limitata a 1 MB.
• Nessun supporto per il filtro in base a ID luogo, brand, opzioni di ricarica EV o componente dell'indirizzo.
• Puoi accedere alle funzioni Conteggio luoghi solo per le città e i paesi a cui hai effettuato l'iscrizione. Per l'accesso al set di dati, consulta Configurare Places Insights.
• I parametri di filtro (ad esempio geography o types) fanno distinzione tra maiuscole e minuscole e devono corrispondere esattamente ai nomi dei parametri, altrimenti la query non andrà a buon fine.

Funzioni di conteggio dei luoghi di riferimento in BigQuery

Tutte le città nel set di dati di esempio e il set di dati completo dei paesi supportano le funzioni di conteggio dei luoghi.

Hai accesso alle funzioni Conteggio luoghi corrispondenti ai set di dati di città e paesi a cui hai eseguito l'iscrizione. Per l'accesso al set di dati, consulta Configurare Places Insights.

Nota :se hai modificato il nome del set di dati collegato durante la configurazione di Places Insights, utilizza il nome personalizzato anziché i nomi delle tabelle predefiniti elencati qui. Puoi anche includere facoltativamente il nome del progetto. Se non ne viene incluso uno, la query utilizzerà per impostazione predefinita il progetto attivo.

Queste tabelle elencano le città, i paesi disponibili e i nomi delle tabelle corrispondenti.

Dati di esempio

Città e paese	Nomi delle tabelle
Sydney, Australia	places_insights___au___sample.FUNCTION_NAME
San Paolo, Brasile	places_insights___br___sample.FUNCTION_NAME
Toronto, Canada	places_insights___ca___sample.FUNCTION_NAME
Parigi, Francia	places_insights___fr___sample.FUNCTION_NAME
Berlino, Germania	places_insights___de___sample.FUNCTION_NAME
Mumbai, India	places_insights___in___sample.FUNCTION_NAME
Giacarta, Indonesia	places_insights___id___sample.FUNCTION_NAME
Roma, Italia	places_insights___it___sample.FUNCTION_NAME
Tokyo, Giappone	places_insights___jp___sample.FUNCTION_NAME
Città del Messico, Messico	places_insights___mx___sample.FUNCTION_NAME
Madrid, Spagna	places_insights___es___sample.FUNCTION_NAME
Zurigo, Svizzera	places_insights___ch___sample.FUNCTION_NAME
Londra, Regno Unito	places_insights___gb___sample.FUNCTION_NAME
New York, Stati Uniti	places_insights___us___sample.FUNCTION_NAME

Tutti i dati

Paese	Nomi delle tabelle
Australia	places_insights___au.FUNCTION_NAME
Brasile	places_insights___br.FUNCTION_NAME
Canada	places_insights___ca.FUNCTION_NAME
Francia	places_insights___fr.FUNCTION_NAME
Germania	places_insights___de.FUNCTION_NAME
India	places_insights___in.FUNCTION_NAME
Indonesia	places_insights___id.FUNCTION_NAME
Italia	places_insights___it.FUNCTION_NAME
Giappone	places_insights___jp.FUNCTION_NAME
Messico	places_insights___mx.FUNCTION_NAME
Spagna	places_insights___es.FUNCTION_NAME
Svizzera	places_insights___ch.FUNCTION_NAME
Regno Unito	places_insights___gb.FUNCTION_NAME
Stati Uniti	places_insights___us.FUNCTION_NAME