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

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

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

نام فیلتر توضیحات نوع مقادیر پشتیبانی شده
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 حداقل 0 است.
h3_resolution

فقط برای PLACES_COUNT_PER_H3

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

 INT64 بین ۰ تا ۸.
types

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

هر مکان شامل مجموعه‌ای از انواع مکان‌ها است، برای مثال "restaurant" و "cafe" . اگر هیچ نوعی مشخص نشود، همه انواع مکان‌ها در نتیجه در نظر گرفته می‌شوند.

 ARRAY<STRING>

برای لیست کامل مقادیر ممکن، به Place types مراجعه کنید.

مثال:

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

primary_types

انواع اصلی مورد بررسی را مشخص می‌کند.

یک مکان فقط می‌تواند یک نوع اصلی داشته باشد که آن نوع، بهترین توصیف‌کننده‌ی مکان است.

اگر هیچ نوع اصلی مشخص نشده باشد، تمام انواع اصلی موجود در نتیجه در نظر گرفته می‌شوند.

 ARRAY<STRING>

برای لیست کامل مقادیر ممکن، به Place types مراجعه کنید.

مثال:

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

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

رتبه‌بندی مکان‌ها بر اساس نظرات کاربران در مورد مکان است و دامنه‌ای بین ۱.۰ تا ۵.۰ دارد.

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

 FLOAT بین ۱.۰ تا ۵.۰.
max_rating

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

رتبه‌بندی مکان‌ها بر اساس نظرات کاربران در مورد مکان است و دامنه‌ای بین ۱.۰ تا ۵.۰ دارد.

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

 FLOAT بین ۱.۰ تا ۵.۰.
min_user_rating_count

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

تعداد امتیاز کاربران، تعداد کل نظراتی است که یک مکان دارد.

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

 INT64 حداقل مقدار 0 است.
max_user_rating_count

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

تعداد امتیاز کاربران، تعداد کل نظراتی است که یک مکان دارد.

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

 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