Places Insights के डेटा और क्वेरी के बारे में जानकारी

जगहों की अहम जानकारी का डेटा

जगहों की अहम जानकारी, BigQuery में पूरे और सैंपल डेटासेट उपलब्ध कराता है.

सैंपल डेटासेट का मकसद, आपको जगहों की अहम जानकारी की सुविधा को आज़माने का मौका देना है. इससे आपको पूरा डेटासेट खरीदने का फ़ैसला लेने से पहले, प्रॉडक्ट की उपयोगिता और वैल्यू का आकलन करने में मदद मिलती है. सैंपल डेटासेट में सिर्फ़ शहर का डेटा शामिल होता है. इसमें आस-पास के मेट्रोपॉलिटन इलाके का डेटा शामिल नहीं होता.

सैंपल लिस्टिंग में, उन सभी देशों के सबसे लोकप्रिय शहर का डेटा शामिल होता है जहां यह सुविधा उपलब्ध है:

ऐम्स्टरडैम (NL) हेलसिंकी (FI) प्लोवडिफ़ (BG)
अंकारा (TR) हॉन्ग कॉन्ग (HK) रिफ़ा (BH)
अरेकीपा (PE) जकार्ता (ID) रोम (IT)
एथेंस (GR) जेद्दाह (SA) सैंटियागो (CL)
बैड गैस्टीन (AT) जोहान्सबर्ग (ZA) साओ पाउलो (BR)
बर्लिन (DE) कुआलालंपुर (MY) शारजाह (AE)
ब्रनो (CZ) लिस्बन (PT) सिंगापुर (SG)
ब्रसेल्स (BE) लंदन (GB) स्टॉकहोम (SE)
बुखारेस्ट (RO) लुसेल (QA) सिडनी (AU)
ब्यूनस आयर्स (AR) मैड्रिड (ES) ताइपे (TW)
बुसान (KR) मनीला (PH) तेल अवीव-याफ़ो (IL)
काहिरा (EG) मेडेलिन (CO) टोक्यो (JP)
चियांग माई (TH) मेक्सिको सिटी (MX) टोरंटो (कनाडा)
कोपनहेगन (DK) मुंबई (IN) वॉरसॉ (PL)
कॉर्क (IE) न्यूयॉर्क सिटी (अमेरिका) वेलिंगटन (NZ)
डेब्रेटसेन (HU) ओस्लो (NO) ज़्यूरिख (CH)
हनोई (VN) पेरिस (FR)

पूरे डेटासेट में, उन सभी देशों का डेटा शामिल होता है जहां यह सुविधा उपलब्ध है. इन्हें खरीदना ज़रूरी है. अगर आपको जगहों की अहम जानकारी के लिए साइन अप करना है, तो अनुरोध फ़ॉर्म भरें. सिर्फ़ डेटा के सदस्य को जगहों की अहम जानकारी के डेटासेट का ऐक्सेस पाने के लिए अनुरोध करना होगा. किसी BigQuery प्रोजेक्ट में सदस्यता चालू होने के बाद, उस प्रोजेक्ट का ऐक्सेस रखने वाला कोई भी उपयोगकर्ता, जगहों की अहम जानकारी वाले डेटा के लिए क्वेरी कर सकता है.

हर देश के डेटासेट की अपनी लिस्टिंग होती है. आपको हर लिस्टिंग की सदस्यता अलग से लेनी होगी. किसी लिस्टिंग की सदस्यता लेने के बारे में ज़्यादा जानने के लिए, जगहों की अहम जानकारी सेट अप करना लेख पढ़ें.

डेटासेट स्कीमा

हर देश के लिए, जगहों के डेटासेट स्कीमा के दो हिस्से होते हैं:

उदाहरण के लिए, अगर स्पेन (ES) के डेटासेट पर काम किया जा रहा है, तो कोर स्कीमा और ES के लिए खास स्कीमा, दोनों को देखें.

