Función PLACES_COUNT_PER_TYPE

La función PLACES_COUNT_PER_TYPE muestra una tabla de recuentos para cada tipo de lugar especificado en la función. Por ejemplo, si buscas los tipos doctor, hospital y pharmacy, la respuesta contiene una tabla con una fila separada para cada tipo.

Como la función PLACES_COUNT_PER_TYPE muestra una tabla, llámala con una cláusula FROM.

• Parámetros de entrada:

  • Obligatorio: El geography parámetro de filtro que especifica el área de búsqueda. El parámetro geography toma un valor definido por el tipo de datos GEOGRAPHY de BigQuery, que admite puntos, cadenas de líneas y polígonos.

    Para ver ejemplos del uso de diferentes tipos de geografías de búsqueda, como ventanas gráficas y líneas, consulta la función PLACES_COUNT.

  • Obligatorio: El types parámetro de filtro que especifica los tipos de lugar que se deben buscar.

  • Opcional: Parámetros de filtro adicionales para definir mejor la búsqueda.

• Se muestra lo siguiente:

  • Una tabla con una fila por cada valor de types. La tabla contiene las columnas type (STRING), count (INT64) y place_ids (ARRAY<STRING>), en las que place_ids contiene hasta 250 IDs de lugar para cada type.

Ejemplo: Muestra el recuento de restaurantes, cafeterías y bares

En este ejemplo, se buscan todos los restaurantes, cafeterías y bares operativos en el área de búsqueda especificada definida como un polígono en la ciudad de Nueva York.

El parámetro types toma un array de valores STRING que especifican los tipos de lugar que se deben buscar. Para obtener la lista completa de valores posibles, consulta Tipos de lugar.

En este ejemplo, también se usa la ST_GEOGFROMTEXT función de BigQuery para mostrar un valor GEOGRAPHY de un polígono.

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 `PROJECT_NAME.places_insights___us.PLACES_COUNT_PER_TYPE`(
  JSON_OBJECT(
      'types', ["restaurant", "cafe", "bar"],
      'geography', geo,
      'business_status', ['OPERATIONAL']
      )
);

Esta función muestra una tabla con tres filas, una por tipo:

Ejemplo: Muestra recuentos por tipo filtrados por marca

En el siguiente ejemplo, se usa el filtro brand_ids para recuperar recuentos de tipos para marcas específicas, como Starbucks con el ID "1413758728321880760":

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 `PROJECT_NAME.places_insights___us.PLACES_COUNT_PER_TYPE`(
  JSON_OBJECT(
      'types', ["cafe", "restaurant"],
      'geography', geo,
      'brand_ids', ["1413758728321880760"], -- Filter for Starbucks
      'business_status', ['OPERATIONAL']
      )
);