Parámetros de filtro

Puedes aplicar filtros a las funciones de recuento de lugares con los parámetros que se describen en la siguiente tabla. Ten en cuenta que los parámetros obligatorios difieren para cada función:

El nombre del filtro y su valor distinguen mayúsculas de minúsculas. Debes especificarlos exactamente como aparecen en la tabla. De lo contrario, la consulta mostrará un error de argumento no válido.

Nombre del filtro Descripción Tipo Valores admitidos
geography

Para PLACES_COUNT, PLACES_COUNT_PER_TYPE y PLACES_COUNT_PER_H3

Especifica un área para buscar. Se admite cualquier tipo de GEOGRAPHY, como Point, LineString y Polygon.

Puedes usar el parámetro geography en combinación con geography_radius para agregar un búfer al área de búsqueda.

Se aplica un área de búsqueda mínima de 40.0 metros por 40.0 metros (1600 m2). Si especificas un área de búsqueda por debajo de este límite, la función muestra un error de argumento no válido.

 GEOGRAPHY Cualquier tipo de GEOGRAPHY.
geographies

Solo para PLACES_COUNT_PER_GEO

Especifica una lista de áreas para buscar. Se admite cualquier tipo de GEOGRAPHY, como Point, LineString y Polygon.

Puedes usar el parámetro geographies en combinación con geography_radius para agregar un búfer al área de búsqueda. El búfer se agrega a todas las ubicaciones geográficas especificadas.

Se aplica un área de búsqueda mínima de 40.0 metros por 40.0 metros (1600 m2). Si especificas un área de búsqueda por debajo de este límite, la función muestra un error de argumento no válido.

 ARRAY<GEOGRAPHY> Cualquier tipo de GEOGRAPHY.
geography_radius

Agrega un radio o búfer, en metros, a la ubicación geográfica especificada. El valor predeterminado es 0.

El valor especificado debe definir un área de búsqueda mínima de 40.0 metros por 40.0 metros (1600 m2). Por ejemplo, para una ubicación geográfica Point, el radio mínimo es de 23 metros.

 INT64 El valor mínimo es 0.
h3_resolution

Solo para PLACES_COUNT_PER_H3

Es la resolución H3 que se usa para agregar el recuento de lugares en celdas H3.

 INT64 Entre 0 y 11.
types

Especifica los tipos de lugares que se deben tener en cuenta.

Cada lugar contiene un conjunto de tipos de lugares, por ejemplo, "restaurant" y "cafe". Si no se especifican tipos, se consideran todos los tipos de lugares en el resultado.

 ARRAY<STRING>

Para obtener la lista completa de valores posibles, consulta Tipos de lugares.

Ejemplo:

["restaurant", "cafe", "bar"]
primary_type

Especifica los tipos principales que se deben tener en cuenta.

Un lugar solo puede tener un tipo principal, que es el que mejor describe la ubicación.

Si no se especifican tipos principales, se consideran todos los tipos principales de lugares en el resultado.

 ARRAY<STRING>

Para obtener la lista completa de valores posibles, consulta Tipos de lugares.

Ejemplo:

["restaurant", "cafe", "bar"]
brand_ids

Solo para PLACES_COUNT_PER_H3, PLACES_COUNT_V2 y PLACES_COUNT_PER_TYPE_V2

Especifica los IDs de marca que se deben tener en cuenta.

Cada lugar se puede asociar con IDs de marca. Si no se especifican IDs de marca, se consideran todas las marcas (y los lugares sin marca) en el resultado.

Nota: Los datos de marcas solo se admiten en ciertos países. Actualmente: Estados Unidos (US), Canadá (CA), Reino Unido (GB) y Australia (AU).

 ARRAY<STRING>

Un array de IDs de marca. Para obtener más información sobre los datos de marcas, consulta Escribe una consulta con datos de marcas.

Ejemplo:

["brand_001", "brand_002"]
min_rating Especifica la calificación mínima de lugares que se debe tener en cuenta.

La calificación de lugares se basa en las opiniones de los usuarios sobre el lugar y tiene un rango entre 1.0 y 5.0.

Si especificas una calificación fuera de este rango, la función muestra un error de argumento no válido.

 FLOAT Entre 1.0 y 5.0.
max_rating

Especifica la calificación máxima de lugares que se debe tener en cuenta.

La calificación de lugares se basa en las opiniones de los usuarios sobre el lugar y tiene un rango entre 1.0 y 5.0.

Si especificas una calificación fuera de este rango, la función muestra un error de argumento no válido.

 FLOAT Entre 1.0 y 5.0.
min_user_rating_count

Especifica el recuento mínimo de calificaciones de los usuarios que se debe tener en cuenta.

El recuento de calificaciones de los usuarios es la cantidad total de opiniones que tiene un lugar.

El valor mínimo es 0. Si especificas un valor inferior a 0, la función muestra un error de argumento no válido.

 INT64 El valor mínimo es 0.
max_user_rating_count

Especifica el recuento máximo de calificaciones de los usuarios que se debe tener en cuenta.

El recuento de calificaciones de los usuarios es la cantidad total de opiniones que tiene un lugar.

El valor mínimo es 0. Si especificas un valor inferior a 0, la función muestra un error de argumento no válido.

 INT64 El valor mínimo es 0.
