टाइप फ़िल्टर के बारे में ज़्यादा जानकारी

Places Aggregate API में, type filter की मदद से, अपनी खोज को फ़ोकस किया जा सकता है. इससे यह चुना जा सकता है कि आपको जवाब में किस तरह की जगहों को शामिल करना है या हटाना है. आपको जिस तरह की जानकारी चाहिए और जिस तरह की जानकारी नहीं चाहिए, उसकी लिस्ट बनाई जा सकती है. ऐसा किसी जगह की मुख्य कैटगरी और उसकी अन्य जानकारी, दोनों के लिए किया जा सकता है. इस तरह, आपको अपनी पसंद की जगहों को ढूंढने के लिए, खास खोजें बनाने का विकल्प मिलता है.

जगह के 200 से ज़्यादा टाइप उपलब्ध हैं. Places Aggregate API के साथ काम करने वाले सभी टाइप की पूरी सूची देखने के लिए, Places API (नया) के जगह के टाइप में जाकर टेबल A देखें.

जगह के टाइप कैसे काम करते हैं

किसी जगह की कई कैटगरी हो सकती हैं:

• किसी जगह का एक प्राइमरी टाइप हो सकता है, जो उसके मुख्य फ़ंक्शन को दिखाता है. हालांकि, कुछ मामलों में किसी जगह के लिए मुख्य टाइप तय नहीं किया जा सकता.

• किसी जगह के एक या उससे ज़्यादा सेकंडरी टाइप हो सकते हैं. सेकंडरी टाइप, अतिरिक्त कैटगरी होती हैं. ये किसी जगह पर लागू होती हैं, ताकि उस जगह की विशेषताओं और सेवाओं के बारे में अतिरिक्त जानकारी दी जा सके.

उदाहरण के लिए, कोई जगह अपने मुख्य टाइप के तौर पर restaurant को सेट कर सकती है. हालांकि, बार और खाने की सेवाएं देने की वजह से, वह जगह अपने दूसरे टाइप के तौर पर bar, food और establishment को भी सेट कर सकती है.

प्रकार के अनुसार फ़िल्टर करें

जगहों को प्राइमरी टाइप के हिसाब से फ़िल्टर करने के लिए, अनुरोध में includedPrimaryTypes और excludedPrimaryTypes का इस्तेमाल करें. यह फ़िल्टर, किसी जगह के सिर्फ़ प्राइमरी टाइप पर लागू होता है. उदाहरण के लिए, restaurant के लिए includedPrimaryTypes फ़िल्टर सिर्फ़ उन जगहों को दिखाता है जो मुख्य रूप से रेस्टोरेंट के तौर पर काम करती हैं.

जगहों को प्राइमरी और सेकंडरी, दोनों टाइप के हिसाब से फ़िल्टर करने के लिए, अनुरोध में includedTypes और excludedTypes का इस्तेमाल करें. फ़िल्टर, दोनों टाइप पर लागू होता है. उदाहरण के लिए, includedTypes के bar से, ऐसी जगहें दिखती हैं जिनका प्राइमरी या सेकंडरी टाइप कोई भी हो सकता है.bar

अहम जानकारी: एक से ज़्यादा फ़िल्टर इस्तेमाल करते समय, यह समझना ज़रूरी है कि फ़िल्टर एक-दूसरे के साथ कैसे इंटरैक्ट करते हैं. खास तौर पर, जगहों का आकलन एक ही फ़िल्टर में OR लॉजिक का इस्तेमाल करके किया जाता है. वहीं, अलग-अलग फ़िल्टर में AND लॉजिक का इस्तेमाल किया जाता है.

• फ़िल्टर में (OR लॉजिक): उदाहरण के लिए, includedTypes: restaurant, bar का मतलब है कि जगह restaurant या bar हो सकती है.
• सभी फ़िल्टर के लिए (AND लॉजिक): फ़िल्टर करने की सभी शर्तें एक साथ पूरी होनी चाहिए. इसका मतलब है कि हर फ़िल्टर, क्वेरी पर प्रतिबंध की एक लेयर जोड़ता है. साथ ही, नतीजे में सिर्फ़ वे जगहें शामिल की जाएंगी जो सभी शर्तों को पूरा करती हैं.

उदाहरण के लिए, अगर आपने includedTypes: restaurant, bar और excludedTypes: hotel सेट किया है, तो includedTypes फ़िल्टर उन सभी जगहों को चुनेगा जिन्हें restaurant या bar के तौर पर कैटगरी में रखा गया है. इसके बाद, excludedTypes फ़िल्टर, इस चुने गए डेटा में से उन जगहों को हटा देगा जिन्हें hotel के तौर पर भी कैटगरी में रखा गया है. इस वजह से, क्वेरी के जवाब में ऐसी जगहें दिखेंगी जो restaurant या bar हैं. हालांकि, ऐसा सिर्फ़ तब होगा, जब उन्हें किसी भी टाइप (मुख्य या दूसरा) में hotel के तौर पर भी कैटगरी में न रखा गया हो.