Consulta el conjunto de datos con las funciones de Places Count

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 el 0, pero exigen un área de búsqueda mínima de 40 m por 40 m (1,600 m²). Las funciones también pueden devolver IDs de lugar, que se pueden usar para buscar información sobre lugares individuales.

Te recomendamos que uses 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 Places Count para las mismas ciudades y países a los que tienes acceso.

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 en Funciones de recuento de lugares de referencia en BigQuery. 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 la función 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 Places Count, 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 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. Validate Places Insights data using sample Place IDs 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 Places Insights.

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 consultas.

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 la posición 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 Places Count para las ciudades y los países a los que te suscribiste. Consulta Cómo configurar Places Insights para acceder al conjunto de datos.
• Los parámetros de filtro (por ejemplo, geography o types) distinguen mayúsculas de minúsculas y deben coincidir exactamente con los nombres de los parámetros. De lo contrario, la consulta fallará.

Referencia a las funciones de recuento de lugares en BigQuery

Todas las ciudades del conjunto de datos de muestra y el conjunto de datos completo de países admiten las funciones de recuento de lugares.

Tienes acceso a las funciones de recuento de lugares correspondientes a los conjuntos de datos de ciudades y países a los que te suscribiste. Consulta Configura Places Insights para acceder a los conjuntos de datos.

Nota: 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 del proyecto de forma opcional. Si no se incluye uno, la consulta se establecerá de forma predeterminada en el proyecto activo.

En estas tablas, se enumeran las ciudades y los países disponibles, y sus nombres de tabla correspondientes.

Datos de muestra

Ciudad, país	Nombres de tablas
Buenos Aires, Argentina	places_insights___ar___sample.FUNCTION_NAME
Sídney, Australia	places_insights___au___sample.FUNCTION_NAME
Bad Gastein, Austria	places_insights___at___sample.FUNCTION_NAME
Riffa, Baréin	places_insights___bh___sample.FUNCTION_NAME
Bruselas, Bélgica	places_insights___be___sample.FUNCTION_NAME
São Paulo, Brasil	places_insights___br___sample.FUNCTION_NAME
Plovdiv, Bulgaria	places_insights___bg___sample.FUNCTION_NAME
Toronto, Canadá	places_insights___ca___sample.FUNCTION_NAME
Santiago, Chile	places_insights___cl___sample.FUNCTION_NAME
Medellín, Colombia	places_insights___co___sample.FUNCTION_NAME
Brno, República Checa	places_insights___cz___sample.FUNCTION_NAME
Copenhague, Dinamarca	places_insights___dk___sample.FUNCTION_NAME
El Cairo, Egipto	places_insights___eg___sample.FUNCTION_NAME
Helsinki, Finlandia	places_insights___fi___sample.FUNCTION_NAME
París, Francia	places_insights___fr___sample.FUNCTION_NAME
Berlín, Alemania	places_insights___de___sample.FUNCTION_NAME
Atenas, Grecia	places_insights___gr___sample.FUNCTION_NAME
Hong Kong, Hong Kong	places_insights___hk___sample.FUNCTION_NAME
Debrecen, Hungría	places_insights___hu___sample.FUNCTION_NAME
Bombay, India	places_insights___in___sample.FUNCTION_NAME
Yakarta, Indonesia	places_insights___id___sample.FUNCTION_NAME
Cork, Irlanda	places_insights___ie___sample.FUNCTION_NAME
Tel Aviv-Yafo, Israel	places_insights___il___sample.FUNCTION_NAME
Roma, Italia	places_insights___it___sample.FUNCTION_NAME
Tokio, Japón	places_insights___jp___sample.FUNCTION_NAME
Busán, Corea del Sur	places_insights___kr___sample.FUNCTION_NAME
Kuala Lumpur, Malasia	places_insights___my___sample.FUNCTION_NAME
Ciudad de México, México	places_insights___mx___sample.FUNCTION_NAME
Ámsterdam, Países Bajos	places_insights___nl___sample.FUNCTION_NAME
Wellington, Nueva Zelanda	places_insights___nz___sample.FUNCTION_NAME
Oslo, Noruega	places_insights___no___sample.FUNCTION_NAME
Arequipa, Perú	places_insights___pe___sample.FUNCTION_NAME
Manila, Filipinas	places_insights___ph___sample.FUNCTION_NAME
Varsovia, Polonia	places_insights___pl___sample.FUNCTION_NAME
Lisboa, Portugal	places_insights___pt___sample.FUNCTION_NAME
Lusail, Catar	places_insights___qa___sample.FUNCTION_NAME
Bucarest, Rumania	places_insights___ro___sample.FUNCTION_NAME
Yidda, Arabia Saudita	places_insights___sa___sample.FUNCTION_NAME
Singapur, Singapur	places_insights___sg___sample.FUNCTION_NAME
Johannesburgo, Sudáfrica	places_insights___za___sample.FUNCTION_NAME
Madrid, España	places_insights___es___sample.FUNCTION_NAME
Estocolmo, Suecia	places_insights___se___sample.FUNCTION_NAME
Zúrich, Suiza	places_insights___ch___sample.FUNCTION_NAME
Taipéi, Taiwán	places_insights___tw___sample.FUNCTION_NAME
Chiang Mai, Tailandia	places_insights___th___sample.FUNCTION_NAME
Ankara, Türkiye	places_insights___tr___sample.FUNCTION_NAME
Sharjah, Emiratos Árabes Unidos	places_insights___ae___sample.FUNCTION_NAME
Londres, Reino Unido	places_insights___gb___sample.FUNCTION_NAME
Ciudad de Nueva York, Estados Unidos	places_insights___us___sample.FUNCTION_NAME
Hanói, Vietnam	places_insights___vn___sample.FUNCTION_NAME

