Funzione PLACES_COUNT_PER_GEO

Nota: per prestazioni notevolmente migliori ed 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 del filtro geographies che specifica l'area di ricerca. Il geographies parametro 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: calcolare 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 di risposta 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 Visualizzare i risultati. Per ulteriori informazioni ed esempi sulla visualizzazione dei risultati di Places Insights, consulta Visualizzare i risultati delle query.

Questo esempio utilizza il United States Census Bureau Data BigQuery set di dati pubblico 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 quindi la funzione ST_SIMPLIFY di BigQuery per restituire una versione semplificata di county_geom. La funzione ST_SIMPLIFY sostituisce le catene di bordi quasi rettilinee con un singolo 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"]
      )
);

La risposta per la funzione:

Visualizzare i risultati

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

Per importare i dati in Looker Studio:

1. Esegui la funzione 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 di report predefinita e la inizializza con un titolo, una tabella e un grafico a barre dei risultati.

   

4. Seleziona tutto nella pagina ed eliminalo.

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

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

   

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

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