Параметры фильтра

Вы можете применять фильтры к функциям подсчета мест, используя параметры, описанные в таблице ниже. Обратите внимание, что обязательные параметры для каждой функции различаются:

• PLACES_COUNT: требуется geography
• PLACES_COUNT_PER_TYPE_V2: требуются geography и type.
• PLACES_COUNT_V2: требуется geographies
• PLACES_COUNT_PER_H3: требуются geography и h3_resolution.
• PLACES_COUNT_CHANGE: требуются month1 и month2.

Название фильтра и его значение чувствительны к регистру. Их нужно указывать точно так, как они приведены в таблице. В противном случае запрос вернет ошибку недопустимого аргумента.

Название фильтра	Описание	Тип	Допустимые значения
geography	Для сервисов "PLACES_COUNT", "PLACES_COUNT_PER_TYPE" и PLACES_COUNT_PER_H3 Определяет область поиска. Поддерживаются любые типы GEOGRAPHY, например Point, LineString и Polygon. Вы можете использовать параметр geography в сочетании с geography_radius, чтобы добавить буфер к области поиска. Минимальная область поиска – 40 на 40 метров (1600 м^2). Если вы укажете область поиска меньше этого ограничения, функция вернет ошибку недопустимого аргумента.	GEOGRAPHY	Любой тип GEOGRAPHY.
geographies	Только для PLACES_COUNT_PER_GEO Указывает список областей для поиска. Поддерживаются любые типы GEOGRAPHY, например Point, LineString и Polygon. Вы можете использовать параметр geographies в сочетании с geography_radius, чтобы добавить буфер к области поиска. Буфер добавляется ко всем указанным местоположениям. Минимальная область поиска – 40 на 40 метров (1600 м^2). Если вы укажете область поиска меньше этого ограничения, функция вернет ошибку недопустимого аргумента.	ARRAY<GEOGRAPHY>	Любой тип GEOGRAPHY.
geography_radius	Добавляет радиус или буфер в метрах к указанному географическому объекту. Значение по умолчанию – 0. Указанное значение должно определять минимальную область поиска размером 40 на 40 метров (1600 м^2). Например, для географического объекта Point минимальный радиус составляет 23 метра.	INT64	Минимальное значение – 0.
h3_resolution	Только для PLACES_COUNT_PER_H3 Разрешение H3, используемое для агрегирования количества мест в ячейках H3.	INT64	От 0 до 11.
types	Указывает типы мест, которые нужно учитывать. Каждое место содержит набор типов мест, например "restaurant" и "cafe". Если типы не указаны, в результате учитываются все типы мест.	ARRAY<STRING>	Полный список возможных значений приведен в разделе Типы мест. Пример: ["restaurant", "cafe", "bar"]
primary_type	Указывает основные типы, которые следует учитывать. У места может быть только один основной тип, который лучше всего его описывает. Если основные типы не указаны, в результате учитываются все основные типы мест.	ARRAY<STRING>	Полный список возможных значений приведен в разделе Типы мест. Пример: ["restaurant", "cafe", "bar"]
brand_ids	Только для PLACES_COUNT_PER_H3, PLACES_COUNT_V2 и PLACES_COUNT_PER_TYPE_V2 Указывает идентификаторы брендов, которые нужно учитывать. Каждое место может быть связано с идентификаторами брендов. Если идентификаторы брендов не указаны, в результате учитываются все бренды (и небрендированные места). Примечание. Данные о брендах поддерживаются только в некоторых странах. В настоящее время это Австралия, Великобритания, Канада и США.	ARRAY<STRING>	Массив идентификаторов брендов. Дополнительную информацию о данных по брендам можно найти в статье Как составить запрос с использованием данных о брендах. Пример: ["brand_001", "brand_002"]
min_rating	Указывает минимальную оценку места, которую следует учитывать. Оценка места основана на отзывах пользователей и находится в диапазоне от 1,0 до 5,0. Если вы укажете оценку за пределами этого диапазона, функция вернет ошибку недопустимого аргумента.	FLOAT	От 1,0 до 5,0.
max_rating	Указывает максимальный рейтинг места, который следует учитывать. Оценка места основана на отзывах пользователей и находится в диапазоне от 1,0 до 5,0. Если вы укажете оценку за пределами этого диапазона, функция вернет ошибку недопустимого аргумента.	FLOAT	От 1,0 до 5,0.
min_user_rating_count	Указывает минимальное количество оценок пользователей, которое нужно учитывать. Количество оценок пользователей – это общее число отзывов о месте. Минимальное значение – 0. Если указать значение меньше 0, функция вернет ошибку недопустимого аргумента.	INT64	Минимальное значение – 0.
max_user_rating_count	Указывает максимальное количество оценок пользователей, которое нужно учитывать. Количество оценок пользователей – это общее число отзывов о месте. Минимальное значение – 0. Если указать значение меньше 0, функция вернет ошибку недопустимого аргумента.	INT64	Минимальное значение – 0.
price_level	Указывает, какие уровни цен следует учитывать. Вы можете указать несколько уровней цен.	ARRAY<STRING>	Допустимые значения: "PRICE_LEVEL_FREE" "PRICE_LEVEL_INEXPENSIVE" "PRICE_LEVEL_MODERATE" "PRICE_LEVEL_EXPENSIVE" "PRICE_LEVEL_VERY_EXPENSIVE" Пример: ["PRICE_LEVEL_MODERATE","PRICE_LEVEL_EXPENSIVE"]
business_status	Указывает статус компании, который нужно учитывать. Можно указать несколько статусов.	ARRAY<STRING>	Допустимые значения: "OPERATIONAL" "CLOSED_TEMPORARILY" "CLOSED_PERMANENTLY" "FUTURE_OPENING" Пример: ["OPERATIONAL","CLOSED_TEMPORARILY"]
takeout	Учитываются места, где можно заказать еду навынос.	BOOLEAN	TRUE, FALSE
delivery	Учитываются места, предлагающие доставку.	BOOLEAN	TRUE, FALSE
dine_in	Учитываются места, где можно поесть в зале.	BOOLEAN	TRUE, FALSE
curbside_pickup	Учитываются места, где можно получить заказ на улице.	BOOLEAN	TRUE, FALSE
reservable	Рассмотрите места, которые можно забронировать.	BOOLEAN	TRUE, FALSE
outdoor_seating	Учитываются места, где есть столики на улице.	BOOLEAN	TRUE, FALSE
live_music	Учитываются места, где есть живая музыка.	BOOLEAN	TRUE, FALSE
allows_dogs	Учитывайте места, где разрешено находиться с собаками.	BOOLEAN	TRUE, FALSE
restroom	Учитываются места, где есть туалеты.	BOOLEAN	TRUE, FALSE
serves_breakfast	Учитываются места, где подают завтрак.	BOOLEAN	TRUE, FALSE
serves_lunch	Учитываются места, где подают обед.	BOOLEAN	TRUE, FALSE
serves_dinner	Учитываются места, где подают ужин.	BOOLEAN	TRUE, FALSE
serves_beer	Учитываются места, где подают пиво.	BOOLEAN	TRUE, FALSE
serves_wine	Учитываются места, где подают вино.	BOOLEAN	TRUE, FALSE
serves_brunch	Учитываются места, где подают поздний завтрак.	BOOLEAN	TRUE, FALSE
serves_vegetarian_food	Учитываются места, где подают вегетарианские блюда.	BOOLEAN	TRUE, FALSE
serves_cocktails	Учитываются места, где подают коктейли.	BOOLEAN	TRUE, FALSE
serves_dessert	Учитываются места, где подают десерты.	BOOLEAN	TRUE, FALSE
serves_coffee	Учитываются места, где подают кофе.	BOOLEAN	TRUE, FALSE
menu_for_children	Учитываются места, где есть детское меню.	BOOLEAN	TRUE, FALSE
good_for_children	Подумайте, какие места подходят для детей.	BOOLEAN	TRUE, FALSE
good_for_groups	Подумайте о местах, которые подходят для групп.	BOOLEAN	TRUE, FALSE
good_for_watching_sports	Рассмотрите места, где можно посмотреть спортивные трансляции.	BOOLEAN	TRUE, FALSE
accepts_credit_cards	Учитывайте места, где принимаются кредитные карты.	BOOLEAN	TRUE, FALSE
accepts_debit_cards	Учитывайте места, где принимаются дебетовые карты.	BOOLEAN	TRUE, FALSE
accepts_cash_only	Учитывайте места, где принимают только наличные.	BOOLEAN	TRUE, FALSE
accepts_nfc	Учитывайте места, где принимаются платежи NFC.	BOOLEAN	TRUE, FALSE
free_parking_lot	Учитываются места, где есть бесплатная парковка.	BOOLEAN	TRUE, FALSE
paid_parking_lot	Учитываются места, где есть платная парковка.	BOOLEAN	TRUE, FALSE
free_street_parking	Поиск мест с бесплатной уличной парковкой.	BOOLEAN	TRUE, FALSE
paid_street_parking	Учитываются места, где есть платная уличная парковка.	BOOLEAN	TRUE, FALSE
valet_parking	Поиск мест, где есть услуги парковщика.	BOOLEAN	TRUE, FALSE
free_garage_parking	Учитываются места, где есть бесплатная крытая парковка.	BOOLEAN	TRUE, FALSE
paid_garage_parking	Учитываются места, где есть платная крытая стоянка.	BOOLEAN	TRUE, FALSE
wheelchair_accessible_parking	Учитываются места, где есть парковка, доступная для инвалидов-колясочников.	BOOLEAN	TRUE, FALSE
wheelchair_accessible_entrance	Учитываются места, где есть вход, оборудованный для инвалидов-колясочников.	BOOLEAN	TRUE, FALSE
wheelchair_accessible_restroom	Учитываются места, где есть туалет для инвалидов-колясочников.	BOOLEAN	TRUE, FALSE
wheelchair_accessible_seating	Учитываются места, где есть места для инвалидов-колясочников.	BOOLEAN	TRUE, FALSE
snapshot_date	Указывает месяц, за который нужно получить статистику. Если не указано, по умолчанию используется последний снимок.	STRING	Формат: YYYY-MM. Пример: "2026-07"
month1	Только для PLACES_COUNT_CHANGE Указывает месяц, за который нужно получить данные.	STRING	Формат: YYYY-MM. Пример: "2026-01"
month2	Только для PLACES_COUNT_CHANGE Указывает месяц, за который нужно получить данные для сравнения.	STRING	Формат: YYYY-MM. Пример: "2026-02"
regular_opening_hours	Фильтрует места по обычным часам работы.	JSON	Пример: JSON_OBJECT('monday', [JSON_OBJECT('start_time', '09:00', 'end_time', '12:00')])
min_ev_charge_connector_count	Указывает минимальное количество коннекторов для зарядки электромобилей.	INT64	Минимальное значение – 0.
max_ev_charge_connector_count	Указывает максимальное количество коннекторов для зарядки электромобилей.	INT64	Минимальное значение – 0.
max_ev_max_charge_rate_kw	Указывает максимальную скорость зарядки в кВт для станций зарядки ЭМ.	FLOAT64	Минимальное значение – 0,0.
ev_charge_connector_types	Указывает типы коннекторов для электромобилей, которые нужно учитывать.	ARRAY<STRING>	Пример: ["EV_CONNECTOR_TYPE_TESLA"]