بیشتر در مورد فیلترهای نوع، بیشتر در مورد فیلترهای نوع، بیشتر در مورد فیلترهای نوع

در Places Aggregate API، فیلتر نوع به شما کمک می‌کند جستجوی خود را متمرکز کنید و به شما امکان می‌دهد نوع مکان‌هایی را که می‌خواهید در پاسخ قرار دهید یا از آن حذف کنید، متمرکز کنید. شما می توانید لیستی از انواع مورد نظر و انواعی که نمی خواهید، هم برای دسته اصلی یک مکان و هم برای سایر جزئیات آن ایجاد کنید. به این ترتیب، می توانید جستجوهای خاصی را ایجاد کنید تا دقیقاً مکان های مورد نظر خود را پیدا کنید.

بیش از 200 نوع مکان موجود است. برای فهرست کاملی که Places Aggregate API از آن پشتیبانی می کند، به جدول A در قسمت Place Types for Places API (جدید) مراجعه کنید.

انواع مکان چگونه کار می کنند

یک مکان می تواند چندین نوع مکان داشته باشد:

• یک مکان می تواند یک نوع اصلی داشته باشد که عملکرد اصلی آن را منعکس می کند. با این حال، در برخی موارد، نوع اولیه ممکن است برای یک مکان مشخص نشده باشد.

• یک مکان می تواند یک یا چند نوع ثانویه داشته باشد. انواع ثانویه دسته های اضافی هستند که برای ارائه اطلاعات تکمیلی در مورد ویژگی ها و خدمات مکان به یک مکان اعمال می شوند.

به عنوان مثال، یک مکان ممکن است نوع اصلی خود را به عنوان restaurant مشخص کند، اما از آنجایی که به عنوان یک بار نیز خدمت می کند و خدمات غذایی ارائه می دهد، می تواند انواع مکان ثانویه خود را نیز به عنوان bar, food ، و establishment مشخص کند.

بر اساس نوع فیلتر کنید

برای فیلتر کردن مکان‌ها بر اساس نوع اصلی ، includedPrimaryTypes و excludedPrimaryTypes در درخواست استفاده کنید. فیلتر فقط برای نوع اصلی مکان اعمال می شود. برای مثال، یک فیلتر includedPrimaryTypes برای restaurant فقط مکان‌هایی را برمی‌گرداند که عمدتاً به عنوان رستوران عمل می‌کنند.

برای فیلتر کردن مکان‌ها بر اساس نوع اولیه و ثانویه ، از includedTypes و excludedTypes در درخواست استفاده کنید. فیلتر برای هر دو نوع اعمال می شود. برای مثال، یک bar includedTypes مکان‌هایی را برمی‌گرداند که دارای bar به عنوان نوع اصلی یا ثانویه هستند.

مهم: هنگام استفاده از چندین فیلتر، درک تعامل بین فیلترها مهم است. به طور خاص، مکان ها با استفاده از منطق OR در همان فیلتر و منطق AND در فیلترهای مختلف ارزیابی می شوند.

• درون یک فیلتر (OR منطق): به عنوان مثال، includedTypes: restaurant, bar به این معنی است که مکان می تواند یک restaurant یا یک bar باشد.
• در سراسر فیلترها (منطق و منطق): همه معیارهای فیلتر مشخص شده باید به طور همزمان برآورده شوند. این بدان معنی است که هر فیلتر یک لایه محدودیت به پرس و جو اضافه می کند و تنها مکان هایی که همه شرایط را دارند در نتایج گنجانده می شوند.

به عنوان مثال، اگر includedTypes: restaurant, bar و excludedTypes: hotel را تنظیم کنید. ابتدا، فیلتر includedTypes همه مکان‌هایی را که به عنوان restaurant یا bar طبقه‌بندی می‌شوند، انتخاب می‌کند. ثانیاً، فیلتر excludedTypes سپس مکان‌هایی را که به عنوان hotel طبقه‌بندی می‌شوند، از این انتخاب حذف می‌کند. در نتیجه، پرس و جو مکان هایی را که یا restaurant یا bar هستند، باز می گرداند، اما تنها در صورتی که به عنوان hotel در هیچ یک از انواع خود (اصلی یا ثانویه) طبقه بندی نشده باشند.