Funzione PLACES_COUNT_PER_TYPE

La funzione PLACES_COUNT_PER_TYPE restituisce una tabella di conteggi per ogni tipo di luogo specificato nella funzione. Ad esempio, se cerchi i tipi doctor, hospital e pharmacy, la risposta contiene una tabella con una riga separata per ogni tipo.

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

• Parametri di input:

  • Obbligatorio: il geography parametro di filtro che specifica l'area di ricerca. Il parametro geography accetta un valore definito dal tipo di dati GEOGRAPHY di BigQuery, che supporta punti, linestring e poligoni.

    Per esempi di utilizzo di diversi tipi di aree geografiche di ricerca, come viewport e linee, consulta la funzione PLACES_COUNT.

  • Obbligatorio: il types parametro di filtro che specifica i tipi di luoghi da cercare.

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

• Restituisce:

  • Una tabella con una riga per ogni valore di types. La tabella contiene le colonne type (STRING), count (INT64) e sample_place_ids (ARRAY<STRING>), dove sample_place_ids contiene fino a 250 ID luogo per ogni type.

Esempio: numero di risultati per ristoranti, bar e caffè

In questo esempio, cerchi tutti i ristoranti, i caffè e i bar operativi nell'area di ricerca specificata definita come un poligono a New York City.

Il parametro types accetta un array di valori STRING che specificano i tipi di luogo da cercare. Per l'elenco completo dei valori possibili, consulta Tipi di luoghi.

Questo esempio utilizza anche la funzione ST_GEOGFROMTEXT di BigQuery per restituire un valore GEOGRAPHY da un poligono.

DECLARE geo GEOGRAPHY;
SET geo = ST_GEOGFROMTEXT('''POLYGON((-73.985708 40.75773,-73.993324 40.750298,
                                      -73.9857 40.7484,-73.9785 40.7575,
                                      -73.985708 40.75773))''');  -- NYC viewport

SELECT * FROM `places_insights___us___sample.PLACES_COUNT_PER_TYPE`(
  JSON_OBJECT(
      'types', ["restaurant", "cafe", "bar"],
      'geography', geo,
      'business_status', ['OPERATIONAL']
      )
);

Questa funzione restituisce una tabella con tre righe, una per tipo: