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:

La función devuelve un error de argumento no válido si el nombre y el valor del filtro no se especifican según los requisitos que se indican a continuación.

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 la búsqueda. 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 a tu área de búsqueda.

Se aplica un área de búsqueda mínima de 40.0 metros por 40.0 metros (1,600 m2). Si especificas un área de búsqueda por debajo de este límite, la función devolverá 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 a tu á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 (1,600 m2). Si especificas un área de búsqueda por debajo de este límite, la función devolverá un error de argumento no válido.

ARRAY<GEOGRAPHY> Cualquier tipo de GEOGRAPHY.
geography_radius

Agrega un radio o un 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 (1,600 m2). Por ejemplo, para una ubicación geográfica de 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 de H3 que se usa para agregar el recuento de lugares en celdas de H3.

INT64 Debe ser entre 0 y 8.
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 especifica ningún tipo, se tendrán en cuenta todos los tipos de lugares en el resultado.

ARRAY<STRING>

Para obtener la lista completa de los valores posibles, consulta las tablas A y B en Tipos de lugares.

Ejemplo:

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

primary_types

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 lugar en el resultado.

ARRAY<STRING>

Para obtener la lista completa de los valores posibles, consulta las tablas A y B en Tipos de lugares.

Ejemplo:

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

min_rating Especifica la calificación mínima del lugar que se debe tener en cuenta.

La calificación de un lugar 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 del lugar que se tendrá en cuenta.

La calificación de un lugar 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 la cantidad mínima de calificaciones de 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 la cantidad máxima de calificaciones de usuarios que se deben 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 de la empresa que se debe tener en cuenta. Puedes especificar varios estados de la empresa. ARRAY<STRING>

Valores admitidos:

"OPERATIONAL"

"CLOSED_TEMPORARILY"

"CLOSED_PERMANENTLY"

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 retiro 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 lugares donde se permitan perros. BOOLEAN TRUE, FALSE
restroom Considera los lugares que ofrecen baños. BOOLEAN TRUE, FALSE
serves_breakfast Considera los lugares que sirven desayuno. BOOLEAN TRUE, FALSE
serves_lunch Considera los lugares que ofrecen almuerzo. BOOLEAN TRUE, FALSE
serves_dinner Considera los lugares que sirven cena. BOOLEAN TRUE, FALSE
serves_beer Considera los lugares que sirven cerveza. BOOLEAN TRUE, FALSE
serves_wine Considera los lugares que sirven 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 sirven cócteles. BOOLEAN TRUE, FALSE
serves_dessert Considera los lugares que sirven postres. BOOLEAN TRUE, FALSE
serves_coffee Considera los lugares que sirven café. BOOLEAN TRUE, FALSE
menu_for_children Considera los lugares que ofrecen menús para niños. BOOLEAN TRUE, FALSE
good_for_children Considera lugares que sean buenos para los niños. BOOLEAN TRUE, FALSE
good_for_groups Considera lugares que sean buenos para grupos. BOOLEAN TRUE, FALSE
good_for_watching_sports Considera lugares que sean buenos para mirar deportes. BOOLEAN TRUE, FALSE
accepts_credit_cards Considera lugares que acepten tarjetas de crédito. BOOLEAN TRUE, FALSE
accepts_debit_cards Considera lugares que acepten tarjetas de débito. BOOLEAN TRUE, FALSE
accepts_cash_only Ten en cuenta 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 en cochera de pago. 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 espacio accesible para personas en silla de ruedas. BOOLEAN TRUE, FALSE