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

Le funzioni di conteggio dei luoghi sono query SQL predefinite che vengono 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 Conteggio 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 di conteggio dei luoghi per le stesse città e gli stessi paesi per cui hai

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 qui. 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 di conteggio dei 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 di conteggio dei luoghi

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 passare questo valore al parametro geography. Inoltre, passa 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 in 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 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²).
• 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 di conteggio dei 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.