price_level

Especifica los niveles de precios que se deben tener en cuenta.

Puedes especificar varios niveles de precios.

 ARRAY<STRING>

Valores admitidos:

"PRICE_LEVEL_FREE"

"PRICE_LEVEL_INEXPENSIVE"

"PRICE_LEVEL_MODERATE"

"PRICE_LEVEL_EXPENSIVE"

"PRICE_LEVEL_VERY_EXPENSIVE"

Ejemplo:

["PRICE_LEVEL_MODERATE","PRICE_LEVEL_EXPENSIVE"]
business_status Especifica el estado del negocio que se debe tener en cuenta. Puedes especificar varios estados del negocio. ARRAY<STRING>

Valores admitidos:

"OPERATIONAL"

"CLOSED_TEMPORARILY"

"CLOSED_PERMANENTLY"

"FUTURE_OPENING"

Ejemplo:

["OPERATIONAL","CLOSED_TEMPORARILY"]
takeout Considera los lugares que ofrecen comida para llevar. BOOLEAN TRUE, FALSE
delivery Considera los lugares que ofrecen servicio de entrega. BOOLEAN TRUE, FALSE
dine_in Considera los lugares que ofrecen servicio de comida en sus instalaciones. BOOLEAN TRUE, FALSE
curbside_pickup Considera los lugares que ofrecen retiros en la puerta. BOOLEAN TRUE, FALSE
reservable Considera los lugares que se pueden reservar. BOOLEAN TRUE, FALSE
outdoor_seating Considera los lugares que ofrecen asientos al aire libre. BOOLEAN TRUE, FALSE
live_music Considera los lugares que ofrecen música en vivo. BOOLEAN TRUE, FALSE
allows_dogs Considera los lugares que permiten perros. BOOLEAN TRUE, FALSE
restroom Considera los lugares que ofrecen sanitarios. BOOLEAN TRUE, FALSE
serves_breakfast Considera los lugares que ofrecen opciones para desayunar. BOOLEAN TRUE, FALSE
serves_lunch Considera los lugares que ofrecen opciones para almorzar. BOOLEAN TRUE, FALSE
serves_dinner Considera los lugares que ofrecen opciones para cenar. BOOLEAN TRUE, FALSE
serves_beer Considera los lugares que ofrecen cerveza. BOOLEAN TRUE, FALSE
serves_wine Considera los lugares que ofrecen vino. BOOLEAN TRUE, FALSE
serves_brunch Considera los lugares que ofrecen desayuno-almuerzo. BOOLEAN TRUE, FALSE
serves_vegetarian_food Considera los lugares que ofrecen comida vegetariana. BOOLEAN TRUE, FALSE
serves_cocktails Considera los lugares que ofrecen cócteles. BOOLEAN TRUE, FALSE
serves_dessert Considera los lugares que ofrecen opciones de postre. BOOLEAN TRUE, FALSE
serves_coffee Considera los lugares que ofrecen café. BOOLEAN TRUE, FALSE
menu_for_children Considera los lugares que ofrecen menús para niños. BOOLEAN TRUE, FALSE
good_for_children Considera los lugares que son adecuados para niños. BOOLEAN TRUE, FALSE
good_for_groups Considera los lugares que son adecuados para grupos. BOOLEAN TRUE, FALSE
good_for_watching_sports Considera los lugares que son adecuados para mirar deportes. BOOLEAN TRUE, FALSE
accepts_credit_cards Considera los lugares que aceptan tarjetas de crédito. BOOLEAN TRUE, FALSE
accepts_debit_cards Considera los lugares que aceptan tarjetas de débito. BOOLEAN TRUE, FALSE
accepts_cash_only Considera los lugares que solo aceptan efectivo. BOOLEAN TRUE, FALSE
accepts_nfc Considera los lugares que aceptan pagos NFC. BOOLEAN TRUE, FALSE
free_parking_lot Considera los lugares que tienen estacionamiento gratuito. BOOLEAN TRUE, FALSE
paid_parking_lot Considera los lugares que tienen estacionamiento pagado. BOOLEAN TRUE, FALSE
free_street_parking Considera los lugares que tienen estacionamiento gratuito en la calle. BOOLEAN TRUE, FALSE
paid_street_parking Considera los lugares que tienen estacionamiento pagado en la calle. BOOLEAN TRUE, FALSE
valet_parking Considera los lugares que tienen servicio de estacionamiento. BOOLEAN TRUE, FALSE
free_garage_parking Considera los lugares que tienen estacionamiento gratuito en cochera. BOOLEAN TRUE, FALSE
paid_garage_parking Considera los lugares que tienen estacionamiento pagado en cochera. BOOLEAN TRUE, FALSE
wheelchair_accessible_parking Considera los lugares que tienen estacionamiento accesible para personas en silla de ruedas. BOOLEAN TRUE, FALSE
wheelchair_accessible_entrance Considera los lugares que tienen entrada accesible para personas en silla de ruedas. BOOLEAN TRUE, FALSE
wheelchair_accessible_restroom Considera los lugares que tienen sanitarios accesibles para personas en silla de ruedas. BOOLEAN TRUE, FALSE
wheelchair_accessible_seating Considera los lugares que tienen asientos accesibles para personas en silla de ruedas. BOOLEAN TRUE, FALSE