Descripción general de las funciones de recuento de lugares

Las funciones de recuento de lugares son otra forma de consultar los datos de Places disponibles en Places Insights. Estas funciones son consultas de SQL predefinidas que se ejecutan en BigQuery y complementan las consultas de datos de lugares. La principal diferencia es que las funciones no aplican un umbral de recuento mínimo, sino que aplican un área de búsqueda mínima:

• Las consultas de conjuntos de datos de lugares solo pueden devolver recuentos superiores a 5, pero no aplican limitaciones en el tamaño del área de búsqueda.

• Las funciones de recuento de lugares pueden devolver cualquier recuento, incluido 0, pero exigen un área de búsqueda mínima de 40.0 metros por 40.0 metros (1,600 m²).

Es posible que desees usar las funciones de recuento de lugares si es importante saber cuándo una búsqueda no devuelve resultados o si necesitas conocer recuentos bajos de lugares inferiores a 5. Por ejemplo, poder devolver recuentos bajos es importante para los casos de uso de selección de sitios.

Funciones y países admitidos para el recuento de lugares

Places Insights admite las siguientes funciones:

• PLACES_COUNT: Muestra una sola fila que contiene un recuento de lugares.
• PLACES_COUNT_PER_TYPE: Devuelve una tabla de BigQuery con los recuentos de lugares por tipo de lugar.
• PLACES_COUNT_PER_GEO: Devuelve una tabla de BigQuery con los recuentos de lugares por ubicación geográfica.
• PLACES_COUNT_PER_H3: Devuelve una tabla de BigQuery con los recuentos de lugares por celda H3.

Junto con los recuentos de lugares, las funciones PLACES_COUNT_PER_TYPE, PLACES_COUNT_PER_GEO y PLACES_COUNT_PER_H3 también devuelven hasta 250 IDs de lugar por elemento de la respuesta.

Al igual que los conjuntos de datos de lugares, las funciones de recuento de lugares están disponibles para las ciudades más importantes de cada uno de los países admitidos. Por ejemplo, en el caso de Australia, puedes acceder a las funciones de recuento de lugares para Sídney, Australia.

Para obtener la lista completa de ciudades y países admitidos, consulta Funciones de recuento de lugares de referencia en BigQuery.

Ejemplo de función de recuento de lugares

En el siguiente ejemplo, se usa la función PLACES_COUNT para devolver la cantidad de restaurantes operativos en un radio de 1,000 metros del Empire State Building en la ciudad de Nueva York:

SELECT `maps-platform-analytics-hub.sample_places_insights_us.PLACES_COUNT`(
  JSON_OBJECT(
      'geography', ST_GEOGPOINT(-73.9857, 40.7484), -- Empire State Building
      'geography_radius', 1000, -- Radius in meters
      'business_status', ['OPERATIONAL'],
      'types', ["restaurant"]
      )
) as count;

La respuesta contiene un solo recuento:

En este ejemplo, la sentencia SELECT hace referencia a la función PLACES_COUNT para Estados Unidos con la siguiente sintaxis:

maps-platform-analytics-hub.sample_places_insights_us.PLACES_COUNT

Para obtener la lista completa de ciudades y países admitidos, consulta Funciones de recuento de lugares de referencia en BigQuery.

Usa un JSON_OBJECT para pasar argumentos a la función. En este ejemplo, se usa la función ST_GEOGPOINT de BigQuery para devolver un valor GEOGRAPHY de un punto y, luego, pasar ese valor al parámetro geography. También pasa el radio de búsqueda alrededor del punto y el tipo de lugar, "restaurant", para buscar.

Ejemplo de recuento de lugares por tipo, ubicación geográfica o H3

Junto con los recuentos de lugares, las funciones PLACES_COUNT_PER_TYPE, PLACES_COUNT_PER_GEO y PLACES_COUNT_PER_H3 también devuelven hasta 250 IDs de lugares incluidos en la respuesta.

Por ejemplo, la función PLACES_COUNT_PER_TYPE devuelve una tabla de recuentos de lugares por tipo de lugar. La respuesta incluye un array de IDs de lugar para los lugares que coinciden con cada tipo. Puedes usar los IDs de lugar que se muestran para buscar información sobre cada lugar.

La siguiente llamada a la función devuelve un recuento de lugares con los tipos restaurant, cafe y bar:

SELECT * FROM `maps-platform-analytics-hub.sample_places_insights_us.PLACES_COUNT_PER_TYPE`(
  JSON_OBJECT(
      'geography', ST_GEOGPOINT(-73.9857, 40.7484), -- Empire State Building
      'geography_radius', 1000, -- Radius in meters
      'types', ["restaurant", "cafe", "bar"],
      'business_status', ['OPERATIONAL']
      )
);

Esta función devuelve una tabla con tres columnas: type, count y sample_place_ids. Las columnas count muestran el recuento de lugares para cada type, y la columna sample_place_ids muestra hasta 250 IDs de lugar para cada type.

Aplica filtros a la función

Aplica filtros para limitar los criterios de búsqueda. Las funciones de recuento de lugares admiten muchos filtros para definir mejor tu búsqueda. En el siguiente ejemplo, aplicarás filtros para limitar la búsqueda por calificación mínima del usuario, nivel de precios, estado de la empresa y si el restaurante permite perros:

SELECT `maps-platform-analytics-hub.sample_places_insights_us.PLACES_COUNT`(
  JSON_OBJECT(
      'geography', ST_GEOGPOINT(-73.9857, 40.7484), -- Empire State Building
      'geography_radius', 1000, -- Radius in meters
      'business_status', ['OPERATIONAL'],
      'types', ["restaurant"],
      'min_rating', 1.3,
      'price_level', ['PRICE_LEVEL_INEXPENSIVE', 'PRICE_LEVEL_MODERATE'],
      'allows_dogs', TRUE
      )
) as count;

Visualizar los resultados

Las herramientas de análisis y de inteligencia empresarial son fundamentales para ayudarte a descubrir estadísticas a partir de tus datos de BigQuery. BigQuery admite varias herramientas de visualización de datos de Google y de terceros que puedes usar para analizar los resultados de tus funciones en los datos de Estadísticas de Places.

Para ver un ejemplo de cómo visualizar los resultados de una función, consulta Visualiza los resultados. Para obtener más información y ver un ejemplo de cómo visualizar los resultados de Places Insights, consulta Visualiza los resultados de las búsquedas.

Limitaciones y requisitos

Las funciones de recuento de lugares tienen las siguientes limitaciones y requisitos:

• Solo se admiten las estadísticas de COUNT.
• Se requiere un área de búsqueda mínima de 40.0 metros por 40.0 metros (1,600 m²).
• El tamaño de entrada del parámetro de recuento de funciones de lugar está limitado a 1 MB.
• No se admite el filtrado por ID de lugar ni por componente de dirección.

Compara las funciones de recuento de lugares y las consultas de conjuntos de datos de lugares

En la siguiente tabla, se enumeran las diferencias clave:

Funciones de recuento de lugares de referencia en BigQuery

Las funciones de recuento de lugares admiten las siguientes ciudades y países. Debes suscribirte a cada ciudad y país por separado.