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:

• science PLACES_COUNT_V2: Devuelve una tabla que contiene recuentos de lugares y muestras de IDs de lugares. Esta función acepta un parámetro de tabla para la entrada de varias ubicaciones geográficas, lo que permite un procesamiento por lotes eficiente. Está altamente optimizada para las uniones geoespaciales en comparación con las funciones PLACES_COUNT y PLACES_COUNT_PER_GEO.
• science PLACES_COUNT_PER_TYPE_V2: Devuelve una tabla de recuentos de lugares y ejemplos de IDs de lugar, categorizados por tipo de lugar. Al igual que PLACES_COUNT_V2, esta función acepta un parámetro de tabla para procesar varias ubicaciones geográficas de entrada de forma simultánea. Esta arquitectura admite el procesamiento por lotes eficiente y proporciona una unión geoespacial optimizada en comparación con PLACES_COUNT_PER_TYPE.
• PLACES_COUNT_PER_H3: Devuelve una tabla de BigQuery con los recuentos de lugares por celda H3.
• 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.

Junto con los recuentos de lugares, todas las funciones, excepto PLACES_COUNT, también devuelven hasta 250 IDs de lugar por elemento de la respuesta.

Los IDs de lugar se pueden usar con lo siguiente:

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

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.

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 permite perros, con la función PLACES_COUNT_V2.

Primero, usa tu tabla de ubicaciones geográficas de entrada o prepara una con las ubicaciones geográficas elegidas:

-- Create a table for the input geographies
CREATE TABLE `PROJECT_NAME.YOUR_DATASET.my_search_areas` AS (
  SELECT
    '1' AS geo_id, -- Unique identifier
    ST_GEOGPOINT(-73.9857, 40.7484) AS geo -- Empire State Building
  UNION ALL
  SELECT
    '2' AS geo_id, -- Unique identifier
    ST_GEOGPOINT(-73.9851, 40.7580) AS geo -- Times Square
);

A continuación, llama a PLACES_COUNT_V2 con la tabla y el objeto JSON que contiene los filtros. El radio de búsqueda se incluye en los filtros JSON y se aplicará alrededor de cada punto de la tabla my_search_areas.

SELECT * FROM `PROJECT_NAME.places_insights___us.PLACES_COUNT_V2`(
  TABLE `PROJECT_NAME.YOUR_DATASET.my_search_areas`,
  JSON_OBJECT(
      'geography_radius', 1000, -- Radius in meters around each point in 'geo'
      'business_status', ['OPERATIONAL'],
      'types', ["restaurant"],
      'min_rating', 1.3,
      'price_level', ['PRICE_LEVEL_INEXPENSIVE', 'PRICE_LEVEL_MODERATE'],
      'allows_dogs', TRUE
      )
);

Ejemplo de la función Recuento de lugares

En el siguiente ejemplo, se usa la función PLACES_COUNT_V2 con la tabla de geografía de entrada personalizada my_search_area para devolver la cantidad de restaurantes operativos a menos de 1,000 metros del Empire State Building y Times Square en la ciudad de Nueva York:

SELECT * FROM `PROJECT_NAME.places_insights___us.PLACES_COUNT_V2`(
  TABLE `PROJECT_NAME.YOUR_DATASET.my_search_areas`,
  JSON_OBJECT(
      'geography_radius', 1000, -- Radius in meters
      'business_status', ['OPERATIONAL'],
      'types', ["restaurant"]
      )
);

La respuesta es una tabla de BigQuery que contiene el geo_id, la geografía, el recuento y una muestra de los IDs de lugar.

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²).
• Límite de tamaño de entrada de parámetros: El objeto JSON que se pasa como parámetro a las funciones está limitado a 1 MB. El impacto de este límite depende de la versión de la función:
• Para las funciones de la versión 2 (PLACES_COUNT_V2, PLACES_COUNT_PER_TYPE_V2), este límite solo se aplica al objeto JSON de los filtros. Dado que las ubicaciones geográficas se proporcionan por separado con un parámetro de tabla, estas funciones pueden escalar a una cantidad mucho mayor de ubicaciones geográficas de entrada sin alcanzar el límite de tamaño de JSON.
  • En el caso de PLACES_COUNT_PER_H3, PLACES_COUNT, PLACES_COUNT_PER_TYPE y PLACES_COUNT_PER_GEO, este límite se aplica a todo el objeto JSON, incluidas todas las definiciones de geografía. Esto puede limitar la cantidad de ubicaciones geográficas que se pueden procesar en una sola llamada.
• 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.

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

Datos de muestra

Datos completos