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 su 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, ad esempio 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_V2: restituisce una tabella contenente i conteggi dei luoghi e gli ID luogo di esempio. Questa funzione accetta un parametro table per l'input multiregionale, consentendo un'elaborazione batch efficiente. È altamente ottimizzata per i join geospaziali rispetto alle funzioni PLACES_COUNT e PLACES_COUNT_PER_GEO.
PLACES_COUNT_PER_TYPE_V2: Restituisce una tabella dei conteggi dei luoghi e degli ID luogo di esempio, suddivisi per tipo di luogo. Simile a PLACES_COUNT_V2, questa funzione accetta un parametro tabella per elaborare più geografie di input contemporaneamente. Questa architettura supporta l'elaborazione batch efficiente e fornisce un'unione geospaziale ottimizzata rispetto a PLACES_COUNT_PER_TYPE.
PLACES_COUNT_PER_H3: restituisce una tabella BigQuery dei conteggi dei luoghi per cella H3.
PLACES_COUNT: restituisce una singola riga contenente un conteggio dei luoghi.
Nota:per prestazioni notevolmente migliori ed elaborazione batch efficiente, utilizza PLACES_COUNT_V2.
PLACES_COUNT_PER_TYPE: restituisce una tabella BigQuery con i conteggi dei luoghi per tipo di luogo.
Nota:per un rendimento notevolmente migliore e un'elaborazione batch efficiente, utilizza PLACES_COUNT_PER_TYPE_V2.
PLACES_COUNT_PER_GEO: restituisce una tabella BigQuery con i conteggi dei luoghi per aree geografiche.
Nota:per prestazioni notevolmente migliori ed elaborazione batch efficiente, utilizza PLACES_COUNT_V2.

Oltre ai conteggi dei luoghi, tutte le funzioni, ad eccezione di PLACES_COUNT, restituiscono anche fino a 250 ID luogo per elemento della risposta.

Gli ID luogo possono essere utilizzati con:

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.

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 di filtro per un elenco completo di 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, utilizzando la funzione PLACES_COUNT_V2.

Innanzitutto, utilizza la tabella dell'area geografica di input o preparane una con le aree geografiche scelte:

-- Create a table for the input geographies
CREATE TABLE `PROJECT_NAME.YOUR_DATASET.my_search_areas` AS (
  SELECT
    '1' AS geo_id, -- Unique identifier
    ST_GEOGPOINT(-73.9857, 40.7484) AS geo -- Empire State Building
  UNION ALL
  SELECT
    '2' AS geo_id, -- Unique identifier
    ST_GEOGPOINT(-73.9851, 40.7580) AS geo -- Times Square
);

A questo punto, chiama PLACES_COUNT_V2 con la tabella e l'oggetto JSON contenente i filtri. Il raggio di ricerca è incluso nei filtri JSON e verrà applicato intorno a ogni punto della tabella my_search_areas.

SELECT * FROM `PROJECT_NAME.places_insights___us.PLACES_COUNT_V2`(
  TABLE `PROJECT_NAME.YOUR_DATASET.my_search_areas`,
  JSON_OBJECT(
      'geography_radius', 1000, -- Radius in meters around each point in 'geo'
      'business_status', ['OPERATIONAL'],
      'types', ["restaurant"],
      'min_rating', 1.3,
      'price_level', ['PRICE_LEVEL_INEXPENSIVE', 'PRICE_LEVEL_MODERATE'],
      'allows_dogs', TRUE
      )
);

Esempio di funzione Places Count

L'esempio seguente utilizza la funzione PLACES_COUNT_V2 con la tabella di input personalizzata my_search_area per restituire il numero di ristoranti operativi entro 1000 metri dall'Empire State Building e da Times Square a New York:

SELECT * FROM `PROJECT_NAME.places_insights___us.PLACES_COUNT_V2`(
  TABLE `PROJECT_NAME.YOUR_DATASET.my_search_areas`,
  JSON_OBJECT(
      'geography_radius', 1000, -- Radius in meters
      'business_status', ['OPERATIONAL'],
      'types', ["restaurant"]
      )
);

La risposta è una tabella BigQuery che contiene geo_id, la geografia, il conteggio e un campione di ID luogo.

Risultati per la funzione Conteggio luoghi a New York City.

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, consulta Visualizzare i risultati delle query.

Limitazioni e requisiti

