Le funzioni di conteggio dei luoghi sono un altro modo per eseguire query sui dati di Places disponibili in Places Insights. Queste funzioni sono query SQL predefinite che vengono eseguite in BigQuery e sono complementari alle query sui dati sui luoghi. La differenza principale è che le funzioni non impongono una soglia di conteggio minimo, ma un'area di ricerca minima:
Le query sui set di dati sui luoghi possono restituire solo conteggi 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 m2).
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. Ad esempio, la possibilità di restituire conteggi bassi è importante per i casi d'uso della selezione dei siti.
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.
Analogamente ai set di dati sui luoghi, le funzioni di conteggio dei luoghi sono disponibili per una città principale per ciascuno dei paesi supportati. Ad esempio, per l'Australia, puoi accedere alle funzioni di conteggio dei luoghi per Sydney, Australia.
Per l'elenco completo delle città e dei paesi supportati, consulta Funzioni di conteggio dei luoghi di riferimento in BigQuery.
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 `maps-platform-analytics-hub.sample_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:
In questo esempio, l'istruzione SELECT fa riferimento alla funzione PLACES_COUNT
per gli Stati Uniti utilizzando la sintassi:
maps-platform-analytics-hub.sample_places_insights_us.PLACES_COUNT
Per l'elenco completo di città e paesi supportati, vedi Funzioni di conteggio dei luoghi di riferimento in BigQuery.
Utilizza un
JSON_OBJECT
per passare gli argomenti alla funzione. 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.
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 `maps-platform-analytics-hub.sample_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.
Applica filtri alla funzione
Applica filtri per restringere i criteri di ricerca. Le funzioni di conteggio dei luoghi supportano molti filtri per perfezionare la ricerca. Nell'esempio successivo applichi i 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 `maps-platform-analytics-hub.sample_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;
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 m2).
- La dimensione dell'input del parametro di conteggio delle funzioni di posizionamento è limitata a 1 MB.
- Nessun supporto per il filtro per ID luogo o componente di indirizzo.
Confrontare le funzioni di conteggio dei luoghi e le query sui set di dati dei luoghi
La seguente tabella elenca le principali differenze:
| Funzioni di conteggio dei luoghi | Query sui set di dati sui luoghi | |
|---|---|---|
| Interfaccia | Quattro funzioni SQL predefinite che generano approfondimenti COUNT: conteggio singolo, conteggio per tipo, conteggio per area geografica, conteggio per cella H3. |
Utilizza SQL per eseguire funzioni di aggregazione come COUNT, COUNT_IF, SUM e AVG.. È possibile generare ulteriori approfondimenti utilizzando JOIN, GROUP BY, WHERE e altre funzioni. |
| Restrizioni | Impone un'area di ricerca minima di 40 metri per 40 metri (1600 m2). Una funzione restituisce un risultato anche se il conteggio dell'aggregazione è inferiore a 5, purché venga soddisfatta l'area di ricerca minima. | Applica una soglia di conteggio di 5, ma nessuna area di ricerca minima. |
| Filtri degli attributi supportati | Schema completo supportato, ad eccezione di:
|
Schema completo supportato |
| Vantaggi |
|
|
Funzioni di conteggio dei luoghi di riferimento in BigQuery
Le funzioni di conteggio dei luoghi supportano le seguenti città e paesi. Devi iscriverti a ogni città e paese separatamente.
| Città e paese | Nomi delle tabelle |
|---|---|
| Sydney, Australia | maps-platform-analytics-hub.sample_places_insights_au.FUNCTION_NAME |
| San Paolo, Brasile | maps-platform-analytics-hub.sample_places_insights_br.FUNCTION_NAME |
| Toronto, Canada | maps-platform-analytics-hub.sample_places_insights_ca.FUNCTION_NAME |
| Parigi, Francia | maps-platform-analytics-hub.sample_places_insights_fr.FUNCTION_NAME |
| Berlino, Germania | maps-platform-analytics-hub.sample_places_insights_de.FUNCTION_NAME |
| Londra, Gran Bretagna | maps-platform-analytics-hub.sample_places_insights_gb.FUNCTION_NAME |
| Mumbai, India | maps-platform-analytics-hub.sample_places_insights_in.FUNCTION_NAME |
| Giacarta, Indonesia | maps-platform-analytics-hub.sample_places_insights_id.FUNCTION_NAME |
| Roma, Italia | maps-platform-analytics-hub.sample_places_insights_it.FUNCTION_NAME |
| Tokyo, Giappone | maps-platform-analytics-hub.sample_places_insights_jp.FUNCTION_NAME |
| Città del Messico, Messico | maps-platform-analytics-hub.sample_places_insights_mx.FUNCTION_NAME |
| Madrid, Spagna | maps-platform-analytics-hub.sample_places_insights_es.FUNCTION_NAME |
| Zurigo, Svizzera | maps-platform-analytics-hub.sample_places_insights_ch.FUNCTION_NAME |
| New York, Stati Uniti | maps-platform-analytics-hub.sample_places_insights_us.FUNCTION_NAME |