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

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

Places Insights, BigQuery में पूरे और सैंपल डेटासेट उपलब्ध कराता है.

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

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

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

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

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

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

• कोर स्कीमा, जो सभी देशों के डेटासेट के लिए सामान्य है.
• देश के हिसाब से स्कीमा जो उस देश के हिसाब से स्कीमा कॉम्पोनेंट तय करता है.

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

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

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

ध्यान दें: फ़िलहाल, ब्रैंड का डेटा सिर्फ़ अमेरिका के लिए उपलब्ध है.

Places Insights के डेटा के लिए क्वेरी करना

Places Insights में, डेटासेट के बारे में क्वेरी करने के दो तरीके हैं:

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

सीधी क्वेरी

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

Places Count फ़ंक्शन की क्वेरी

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

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

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

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

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

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

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