Le funzioni di conteggio dei luoghi 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²).
Limite di dimensioni dell'input dei parametri: l'oggetto JSON passato come parametro alle funzioni è limitato a 1 MB. L'impatto di questo limite dipende dalla versione della funzione:
Per le funzioni V2 (PLACES_COUNT_V2, PLACES_COUNT_PER_TYPE_V2), questo limite si applica solo all'oggetto JSON dei filtri. Poiché le aree geografiche vengono fornite separatamente utilizzando un parametro della tabella, queste funzioni possono essere scalate a un numero molto maggiore di aree geografiche di input senza raggiungere il limite di dimensioni JSON.
- Per PLACES_COUNT_PER_H3, PLACES_COUNT, PLACES_COUNT_PER_TYPE e PLACES_COUNT_PER_GEO, questo limite si applica all'intero oggetto JSON, incluse tutte le definizioni geografiche. Ciò potrebbe limitare il numero di aree geografiche che possono essere elaborate in una singola chiamata.
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 tutti i paesi nel set di dati completo 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 la sottoscrizione. Per l'accesso al set di dati, consulta Configurare Places Insights.

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

Dati di esempio

Città e paese	Nomi delle tabelle
Buenos Aires, Argentina	`places_insights___ar___sample.FUNCTION_NAME`
Sydney, Australia	`places_insights___au___sample.FUNCTION_NAME`
Bad Gastein, Austria	`places_insights___at___sample.FUNCTION_NAME`
Riffa, Bahrein	`places_insights___bh___sample.FUNCTION_NAME`
Bruxelles, Belgio	`places_insights___be___sample.FUNCTION_NAME`
San Paolo, Brasile	`places_insights___br___sample.FUNCTION_NAME`
Plovdiv, Bulgaria	`places_insights___bg___sample.FUNCTION_NAME`
Toronto, Canada	`places_insights___ca___sample.FUNCTION_NAME`
Santiago, Cile	`places_insights___cl___sample.FUNCTION_NAME`
Medellín, Colombia	`places_insights___co___sample.FUNCTION_NAME`
Brno, Repubblica Ceca	`places_insights___cz___sample.FUNCTION_NAME`
Copenaghen, Danimarca	`places_insights___dk___sample.FUNCTION_NAME`
Il Cairo, Egitto	`places_insights___eg___sample.FUNCTION_NAME`
Helsinki, Finlandia	`places_insights___fi___sample.FUNCTION_NAME`
Parigi, Francia	`places_insights___fr___sample.FUNCTION_NAME`
Berlino, Germania	`places_insights___de___sample.FUNCTION_NAME`
Atene, Grecia	`places_insights___gr___sample.FUNCTION_NAME`
Hong Kong, Hong Kong	`places_insights___hk___sample.FUNCTION_NAME`
Debrecen, Ungheria	`places_insights___hu___sample.FUNCTION_NAME`
Mumbai, India	`places_insights___in___sample.FUNCTION_NAME`
Giacarta, Indonesia	`places_insights___id___sample.FUNCTION_NAME`
Cork, Irlanda	`places_insights___ie___sample.FUNCTION_NAME`
Tel Aviv-Yafo, Israele	`places_insights___il___sample.FUNCTION_NAME`
Roma, Italia	`places_insights___it___sample.FUNCTION_NAME`
Tokyo, Giappone	`places_insights___jp___sample.FUNCTION_NAME`
Busan, Corea del Sud	`places_insights___kr___sample.FUNCTION_NAME`
Kuala Lumpur, Malaysia	`places_insights___my___sample.FUNCTION_NAME`
Città del Messico, Messico	`places_insights___mx___sample.FUNCTION_NAME`
Amsterdam, Paesi Bassi	`places_insights___nl___sample.FUNCTION_NAME`
Wellington, Nuova Zelanda	`places_insights___nz___sample.FUNCTION_NAME`
Oslo, Norvegia	`places_insights___no___sample.FUNCTION_NAME`
Arequipa, Perù	`places_insights___pe___sample.FUNCTION_NAME`
Manila, Filippine	`places_insights___ph___sample.FUNCTION_NAME`
Varsavia, Polonia	`places_insights___pl___sample.FUNCTION_NAME`
Lisbona, Portogallo	`places_insights___pt___sample.FUNCTION_NAME`
Lusail, Qatar	`places_insights___qa___sample.FUNCTION_NAME`
Bucarest, Romania	`places_insights___ro___sample.FUNCTION_NAME`
Gedda, Arabia Saudita	`places_insights___sa___sample.FUNCTION_NAME`
Singapore, Singapore	`places_insights___sg___sample.FUNCTION_NAME`
Johannesburg, Sudafrica	`places_insights___za___sample.FUNCTION_NAME`
Madrid, Spagna	`places_insights___es___sample.FUNCTION_NAME`
Stoccolma, Svezia	`places_insights___se___sample.FUNCTION_NAME`
Zurigo, Svizzera	`places_insights___ch___sample.FUNCTION_NAME`
Taipei, Taiwan	`places_insights___tw___sample.FUNCTION_NAME`
Chiang Mai, Thailandia	`places_insights___th___sample.FUNCTION_NAME`
Ankara, Turchia	`places_insights___tr___sample.FUNCTION_NAME`
Sharjah, Emirati Arabi Uniti	`places_insights___ae___sample.FUNCTION_NAME`
Londra, Regno Unito	`places_insights___gb___sample.FUNCTION_NAME`
New York, Stati Uniti	`places_insights___us___sample.FUNCTION_NAME`
Hanoi, Vietnam	`places_insights___vn___sample.FUNCTION_NAME`

