Acerca de los datos y las consultas de Places Insights

Datos de Places Insights

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

Los conjuntos de datos de muestra están diseñados para que puedas probar Places Insights y 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 lista de muestra incluye datos de una ciudad principal para cada uno de los países admitidos:


Ámsterdam (NL)	Helsinki (FI)	Plovdiv (BG)
Ankara (TR)	Hong Kong (HK)	Riffa (BH)
Arequipa (PE)	Yakarta (ID)	Roma (IT)
Atenas (GR)	Yeda (SA)	Santiago (CL)
Bad Gastein (AT)	Johannesburgo (ZA)	San Pablo (BR)
Berlín (DE)	Kuala Lumpur (MY)	Sharjah (AE)
Brno (CZ)	Lisboa (PT)	Singapur (SG)
Bruselas (BE)	Londres (GB)	Estocolmo (SE)
Bucarest (RO)	Lusail (QA)	Sídney (AU)
Buenos Aires (AR)	Madrid (ES)	Taipéi (TW)
Busan (KR)	Manila (PH)	Tel Aviv-Yafo (IL)
El Cairo (EG)	Medellín (CO)	Tokio (JP)
Chiang Mai (TH)	Ciudad de México (MX)	Toronto (CA)
Copenhague (DK)	Mumbai (IN)	Varsovia (PL)
Cork (IE)	Nueva York (US)	Wellington (NZ)
Debrecen (HU)	Oslo (NO)	Zúrich (CH)
Hanói (VN)	París (FR)

Los conjuntos de datos completos incluyen datos de cada país admitido y se deben comprar. Si te interesa registrarte en Places Insights, 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 se compone 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), consulta el esquema principal y el esquema específico de ES.

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

id: El ID de la marca
name: El nombre de la marca, como "Hertz" o "Chase"
category: La categoría de alto nivel de la marca, como "Estación de servicio", "Alimentos y bebidas" o "Alojamiento"

Consulta datos de Places Insights

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

Consulta 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 Places Count: Las funciones de Places Count 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 la devolución de IDs de lugar para buscar detalles sobre lugares individuales. Consulta la documentación.

Consultas directas

La consulta directa de los datos aplica un umbral de agregación. Un resultado se muestra solo si la consulta 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 consulta para el recuento total de restaurantes en un área determinada solo mostrará una respuesta si el recuento total es 5 o más. De lo contrario, no se mostrará ninguna respuesta.

Consultas de funciones de Places Count

Las funciones de Places Count pueden mostrar 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 Places Count 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 (1600 m²). Esto significa que, siempre que tu consulta de 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 consulta.

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.

Consulta con las funciones si necesitas saber si hay una cantidad baja o cero de resultados, o si necesitas recuperar información de lugares individuales, como el nombre o la dirección del lugar.

En esta tabla, se proporciona una comparación detallada de las diferencias entre las consultas directas y las funciones de Places Count.

	Funciones de Places Count	Consultas directas de conjuntos de datos
Beneficios	Muestra IDs de lugar que se pueden usar para consultar otras APIs. Puede mostrar cualquier recuento. Está optimizada para el rendimiento y el bajo costo de procesamiento. Es fácil de usar. No es necesario escribir consultas complejas. Valida los parámetros de entrada y muestra un error, lo que facilita su uso y depuración.	Permite consultas complejas, como filtros y uniones avanzadas. 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 geografía y recuento por celda H3. Un `JSON_OBJECT` pasa argumentos a la función.	Escribe tu propio 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 m²). Una función muestra un resultado incluso si el recuento de agregación es inferior a 5, siempre que se cumpla el área de búsqueda mínima.	Los resultados con recuentos inferiores a 5 se omiten de los resultados (es decir, se excluye la fila).
Filtros de atributos admitidos	Los parámetros de filtro de la función de Places Count admiten lo mismo que los filtros de atributos de consulta directa, excepto lo siguiente: `id` de lugar Componentes de la dirección Horario de apertura Opciones de carga de VE Marcas	Se admite el esquema completo.