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

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

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

Название фильтра Описание Тип Поддерживаемые ценности
geography

Для PLACES_COUNT , PLACES_COUNT_PER_TYPE и PLACES_COUNT_PER_H3

Указывает область поиска. Поддерживаются любые типы GEOGRAPHY такие как Point , LineString и Polygon .

Параметр geography можно использовать в сочетании с geography_radius для добавления буфера к области поиска.

Установлена ​​минимальная зона поиска размером 40,0 метров на 40,0 метров (1600 м² ). Если вы укажете зону поиска меньше этого предела, функция вернет ошибку "недопустимый аргумент".

GEOGRAPHY Любой вид GEOGRAPHY .
geographies

Только для PLACES_COUNT_PER_GEO

Указывает список областей для поиска. Поддерживаются любые типы GEOGRAPHY , такие как Point , LineString и Polygon .

Параметр geographies можно использовать в сочетании с geography_radius для добавления буфера к области поиска. Буфер добавляется ко всем указанным географическим регионам.

Установлена ​​минимальная зона поиска размером 40,0 метров на 40,0 метров (1600 м² ). Если вы укажете зону поиска меньше этого предела, функция вернет ошибку "недопустимый аргумент".

ARRAY<GEOGRAPHY> Любой вид GEOGRAPHY .
geography_radius

Добавляет радиус или буфер в метрах к указанной географической области. Значение по умолчанию — 0.

Указанное значение должно определять минимальную зону поиска размером 40,0 метров на 40,0 метров (1600 м² ). Например, для Point географической области минимальный радиус составляет 23 метра.

INT64 Минимум равен 0.
h3_resolution

Только для PLACES_COUNT_PER_H3

Разрешение H3 используется для агрегирования количества мест в ячейки H3.

INT64 От 0 до 8.
types

Указывает типы мест, которые следует учитывать.

Каждое место содержит набор типов мест, например, "restaurant" и "cafe" . Если типы не указаны, в результате учитываются все типы мест.

ARRAY<STRING>

Полный список возможных значений см. в разделе «Типы мест» .

Пример:

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

primary_types

Указывает основные типы, которые следует учитывать.

Место может иметь только один основной тип, который наилучшим образом описывает это место.

Если основные типы не указаны, в результате учитываются все основные типы мест.

ARRAY<STRING>

Полный список возможных значений см. в разделе «Типы мест» .

Пример:

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

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"

Пример:

["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