ब्रैंड के डेटासेट के स्कीमा में तीन फ़ील्ड तय किए गए हैं:

  • id: ब्रैंड आईडी.
  • name: ब्रैंड का नाम, जैसे कि "Hertz" या "Chase".
  • category: ब्रैंड की हाई-लेवल कैटगरी, जैसे कि "पेट्रोल पंप", "खाना और पीना" या "रहने की जगह".

जगहों की अहम जानकारी देने वाली सुविधा के डेटा के लिए क्वेरी करना

जगहों की अहम जानकारी देने वाली सुविधा, डेटासेट के बारे में क्वेरी करने के दो तरीके उपलब्ध कराती है:

  • एसक्यूएल का इस्तेमाल करके, डेटासेट को सीधे तौर पर क्वेरी करना: डेटासेट टेबल के लिए, स्टैंडर्ड BigQuery एसक्यूएल क्वेरी चलाएं. इससे आपको कई तरह की सुविधाएं मिलती हैं. जैसे, मुश्किल फ़िल्टर लगाना, अपने डेटा के साथ जोड़ना, और कस्टम विश्लेषण करना. साथ ही, COUNT के अलावा अन्य एग्रीगेशन फ़ंक्शन का इस्तेमाल करना, जैसे कि AVG, SUM, और GROUP BY. दस्तावेज़ देखें.
  • Places Count फ़ंक्शन का इस्तेमाल करके डेटासेट से क्वेरी करना: Places Count फ़ंक्शन, पहले से तय की गई और ऑप्टिमाइज़ की गई SQL क्वेरी होती हैं. ये सीधे BigQuery में चलती हैं और डेटा को वापस पाने के सामान्य टास्क को आसान बनाती हैं. इनसे ज़्यादा बारीकी से जानकारी मिलती है. जैसे, अलग-अलग जगहों की जानकारी देखने के लिए, जगह के आईडी वापस पाना. दस्तावेज़ देखें.

डायरेक्ट क्वेरी

डेटा को सीधे तौर पर क्वेरी करने से, एग्रीगेशन थ्रेशोल्ड लागू होता है. नतीजा सिर्फ़ तब दिखता है, जब क्वेरी में कम से कम पांच जगहों की जानकारी शामिल हो. उदाहरण के लिए, अगर खोज के लिए तय की गई शर्तों के हिसाब से नतीजे की संख्या 0, 1, 2, 3 या 4 है, तो नतीजे को जवाब से हटा दिया जाता है. उदाहरण के लिए, किसी इलाके में मौजूद रेस्टोरेंट की कुल संख्या के बारे में क्वेरी करने पर, जवाब सिर्फ़ तब मिलेगा, जब रेस्टोरेंट की कुल संख्या पांच या उससे ज़्यादा होगी. ऐसा न होने पर, कोई जवाब नहीं मिलेगा.

Places Count फ़ंक्शन से जुड़ी क्वेरी

Places Count फ़ंक्शन, जगह के आईडी की सूची दिखा सकते हैं. इसका इस्तेमाल, Places API और जगहों की जानकारी देने वाली यूआई किट जैसे अन्य GMP प्रॉडक्ट का इस्तेमाल करके, किसी जगह की जानकारी देखने के लिए किया जा सकता है.

Places Count फ़ंक्शन, एग्रीगेशन थ्रेशोल्ड लागू नहीं करते. इसके बजाय, वे 40.0 मीटर गुणा 40.0 मीटर (1600 मी2) का कम से कम खोज एरिया लागू करते हैं. इसका मतलब है कि जब तक आपकी सर्च क्वेरी, खोज के लिए तय किए गए कम से कम इलाके से बड़ी है, तब तक आपको हमेशा कोई न कोई नतीजा मिलेगा. भले ही, आपकी क्वेरी से मैच करने वाली कोई जगह न हो.

डेटा को सीधे तौर पर कब क्वेरी करना चाहिए और फ़ंक्शन का इस्तेमाल कब करना चाहिए

