Acerca de los datos y las consultas de Places Insights

Datos de Estadísticas de Places

Places Insights proporciona conjuntos de datos completos y de muestra en BigQuery.

Los conjuntos de datos de muestra están diseñados para que pruebes Places Insights y puedas evaluar la usabilidad y el valor del producto antes de decidir comprar el conjunto de datos completo. El conjunto de datos de muestra solo contiene datos de la ciudad. No contiene datos del área metropolitana circundante.

La muestra de la ficha incluye los datos de una ciudad principal de cada uno de los países admitidos: Sídney (AU), São Paulo (BR), Toronto (CA), Zúrich (CH), Berlín (DE), Madrid (ES), París (FR), Londres (UK), Yakarta (ID), Mumbai (IN), Roma (IT), Tokio (JP), Ciudad de México (MX) y Ciudad de Nueva York (US).

Los conjuntos de datos completos incluyen datos de cada país admitido y se deben comprar. Si te interesa comprar el conjunto de datos completo, completa el formulario de solicitud. Solo el suscriptor de datos debe solicitar acceso al conjunto de datos de Places Insights. Una vez que la suscripción esté activa en un proyecto de BigQuery, cualquier usuario con acceso a ese proyecto podrá consultar los datos de Places Insights.

Cada conjunto de datos de país tiene su propia ficha a la que debes suscribirte por separado. Para obtener más información sobre cómo suscribirte a una ficha, consulta Configura Places Insights.

Esquemas de conjuntos de datos

El esquema del conjunto de datos de lugares para cada país consta de dos partes:

• El esquema principal que es común a los conjuntos de datos de todos los países.
• Un esquema específico del país que define los componentes del esquema específicos de ese país.

Por ejemplo, si trabajas con el conjunto de datos de España (ES), haz referencia tanto al esquema principal como al esquema específico de ES.

El esquema del conjunto de datos de marcas define tres campos:

• id: Es el ID de la marca.
• name: Es el nombre de la marca, como "Hertz" o "Chase".
• category: Es la categoría de nivel superior de la marca, como "Estación de servicio", "Comida y bebida" o "Alojamiento".

Consultar datos de Places Insights

Places Insights ofrece dos formas de consultar los conjuntos de datos:

• Consultar el conjunto de datos directamente con SQL: Ejecuta consultas de SQL estándar de BigQuery en las tablas del conjunto de datos. Esto proporciona la mayor flexibilidad para el filtrado complejo, la unión con tus propios datos, el análisis personalizado y la compatibilidad con funciones de agregación adicionales más allá de COUNT, como AVG, SUM y GROUP BY. Consulta la documentación.
• Consulta el conjunto de datos con las funciones de recuento de lugares: Las funciones de recuento de lugares son consultas de SQL predefinidas y optimizadas que se ejecutan directamente en BigQuery y simplifican las tareas comunes de recuperación de datos. Proporcionan estadísticas más detalladas, como IDs de lugar que se devuelven para buscar detalles sobre lugares individuales. Consulta la documentación.

Consultas directas

Consultar los datos directamente aplica un umbral de agregación. Solo se devuelve un resultado si la búsqueda agrega al menos 5 lugares. Por ejemplo, si el resultado de tus criterios de búsqueda es un recuento de 0, 1, 2, 3 o 4, el resultado se omite de la respuesta. Por ejemplo, una búsqueda del recuento total de restaurantes en un área determinada solo devolverá una respuesta si el recuento total es 5 o más. De lo contrario, no se devolverá ninguna respuesta.

Coloca consultas de la función de recuento de lugares

Las funciones de recuento de lugares pueden devolver una lista de IDs de lugar, que se pueden usar para buscar información de lugares individuales con otros productos de GMP, como la API de Places y el kit de IU de Places.

Las funciones de recuento de lugares no aplican un umbral de agregación, sino que aplican un área de búsqueda mínima de 40.0 metros por 40.0 metros (1,600 m²). Esto significa que, siempre y cuando tu búsqueda sea más grande que el área de búsqueda mínima, siempre obtendrás un resultado, incluso si no hay lugares que coincidan con tu búsqueda.

Cuándo consultar los datos directamente y cuándo usar funciones

Consulta los datos directamente si no necesitas recuentos de resultados bajos, si deseas obtener estadísticas más allá de los recuentos, como AVG, SUM o COUNTIF, o si necesitas realizar consultas más complejas, como unir conjuntos de datos.

Realiza consultas con las funciones si necesitas saber si hay una cantidad baja o nula de resultados, o si necesitas recuperar información de lugares individuales, como el nombre o la dirección.

En esta tabla, se proporciona una comparación detallada de las diferencias entre las búsquedas directas y las funciones de recuento de lugares.

	Funciones de conteo de lugares	Consultas directas de conjuntos de datos
Beneficios	Devuelve IDs de lugar que se pueden usar para consultar otras APIs. Puede devolver cualquier recuento. Se optimizó para ofrecer un rendimiento alto y un costo de procesamiento bajo. Es fácil de usar. No es necesario escribir consultas complejas. Valida los parámetros de entrada y devuelve un error, lo que facilita el uso y la depuración.	Permite realizar consultas complejas, como filtros avanzados y uniones. No aplica un área de búsqueda mínima. Admite funciones de agregación adicionales más allá de COUNT, como AVG, SUM y GROUP BY.
Interfaz	Cuatro funciones de SQL predefinidas que generan estadísticas de COUNT: recuento único, recuento por tipo, recuento por ubicación geográfica y recuento por celda H3. Un JSON_OBJECT pasa argumentos a la función.	Escribe tu propio código SQL para ejecutar funciones de agregación, como COUNT, COUNT_IF, SUM y AVG.. Se pueden generar estadísticas adicionales con JOIN, GROUP BY, WHERE y otras.
Restricciones	Aplica un área de búsqueda mínima de 40.0 metros por 40.0 metros (1600 m2). Una función devuelve un resultado incluso si el recuento de agregación es inferior a 5, siempre y cuando se cumpla el área de búsqueda mínima.	Los resultados con recuentos inferiores a 5 se omiten (es decir, se excluye la fila).
Filtros de atributos admitidos	Los parámetros de filtro de la función de recuento de lugares admiten los mismos filtros de atributos de la consulta directa, excepto los siguientes: Lugar id Componentes de la dirección Horario de apertura Opciones de carga de VE Marcas	Se admite el esquema completo.