Tutti i dati

Paese	Nomi delle tabelle
Argentina	`places_insights___ar.FUNCTION_NAME`
Australia	`places_insights___au.FUNCTION_NAME`
Austria	`places_insights___at.FUNCTION_NAME`
Bahrein	`places_insights___bh.FUNCTION_NAME`
Belgio	`places_insights___be.FUNCTION_NAME`
Brasile	`places_insights___br.FUNCTION_NAME`
Bulgaria	`places_insights___bg.FUNCTION_NAME`
Canada	`places_insights___ca.FUNCTION_NAME`
Cile	`places_insights___cl.FUNCTION_NAME`
Colombia	`places_insights___co.FUNCTION_NAME`
Repubblica Ceca	`places_insights___cz.FUNCTION_NAME`
Danimarca	`places_insights___dk.FUNCTION_NAME`
Egitto	`places_insights___eg.FUNCTION_NAME`
Finlandia	`places_insights___fi.FUNCTION_NAME`
Francia	`places_insights___fr.FUNCTION_NAME`
Germania	`places_insights___de.FUNCTION_NAME`
Grecia	`places_insights___gr.FUNCTION_NAME`
Hong Kong	`places_insights___hk.FUNCTION_NAME`
Ungheria	`places_insights___hu.FUNCTION_NAME`
India	`places_insights___in.FUNCTION_NAME`
Indonesia	`places_insights___id.FUNCTION_NAME`
Irlanda	`places_insights___ie.FUNCTION_NAME`
Israele	`places_insights___il.FUNCTION_NAME`
Italia	`places_insights___it.FUNCTION_NAME`
Giappone	`places_insights___jp.FUNCTION_NAME`
Malaysia	`places_insights___my.FUNCTION_NAME`
Messico	`places_insights___mx.FUNCTION_NAME`
Paesi Bassi	`places_insights___nl.FUNCTION_NAME`
Nuova Zelanda	`places_insights___nz.FUNCTION_NAME`
Norvegia	`places_insights___no.FUNCTION_NAME`
Perù	`places_insights___pe.FUNCTION_NAME`
Filippine	`places_insights___ph.FUNCTION_NAME`
Polonia	`places_insights___pl.FUNCTION_NAME`
Portogallo	`places_insights___pt.FUNCTION_NAME`
Qatar	`places_insights___qa.FUNCTION_NAME`
Romania	`places_insights___ro.FUNCTION_NAME`
Arabia Saudita	`places_insights___sa.FUNCTION_NAME`
Singapore	`places_insights___sg.FUNCTION_NAME`
Sudafrica	`places_insights___za.FUNCTION_NAME`
Corea del Sud	`places_insights___kr.FUNCTION_NAME`
Spagna	`places_insights___es.FUNCTION_NAME`
Svezia	`places_insights___se.FUNCTION_NAME`
Svizzera	`places_insights___ch.FUNCTION_NAME`
Taiwan	`places_insights___tw.FUNCTION_NAME`
Thailandia	`places_insights___th.FUNCTION_NAME`
Turchia	`places_insights___tr.FUNCTION_NAME`
Emirati Arabi Uniti	`places_insights___ae.FUNCTION_NAME`
Regno Unito	`places_insights___gb.FUNCTION_NAME`
Stati Uniti	`places_insights___us.FUNCTION_NAME`
Vietnam	`places_insights___vn.FUNCTION_NAME`