अगर आपको कम नतीजों की ज़रूरत नहीं है, तो डेटा को सीधे क्वेरी करें. अगर आपको नतीजों की संख्या के अलावा, अन्य अहम जानकारी चाहिए, जैसे कि AVG, SUM या COUNTIF या फिर आपको डेटासेट को जोड़ने जैसी ज़्यादा जटिल क्वेरी करनी हैं, तो डेटा को सीधे क्वेरी करें.

अगर आपको यह जानना है कि नतीजों की संख्या कम है या शून्य है, तो फ़ंक्शन का इस्तेमाल करके क्वेरी करें. इसके अलावा, अगर आपको किसी जगह की जानकारी, जैसे कि जगह का नाम या पता चाहिए, तो भी फ़ंक्शन का इस्तेमाल करके क्वेरी करें.

इस टेबल में, डायरेक्ट क्वेरी और Places Count फ़ंक्शन के बीच के अंतर की तुलना की गई है.

जगहों की संख्या बताने वाले फ़ंक्शन डेटासेट से जुड़ी डायरेक्ट क्वेरी
फ़ायदे
  • यह जगह के आईडी दिखाता है. इनका इस्तेमाल, अन्य एपीआई से क्वेरी करने के लिए किया जा सकता है.
  • यह कोई भी संख्या दिखा सकता है.
  • इसे परफ़ॉर्मेंस और कम प्रोसेसिंग लागत के लिए ऑप्टिमाइज़ किया गया है.
  • इस्तेमाल करने में आसान. जटिल क्वेरी लिखने की ज़रूरत नहीं है.
  • इनपुट पैरामीटर की पुष्टि करता है और गड़बड़ी दिखाता है. इससे, इसे इस्तेमाल करना और डीबग करना आसान हो जाता है.
  • इससे ऐडवांस फ़िल्टरिंग और जॉइन जैसी मुश्किल क्वेरी की जा सकती हैं.
  • इसमें खोज के लिए कम से कम इलाके की कोई शर्त नहीं होती.
  • COUNT के अलावा, अन्य एग्रीगेट फ़ंक्शन इस्तेमाल किए जा सकते हैं. जैसे, AVG, SUM, और GROUP BY.
इंटरफ़ेस पहले से तय किए गए चार SQL फ़ंक्शन, जो COUNT इनसाइट जनरेट करते हैं: सिंगल काउंट, टाइप के हिसाब से काउंट, देश/इलाके के हिसाब से काउंट, और H3 सेल के हिसाब से काउंट. JSON_OBJECT, फ़ंक्शन को आर्ग्युमेंट पास करता है. COUNT, COUNT_IF, SUM, और AVG. जैसे एग्रीगेशन फ़ंक्शन चलाने के लिए, अपना एसक्यूएल लिखें. JOIN, GROUP BY, WHERE वगैरह का इस्तेमाल करके, ज़्यादा अहम जानकारी जनरेट की जा सकती है.
पाबंदियां यह खोज के लिए कम से कम 40.0 मीटर गुणा 40.0 मीटर (1600 मी2) का इलाका तय करता है. अगर एग्रीगेशन की संख्या पांच से कम है, तब भी फ़ंक्शन नतीजा दिखाता है. हालांकि, इसके लिए ज़रूरी है कि खोज का दायरा कम से कम तय की गई सीमा के बराबर हो. जिन नतीजों की संख्या पांच से कम होती है उन्हें नतीजों से हटा दिया जाता है. इसका मतलब है कि पंक्ति को हटा दिया जाता है.
इस्तेमाल किए जा सकने वाले एट्रिब्यूट फ़िल्टर Places Count फ़ंक्शन के फ़िल्टर पैरामीटर, डायरेक्ट क्वेरी एट्रिब्यूट फ़िल्टर की तरह ही काम करते हैं. हालांकि, इनमें ये शामिल नहीं हैं:
  • जगह id
  • पते के कॉम्पोनेंट
पूरा स्कीमा इस्तेमाल किया जा सकता है.