Datos completos

País	Nombres de tablas
Argentina	places_insights___ar.FUNCTION_NAME
Australia	places_insights___au.FUNCTION_NAME
Austria	places_insights___at.FUNCTION_NAME
Baréin	places_insights___bh.FUNCTION_NAME
Bélgica	places_insights___be.FUNCTION_NAME
Brasil	places_insights___br.FUNCTION_NAME
Bulgaria	places_insights___bg.FUNCTION_NAME
Canadá	places_insights___ca.FUNCTION_NAME
Chile	places_insights___cl.FUNCTION_NAME
Colombia	places_insights___co.FUNCTION_NAME
República Checa	places_insights___cz.FUNCTION_NAME
Dinamarca	places_insights___dk.FUNCTION_NAME
Egipto	places_insights___eg.FUNCTION_NAME
Finlandia	places_insights___fi.FUNCTION_NAME
Francia	places_insights___fr.FUNCTION_NAME
Alemania	places_insights___de.FUNCTION_NAME
Grecia	places_insights___gr.FUNCTION_NAME
Hong Kong	places_insights___hk.FUNCTION_NAME
Hungría	places_insights___hu.FUNCTION_NAME
India	places_insights___in.FUNCTION_NAME
Indonesia	places_insights___id.FUNCTION_NAME
Irlanda	places_insights___ie.FUNCTION_NAME
Israel	places_insights___il.FUNCTION_NAME
Italia	places_insights___it.FUNCTION_NAME
Japón	places_insights___jp.FUNCTION_NAME
Malasia	places_insights___my.FUNCTION_NAME
México	places_insights___mx.FUNCTION_NAME
Países Bajos	places_insights___nl.FUNCTION_NAME
Nueva Zelanda	places_insights___nz.FUNCTION_NAME
Noruega	places_insights___no.FUNCTION_NAME
Perú	places_insights___pe.FUNCTION_NAME
Filipinas	places_insights___ph.FUNCTION_NAME
Polonia	places_insights___pl.FUNCTION_NAME
Portugal	places_insights___pt.FUNCTION_NAME
Catar	places_insights___qa.FUNCTION_NAME
Rumania	places_insights___ro.FUNCTION_NAME
Arabia Saudita	places_insights___sa.FUNCTION_NAME
Singapur	places_insights___sg.FUNCTION_NAME
Sudáfrica	places_insights___za.FUNCTION_NAME
Corea del Sur	places_insights___kr.FUNCTION_NAME
España	places_insights___es.FUNCTION_NAME
Suecia	places_insights___se.FUNCTION_NAME
Suiza	places_insights___ch.FUNCTION_NAME
Taiwán	places_insights___tw.FUNCTION_NAME
Tailandia	places_insights___th.FUNCTION_NAME
Türkiye	places_insights___tr.FUNCTION_NAME
Emiratos Árabes Unidos	places_insights___ae.FUNCTION_NAME
Reino Unido	places_insights___gb.FUNCTION_NAME
Estados Unidos	places_insights___us.FUNCTION_NAME
Vietnam	places_insights___vn.FUNCTION_NAME