Funzione PLACES_COUNT_PER_GEO

Nota: per prestazioni significativamente migliori e un'elaborazione batch efficiente, utilizza PLACES_COUNT_V2.

La funzione PLACES_COUNT_PER_GEO accetta un array di aree geografiche in cui eseguire la ricerca e restituisce una tabella dei conteggi dei luoghi per area. Ad esempio, se specifichi un array di codici postali come area di ricerca, la risposta contiene una tabella con una riga separata per ogni codice postale.

Poiché la funzione PLACES_COUNT_PER_GEO restituisce una tabella, chiamala utilizzando una clausola FROM.

• Parametri di input:

  • Obbligatorio: il parametro filter geographies che specifica l'area di ricerca. Il parametro geographies accetta un array di valori definiti dal tipo di dati GEOGRAPHY di BigQuery, che supporta punti, stringhe di linee e poligoni.

  • (Facoltativo) Parametri di filtro aggiuntivi per perfezionare la ricerca.

• Restituisce:

  • Una tabella con una riga per area geografica. La tabella contiene le colonne geography (GEOGRAPHY), count (INT64) e place_ids (ARRAY<STRING>), dove place_ids contiene fino a 250 ID luogo per ogni area geografica.

Esempio: calcola il numero di ristoranti in ogni contea di New York City

Questo esempio genera una tabella dei conteggi dei ristoranti operativi per contea a New York City.

Nota: poiché la tabella delle risposte contiene un campo geographies, puoi visualizzarla utilizzando strumenti che supportano i tipi GEOGRAPHY di BigQuery. Per un esempio di visualizzazione dei risultati di una funzione, consulta Visualizza i risultati. Per ulteriori informazioni ed esempi sulla visualizzazione dei risultati di Places Insights, consulta Visualizza i risultati delle query.

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

Questo esempio utilizza poi la funzione ST_SIMPLIFY di BigQuery per restituire una versione semplificata di county_geom. La funzione ST_SIMPLIFY sostituisce le catene di bordi quasi dritti con un unico bordo lungo.

DECLARE geos ARRAY<GEOGRAPHY>;

SET geos = (SELECT ARRAY_AGG(ST_SIMPLIFY(county_geom, 100))
            FROM `bigquery-public-data.geo_us_boundaries.counties`
            WHERE county_name IN ("Queens","Kings", "New York") AND state_fips_code = "36");

SELECT * FROM `PROJECT_NAME.places_insights___us.PLACES_COUNT_PER_GEO`(
  JSON_OBJECT(
      'geographies', geos,
      'types', ["restaurant"],
      'business_status', ["OPERATIONAL"]
      )
);

Esempio: calcola i conteggi per contea filtrati per brand

L'esempio seguente utilizza il filtro brand_ids per recuperare i conteggi dei luoghi e gli ID luogo di esempio per brand specifici, come Starbucks "1413758728321880760":

DECLARE geos ARRAY<GEOGRAPHY>;

SET geos = (SELECT ARRAY_AGG(ST_SIMPLIFY(county_geom, 100))
            FROM `bigquery-public-data.geo_us_boundaries.counties`
            WHERE county_name IN ("Queens","Kings", "New York") AND state_fips_code = "36");

SELECT * FROM `PROJECT_NAME.places_insights___us.PLACES_COUNT_PER_GEO`(
  JSON_OBJECT(
      'geographies', geos,
      'brand_ids', ["1413758728321880760"], -- Filter for Starbucks
      'business_status', ["OPERATIONAL"]
      )
);

Visualizzare i risultati

Le seguenti immagini mostrano questi dati visualizzati in Looker Studio come mappa coropletica, incluso il contorno di ogni contea:

Per importare i dati in Looker Studio:

1. Esegui la funzione riportata sopra per generare i risultati.

2. Nei risultati di BigQuery, fai clic su Apri in -> Looker Studio. I risultati vengono importati automaticamente in Looker Studio.

3. Looker Studio crea una pagina del report predefinita e la inizializza con un titolo, una tabella e un grafico a barre dei risultati.

   

4. Seleziona tutti i contenuti della pagina ed eliminali.

5. Fai clic su Inserisci -> Mappa coropletica per aggiungere una mappa coropletica al report.

6. In Tipi di grafici -> Configurazione, configura i campi come mostrato di seguito:

   

7. La mappa colorata viene visualizzata come sopra. Se vuoi, puoi selezionare Tipi di grafico -> Stili per configurare ulteriormente l'aspetto della mappa.

Per ulteriori informazioni ed esempi sulla visualizzazione dei risultati di Places Insights, consulta Visualizza i risultati delle query.