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

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

Функция возвращает ошибку недопустимого аргумента, если имя и значение фильтра не указаны в соответствии с приведенными ниже требованиями.

Имя фильтра Описание Тип Поддерживаемые значения
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>

Полный список возможных значений см. в таблице A и таблице B в разделе Типы мест .

Пример:

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

primary_types

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

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

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

ARRAY<STRING>

Полный список возможных значений см. в таблице A и таблице B в разделе Типы мест .

Пример:

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

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

Рейтинг Places формируется на основе отзывов пользователей о месте и варьируется от 1,0 до 5,0.

Если указать рейтинг вне этого диапазона, функция вернет ошибку недопустимого аргумента.

FLOAT От 1,0 до 5,0.
max_rating

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

Рейтинг Places формируется на основе отзывов пользователей о месте и варьируется от 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