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

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

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

نام فیلتر توضیحات تایپ کنید ارزش های پشتیبانی شده
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