Funzione PLACES_COUNT_V2

La funzione PLACES_COUNT_V2 restituisce una tabella BigQuery contenente i conteggi dei luoghi e gli ID luogo di esempio per più aree geografiche di input in base ai filtri specificati. Questa funzione è progettata per l'elaborazione batch efficiente accettando un input parametro tabella delle aree geografiche, consentendoti di analizzare molte aree di interesse in una singola query fornendo le aree geografiche tramite una tabella di input.

Sintassi

SELECT * FROM `PROJECT_NAME.LINKED_DATASET_NAME.PLACES_COUNT_V2`(
  TABLE input_geographies,
  filters
)

Parametri

• PROJECT_NAME: il nome del tuo progetto Google Cloud.
• LINKED_DATASET_NAME: il nome del set di dati BigQuery contenente le funzioni di Places Insights (ad es. places_insights___us).
• input_geographies: una tabella BigQuery contenente le aree geografiche da analizzare. Questa tabella deve includere le seguenti colonne:
  • geo_id (STRING): un identificatore univoco per ogni area geografica.
  • geo (GEOGRAPHY): l'oggetto GEOGRAPHY di BigQuery che rappresenta l'area. Può essere un punto, un poligono o un altro tipo di area geografica.
• filters (JSON): un oggetto JSON contenente coppie chiave-valore per filtrare i luoghi. Vedi Parametri dei filtri.

Schema della tabella di output

La funzione PLACES_COUNT_V2 restituisce una tabella con le seguenti colonne:

Come funziona

La funzione elabora ogni riga della tabella input_geographies. Per ogni geo oggetto, conta il numero di luoghi che rientrano nell'area geografica (o nel il geography_radius se il geo è un punto e il raggio è specificato nel il filters). Il conteggio include solo i luoghi che soddisfano tutte le condizioni definite nell'oggetto JSON filters.

Esempio: calcola il numero di ristoranti in tre contee di New York

Questo esempio genera una tabella con il numero di ristoranti operativi in tre contee di New York.

Questo esempio utilizza il United States Census Bureau Data BigQuery set di dati pubblici per ottenere i confini di tre contee di New York: "Queens", "Kings" e "New York". I confini di ogni contea sono contenuti nella colonna county_geom.

Creiamo prima una tabella temporanea new_york_counties per contenere geo_id e GEOGRAPHY semplificata per ogni contea.

SELECT *
FROM `PROJECT_NAME.places_insights___us.PLACES_COUNT_V2`(
  (
    SELECT
      county_name AS geo_id,
      ST_SIMPLIFY(county_geom, 100) AS geo
    FROM
      `bigquery-public-data.geo_us_boundaries.counties`
    WHERE
      state_fips_code = "36"  -- New York State
      AND county_name IN ("Queens", "Kings", "New York")
  ),
  JSON_OBJECT(
      'types', ["restaurant"],
      'business_status', ['OPERATIONAL']
  )
);

La tabella di risposta avrà tre righe, una per ogni contea, che mostrano geo_id, input_geography, place_count e sample_place_ids dei ristoranti operativi.

Vantaggi dell'utilizzo di PLACES_COUNT_V2

PLACES_COUNT_V2 offre vantaggi significativi rispetto a PLACES_COUNT e PLACES_COUNT_PER_GEO:

• Elaborazione batch: analizza in modo efficiente migliaia di aree geografiche personalizzate in una singola query fornendo più input di aree geografiche in una tabella.
• Prestazioni: utilizza i join geospaziali ottimizzati di BigQuery offrendo vantaggi di velocità significativi per i set di dati di grandi dimensioni.
• Scalabilità: progettata per gestire un numero elevato di aree geografiche di input senza le limitazioni delle dimensioni di un singolo parametro JSON.
• Conteggi zero inclusi: PLACES_COUNT_V2 restituisce una riga per ogni geo_id fornito nella tabella di input. Se nessun luogo soddisfa i criteri per una determinata area geografica, place_count sarà 0. In questo modo, avrai un risultato per ogni area di input, così potrai vedere dove non sono presenti luoghi.