Filtrar parâmetros

É possível aplicar filtros às funções de contagem de lugares usando os parâmetros descritos na tabela abaixo. Os parâmetros obrigatórios são diferentes para cada função:

A função retorna um erro de argumento inválido se o nome e o valor do filtro não forem especificados de acordo com os requisitos abaixo.

Nome do filtro Descrição Tipo Valores compatíveis
geography

Para PLACES_COUNT, PLACES_COUNT_PER_TYPE e PLACES_COUNT_PER_H3

Especifica uma área para pesquisar. Qualquer tipo de GEOGRAPHY é aceito, como Point, LineString e Polygon.

É possível usar o parâmetro geography em combinação com geography_radius para adicionar um buffer à sua área de pesquisa.

É aplicada uma área de pesquisa mínima de 40,0 metros por 40,0 metros (1.600 m2). Se você especificar uma área de pesquisa abaixo desse limite, a função vai retornar um erro de argumento inválido.

GEOGRAPHY Qualquer tipo de GEOGRAPHY.
geographies

Somente para PLACES_COUNT_PER_GEO

Especifica uma lista de áreas para pesquisar. Qualquer tipo de GEOGRAPHY é aceito, como Point, LineString e Polygon.

É possível usar o parâmetro geographies em combinação com geography_radius para adicionar um buffer à sua área de pesquisa. O buffer é adicionado a todas as regiões especificadas.

É aplicada uma área de pesquisa mínima de 40,0 metros por 40,0 metros (1.600 m2). Se você especificar uma área de pesquisa abaixo desse limite, a função vai retornar um erro de argumento inválido.

ARRAY<GEOGRAPHY> Qualquer tipo de GEOGRAPHY.
geography_radius

Adiciona um raio ou buffer, em metros, à região especificada. O valor padrão é 0.

O valor especificado precisa definir uma área de pesquisa mínima de 40,0 metros por 40,0 metros (1.600 m2). Por exemplo, para uma geografia Point, o raio mínimo é de 23 metros.

INT64 O mínimo é 0.
h3_resolution

Somente para PLACES_COUNT_PER_H3

A resolução H3 usada para agregar a contagem de lugares em células H3.

INT64 Entre 0 e 8.
types

Especifica os tipos de lugar a serem considerados.

Cada lugar contém um conjunto de tipos de lugar, por exemplo, "restaurant" e "cafe". Se nenhum tipo for especificado, todos os tipos de lugar serão considerados no resultado.

ARRAY<STRING>

Para conferir a lista completa de valores possíveis, consulte as tabelas A e B em Tipos de lugares.

Exemplo:

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

primary_types

Especifica os tipos principais a serem considerados.

Um lugar só pode ter um tipo principal, que é o que melhor descreve o local.

Se nenhum tipo principal for especificado, todos os tipos principais de lugar serão considerados no resultado.

ARRAY<STRING>

Para conferir a lista completa de valores possíveis, consulte as tabelas A e B em Tipos de lugares.

Exemplo:

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

min_rating Especifica a classificação mínima do lugar a ser considerada.

A classificação de um lugar é baseada nas avaliações dos usuários e varia de 1,0 a 5,0.

Se você especificar uma classificação fora desse intervalo, a função vai retornar um erro de argumento inválido.

FLOAT Entre 1,0 e 5,0.
max_rating

Especifica a classificação máxima do lugar a ser considerada.

A classificação de um lugar é baseada nas avaliações dos usuários e varia de 1,0 a 5,0.

Se você especificar uma classificação fora desse intervalo, a função vai retornar um erro de argumento inválido.

FLOAT Entre 1,0 e 5,0.
min_user_rating_count

Especifica a contagem mínima de avaliações de usuários a ser considerada.

A contagem de avaliações de usuários é o número total de avaliações de um lugar.

O valor mínimo é 0. Se você especificar um valor abaixo de 0, a função vai retornar um erro de argumento inválido.

INT64 O valor mínimo é 0.
max_user_rating_count

Especifica o número máximo de avaliações de usuários a serem consideradas.

A contagem de avaliações de usuários é o número total de avaliações de um lugar.

O valor mínimo é 0. Se você especificar um valor abaixo de 0, a função vai retornar um erro de argumento inválido.

INT64 O valor mínimo é 0.
price_level

Especifica os níveis de preço a serem considerados.

É possível especificar vários níveis de preço.

ARRAY<STRING>

Valores compatíveis:

"PRICE_LEVEL_FREE"

"PRICE_LEVEL_INEXPENSIVE"

"PRICE_LEVEL_MODERATE"

