Consulta el conjunto de datos con funciones de recuento de lugares

Las funciones de recuento de lugares son consultas en SQL predefinidas que se ejecutan en BigQuery y complementan la consulta directa del conjunto de datos. La principal diferencia entre consultar los datos directamente y usar una función 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 de 5 o más, 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²). Las funciones también pueden devolver IDs de lugar, que se pueden usar para buscar información sobre lugares individuales.

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. También es útil si necesitas obtener información de lugares individuales para verificar tus resultados.

Las funciones de recuento de lugares solo proporcionan recuentos, por lo que, si necesitas realizar consultas más complejas, como combinaciones de datos, o bien obtener estadísticas adicionales, como la calificación promedio de un grupo de lugares, consulta el conjunto de datos directamente.

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 de 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. Consulta todos los parámetros de filtro.

Los IDs de lugar se pueden usar con lo siguiente:

• API de Places (nueva)
• API de Geocoding
• Places UI Kit

Nota: Puedes acceder a las funciones de recuento de lugares para las mismas ciudades y países para los que tienes

Escribe consultas con funciones

Usa el siguiente formato para llamar a las funciones: [project name (optional)].[table name].[function name].

Si cambiaste el nombre del conjunto de datos vinculado cuando configuraste Places Insights, usa tu nombre personalizado en lugar de los nombres de tabla predeterminados que se indican aquí. También puedes incluir el nombre de tu proyecto de forma opcional. Si no se incluye uno, la consulta se establecerá de forma predeterminada en el proyecto activo.

Por ejemplo:

PROJECT_NAME.places_insights___us.PLACES_COUNT

Usa un JSON_OBJECT para pasar argumentos a la función.

Nota: Cuando usas una función de recuento de lugares, la función se especifica en la cláusula FROM y se omite WITH_AGGREGATION_THRESHOLD.

Cómo filtrar tus resultados

Las funciones de recuento de lugares admiten muchos filtros para definir mejor tu búsqueda. Estos parámetros (por ejemplo, price_level o types) distinguen mayúsculas de minúsculas y deben coincidir exactamente con los nombres de los parámetros. Consulta la referencia de los parámetros de filtro para obtener una lista completa de opciones.

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 admite perros:

SELECT `PROJECT_NAME.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;

Nota: Incluye el filtro business_status para asegurarte de obtener el recuento de las empresas OPERATIONAL. De lo contrario, el recuento incluye los negocios cerrados.

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 `PROJECT_NAME.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, 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.

Nota: Los parámetros obligatorios y opcionales difieren para cada función de recuento de lugares, como se describe en filtros.

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 lugar para los 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 siguientes tipos: restaurant, cafe y bar:

SELECT * FROM `PROJECT_NAME.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.

Nota: Para obtener información sobre un lugar, usa el ID de lugar para llamar a la API de Places o al kit de IU de Places. Cómo validar los datos de Places Insights con IDs de lugares de muestra proporciona un ejemplo.

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 Estadísticas de Lugares, 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 lugares está limitado a 1 MB.
• No se admite el filtrado por ID de lugar, marcas, opciones de carga de VE ni componente de dirección.
• Solo puedes acceder a las funciones de recuento de lugares para las ciudades y los países a los que te suscribiste. Consulta Cómo configurar Estadísticas de Lugares para acceder a los conjuntos de datos.
• Los parámetros de filtro (por ejemplo, geography o types) distinguen entre mayúsculas y minúsculas, y deben coincidir exactamente con los nombres de los parámetros. De lo contrario, la consulta fallará.