پارامترهای فیلتر

بااستفاده از پارامترهای شرح‌داده‌شده در جدول زیر، می‌توانید فیلترهایی را روی توابع شمارش مکان اعمال کنید. توجه داشته باشید که پارامترهای لازم برای هر تابع متفاوت است:

نام فیلتر و مقدار آن حروف‌حساس است. باید آن‌ها را دقیقاً همان‌طور که در جدول نشان داده شده‌اند مشخص کنید. درغیراین‌صورت، پُرسمان خطای شناسه نامعتبر برمی‌گرداند.

نام فیلتر شرح نوع مقادیر پشتیبانی‌شده
geography

برای PLACES_COUNT،‏ PLACES_COUNT_PER_TYPE، و PLACES_COUNT_PER_H3

منطقه‌ای را برای جستجو مشخص می‌کند. هر نوع GEOGRAPHY پشتیبانی می‌شود، مثل Point، LineString، و Polygon.

می‌توانید از پارامتر geography در ترکیب با geography_radius استفاده کنید تا به منطقه جستجویتان میان‌گیر اضافه کنید.

حداقل محل جستجو ۴۰٫۰ متر در ۴۰٫۰ متر (۱۶۰۰ متر۲) اعمال می‌شود. اگر منطقه جستجویی را زیر این حد مشخص کنید، تابع خطای آرگومان نامعتبر را برمی‌گرداند.

 GEOGRAPHY هر نوع GEOGRAPHY.
geographies

فقط برای PLACES_COUNT_PER_GEO

فهرستی از مناطق را برای جستجو مشخص می‌کند. هر نوع GEOGRAPHY پشتیبانی می‌شود، مثل Point، LineString، و Polygon.

می‌توانید از پارامتر geographies در ترکیب با geography_radius استفاده کنید تا به منطقه جستجویتان میان‌گیر اضافه کنید. بافر به همه مناطق جغرافیایی مشخص‌شده اضافه می‌شود.

حداقل محل جستجو ۴۰٫۰ متر در ۴۰٫۰ متر (۱۶۰۰ متر۲) اعمال می‌شود. اگر منطقه جستجویی را زیر این حد مشخص کنید، تابع خطای شناسه نامعتبر را برمی‌گرداند.

 ARRAY<GEOGRAPHY> هر نوع GEOGRAPHY.
geography_radius

شعاع یا حائلی را، به متر، به جغرافیای مشخص‌شده اضافه می‌کند. مقدار پیش‌فرض ۰ است.

مقدار مشخص‌شده باید حداقل منطقه جستجوی ۴۰٫۰ متر در ۴۰٫۰ متر (۱۶۰۰ متر۲) را تعریف کند. برای مثال، برای جغرافیای Point، حداقل شعاع ۲۳ متر است.

 INT64 حداقل مقدار ۰ است.
h3_resolution

فقط برای PLACES_COUNT_PER_H3

وضوح H3 که برای تجمیع تعداد مکان‌ها در سلول‌های H3 استفاده می‌شود.

 INT64 بین ۰ تا ۱۱.
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

شناسه‌های نمانام را برای درنظر گرفتن مشخص می‌کند.

هر مکان می‌تواند با شناسه‌های نمانام مرتبط باشد. اگر شناسه نمانامی مشخص نشده باشد، همه نمانام‌ها (و مکان‌های غیرنمانامی) در نتیجه درنظر گرفته می‌شوند.

توجه: داده‌های نمانام‌ها فقط در برخی کشورها پشتیبانی می‌شود. درحال‌حاضر: ایالات متحده (US)، کانادا (CA)، پادشاهی متحد (GB)، و استرالیا (AU).

 ARRAY<STRING>

آرایه‌ای از شناسه‌های نمانام. برای اطلاعات بیشتر درباره داده‌های نمانام‌ها، به نوشتن پُرسمان بااستفاده از داده‌های نمانام‌ها مراجعه کنید.

مثال:

["brand_001", "brand_002"]
min_rating حداقل رده‌بندی مکان را برای درنظر گرفتن مشخص می‌کند.

رده‌بندی «مکان‌ها» براساس مرورهای کاربران از مکان است و دامنه‌ای بین ۱٫۰ تا ۵٫۰ دارد

اگر رده‌بندی‌ای خارج از این محدوده مشخص کنید، تابع خطای آرگومان نامعتبر را برمی‌گرداند.

 FLOAT بین ۱.۰ و ۵.۰.
max_rating

حداکثر رده‌بندی مکان را برای درنظر گرفتن مشخص می‌کند.

رده‌بندی «مکان‌ها» براساس مرورهای کاربران از مکان است و دامنه‌ای بین ۱٫۰ تا ۵٫۰ دارد

اگر رده‌بندی‌ای خارج از این محدوده مشخص کنید، تابع خطای آرگومان نامعتبر را برمی‌گرداند.

 FLOAT بین ۱.۰ و ۵.۰.
min_user_rating_count

حداقل تعداد رده‌بندی کاربر را برای درنظر گرفتن مشخص می‌کند.

تعداد رده‌بندی‌های کاربر عبارت است از تعداد کل مرورهایی که یک مکان دارد.

حداقل مقدار ۰ است. اگر مقداری کمتر از ۰ مشخص کنید، تابع خطای آرگومان نامعتبر را برمی‌گرداند.

 INT64 حداقل مقدار مجاز ۰ است.
max_user_rating_count

حداکثر تعداد رده‌بندی کاربر را برای درنظر گرفتن مشخص می‌کند.

تعداد رده‌بندی‌های کاربر عبارت است از تعداد کل مرورهایی که یک مکان دارد.

حداقل مقدار ۰ است. اگر مقداری کمتر از ۰ مشخص کنید، تابع خطای آرگومان نامعتبر را برمی‌گرداند.

 INT64 حداقل مقدار مجاز ۰ است.
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 حداقل مقدار ۰ است.
max_ev_charge_connector_count

حداکثر تعداد رابط‌های شارژ خودروِ برقی را مشخص می‌کند.

 INT64 حداقل مقدار ۰ است.
max_ev_max_charge_rate_kw

حداکثر نرخ شارژ را برحسب کیلووات برای ایستگاه‌های شارژ خودرو برقی مشخص می‌کند.

 FLOAT64 حداقل مقدار ۰٫۰ است.
ev_charge_connector_types

انواع رابط خودرو برقی را برای درنظر گرفتن مشخص می‌کند.

 ARRAY<STRING>

مثال: ["EV_CONNECTOR_TYPE_TESLA"]