"PRICE_LEVEL_EXPENSIVE"

"PRICE_LEVEL_VERY_EXPENSIVE"

Exemplo:

["PRICE_LEVEL_MODERATE","PRICE_LEVEL_EXPENSIVE"]

business_status Especifica o status da empresa a ser considerado. É possível especificar vários status de empresa. ARRAY<STRING>

Valores compatíveis:

"OPERATIONAL"

"CLOSED_TEMPORARILY"

"CLOSED_PERMANENTLY"

Exemplo:

["OPERATIONAL","CLOSED_TEMPORARILY"]

takeout Considera lugares que oferecem comida para viagem. BOOLEAN TRUE, FALSE
delivery Considera lugares que oferecem delivery. BOOLEAN TRUE, FALSE
dine_in Considera lugares que oferecem refeição no local. BOOLEAN TRUE, FALSE
curbside_pickup Considera lugares que oferecem retirada na porta. BOOLEAN TRUE, FALSE
reservable Considere lugares que podem ser reservados. BOOLEAN TRUE, FALSE
outdoor_seating Considera lugares que oferecem mesas em área externa. BOOLEAN TRUE, FALSE
live_music Considera lugares que oferecem música ao vivo. BOOLEAN TRUE, FALSE
allows_dogs Considere lugares que aceitam cachorros. BOOLEAN TRUE, FALSE
restroom Considera lugares que oferecem banheiros. BOOLEAN TRUE, FALSE
serves_breakfast Considera lugares que servem café da manhã. BOOLEAN TRUE, FALSE
serves_lunch Considera lugares que servem almoço. BOOLEAN TRUE, FALSE
serves_dinner Considera lugares que servem jantar. BOOLEAN TRUE, FALSE
serves_beer Considera lugares que servem cerveja. BOOLEAN TRUE, FALSE
serves_wine Considera lugares que servem vinho. BOOLEAN TRUE, FALSE
serves_brunch Considera lugares que servem brunch. BOOLEAN TRUE, FALSE
serves_vegetarian_food Considera lugares que servem comida vegetariana. BOOLEAN TRUE, FALSE
serves_cocktails Considera lugares que servem coquetéis. BOOLEAN TRUE, FALSE
serves_dessert Considera lugares que servem sobremesa. BOOLEAN TRUE, FALSE
serves_coffee Considera lugares que servem café. BOOLEAN TRUE, FALSE
menu_for_children Considera lugares que oferecem cardápios para crianças. BOOLEAN TRUE, FALSE
good_for_children Considere lugares adequados para crianças. BOOLEAN TRUE, FALSE
good_for_groups Considere lugares bons para grupos. BOOLEAN TRUE, FALSE
good_for_watching_sports Considere lugares bons para assistir esportes. BOOLEAN TRUE, FALSE
accepts_credit_cards Considere lugares que aceitam cartões de crédito. BOOLEAN TRUE, FALSE
accepts_debit_cards Considere lugares que aceitam cartões de débito. BOOLEAN TRUE, FALSE
accepts_cash_only Considere lugares que aceitam apenas dinheiro. BOOLEAN TRUE, FALSE
accepts_nfc Considere lugares que aceitam pagamentos por NFC. BOOLEAN TRUE, FALSE
free_parking_lot Considera lugares com estacionamento gratuito. BOOLEAN TRUE, FALSE
paid_parking_lot Considera lugares com estacionamento pago. BOOLEAN TRUE, FALSE
free_street_parking Considera lugares com estacionamento público sem custo financeiro. BOOLEAN TRUE, FALSE
paid_street_parking Considera lugares com estacionamento público pago. BOOLEAN TRUE, FALSE
valet_parking Considera lugares com estacionamento com manobrista. BOOLEAN TRUE, FALSE
free_garage_parking Considera lugares com estacionamento gratuito. BOOLEAN TRUE, FALSE
paid_garage_parking Considera lugares com garagem de estacionamento paga. BOOLEAN TRUE, FALSE
wheelchair_accessible_parking Considera lugares com estacionamento acessível para pessoas em cadeira de rodas. BOOLEAN TRUE, FALSE
wheelchair_accessible_entrance Considera lugares com entrada acessível para cadeirantes. BOOLEAN TRUE, FALSE
wheelchair_accessible_restroom Considera lugares com banheiro acessível a pessoas em cadeira de rodas. BOOLEAN TRUE, FALSE
wheelchair_accessible_seating Considera lugares com assentos acessíveis para pessoas em cadeira de rodas. BOOLEAN TRUE, FALSE