Función PLACES_COUNT_PER_TYPE

La función PLACES_COUNT_PER_TYPE devuelve 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 devuelve una tabla, llámala con una cláusula FROM.

  • Parámetros de entrada:

    • Obligatorio: El parámetro de filtro geography 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 ubicaciones geográficas de búsqueda, como ventanas gráficas y líneas, consulta la función PLACES_COUNT.

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

    • Opcional: Son parámetros de filtro adicionales para definir mejor tu 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 sample_place_ids (ARRAY<STRING>), en la que sample_place_ids contiene hasta 250 IDs de lugar para cada type.

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

En este ejemplo, buscas todos los restaurantes, las cafeterías y los bares operativos en el área de búsqueda especificada, que se define 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 los valores posibles, consulta las tablas A y B en Tipos de lugares.

En este ejemplo, también se usa la función ST_GEOGFROMTEXT de BigQuery para devolver un valor GEOGRAPHY a partir 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 `maps-platform-analytics-hub.sample_places_insights_us.PLACES_COUNT_PER_TYPE`(
  JSON_OBJECT(
      'types', ["restaurant", "cafe", "bar"],
      'geography', geo,
      'business_status', ['OPERATIONAL']
      )
);

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

Resultados de la función Place Count Type en la ciudad de Nueva York.