डेटासेट बनाना और मैनेज करना

डेटासेट की मदद से, किसी स्थानीय फ़ाइल या Google Cloud Storage से Google Maps Platform में जियोस्पेशियल डेटा अपलोड किया जा सकता है. इसके बाद, Cloud Console में डेटासेट को एक या उससे ज़्यादा मैप स्टाइल के साथ जोड़ा जा सकता है. डेटासेट को मैप की स्टाइल से जोड़ने के बाद, अपने मैप ऐप्लिकेशन को डाइनैमिक तरीके से स्टाइल करने के लिए डेटा-ड्रिवन स्टाइलिंग एपीआई का इस्तेमाल करें.

अपने जियोस्पेशियल डेटा को किसी डेटासेट में अपलोड करने के लिए, REST API का इस्तेमाल भी किया जा सकता है. ज़्यादा जानकारी के लिए, Maps Datasets API देखें

भूमिकाएं कॉन्फ़िगर करें

Google Cloud प्रोजेक्ट में डेटासेट बनाने और उन्हें मैनेज करने के लिए, आपके पास प्रोजेक्ट में मालिक या एडिटर की आईएएम की भूमिका होनी चाहिए.

ध्यान दें: अगर आपने प्रोजेक्ट बनाया है, तो आपके पास प्रोजेक्ट के मालिक की भूमिका होगी. Google Cloud Console के आईएएम पेज पर, प्रोजेक्ट के मालिकों और एडिटर की जानकारी दिखती है.

इसके अलावा, ऐसे उपयोगकर्ता खाते या सेवा खाते को ये IAM भूमिकाएं असाइन की जा सकती हैं जिनका इस्तेमाल डेटासेट मैनेज करने के लिए किया जाता है:

• Maps Platform Datasets Admin की भूमिका, उपयोगकर्ता या सेवाओं के खाते को प्रोजेक्ट के डेटासेट पढ़ने/लिखने का ऐक्सेस देती है. इस भूमिका से, उपयोगकर्ता किसी डेटासेट पर सभी कार्रवाइयां कर सकता है.
• Maps Platform Datasets Viewer भूमिका, प्रोजेक्ट के डेटासेट का रीड ओनली ऐक्सेस देती है. इस भूमिका से, आपको किसी डेटासेट पर सूची बनाने, उसे पाने या डाउनलोड करने की सुविधा मिलती है.

ज़्यादा जानकारी के लिए, Google Cloud Console का इस्तेमाल करके IAM की भूमिका देना लेख पढ़ें.

डेटासेट के लिए डेटा सोर्स

डेटासेट बनाने के बाद, Google Cloud Storage या किसी लोकल फ़ाइल से डेटासेट में डेटा अपलोड करें.

• Cloud Storage से डेटा अपलोड करते समय, उस संसाधन का फ़ाइल पाथ तय करें जिसमें Cloud Storage में मौजूद डेटा हो. यह पाथ gs://GCS_BUCKET/FILE फ़ॉर्मैट में है.

  अनुरोध करने वाले उपयोगकर्ता के पास, स्टोरेज ऑब्जेक्ट व्यूअर की भूमिका या कोई ऐसी अन्य भूमिका होनी चाहिए जिसमें storage.objects.get की अनुमति शामिल हो. Cloud Storage का ऐक्सेस मैनेज करने के बारे में ज़्यादा जानने के लिए, ऐक्सेस कंट्रोल की खास जानकारी देखें.

• किसी लोकल फ़ाइल से डेटा अपलोड करते समय, GeoJSON, KML या CSV फ़ाइल का पाथ बताएं, जिसमें अपलोड किया जाने वाला डेटा शामिल है.

ज़रूरी शर्तें

डेटासेट बनाते समय:

• आपके Google Cloud प्रोजेक्ट के डिसप्ले नेम यूनीक होने चाहिए.
• डिसप्ले नेम 64 बाइट से कम होने चाहिए (क्योंकि ये वर्ण UTF-8 में दिखाए जाते हैं. इसलिए, कुछ भाषाओं में हर वर्ण को एक से ज़्यादा बाइट से दिखाया जा सकता है).
• जानकारी 1000 बाइट से कम होनी चाहिए.

डेटा अपलोड करते समय:

• CSV, GeoJSON, और KML फ़ाइल टाइप का इस्तेमाल किया जा सकता है.
• फ़ाइल का साइज़ 350 एमबी से ज़्यादा नहीं होना चाहिए.
• विशेषता कॉलम के नाम स्ट्रिंग "?_" से शुरू नहीं हो सकते.
• 3-डाइमेंशन वाली ज्यामितियां काम नहीं करतीं. इसमें WKT फ़ॉर्मैट में "Z" सफ़िक्स और GeoJSON फ़ॉर्मैट में ऐल्टिट्यूड कोऑर्डिनेट शामिल है.

ध्यान दें: डेटा फ़ाइल के साइज़ के आधार पर, अपलोड को पूरा होने में कुछ मिनट या कई घंटे लग सकते हैं. अगर अपलोड के दौरान कोई गड़बड़ी होती है, तो आपको गड़बड़ी का मैसेज मिलेगा. डेटासेट को तब तक मिटाने की कोशिश न करें, जब तक कि अपलोड की कार्रवाई से कोई जवाब न मिल जाए.

ध्यान दें: Maps Datasets API का इस्तेमाल करके अपलोड किए गए डेटा की मदद से बनाई गई मैप टाइल, कम ज़ूम लेवल पर कई और मुश्किल डेटा को ड्रॉप या आसान बना सकती हैं. उदाहरण के लिए, जब कोई उपयोगकर्ता किसी राज्य या देश (उदाहरण के लिए, ज़ूम लेवल 5-12) पर ज़ूम आउट करता है, तो टाइल वाला डेटा किसी शहर या आस-पास के ज़ूम इन करने पर अलग दिख सकता है (उदाहरण के लिए, ज़ूम लेवल 13-18). ऐसा इसलिए होता है, ताकि मैप रेंडरर वाली टाइल का इस्तेमाल करके टाइल को पतला और अच्छा परफ़ॉर्म करने वाला बनाया जा सके.

सलाह: अगर आपकी डेटा फ़ाइल बड़ी है और उसमें ऐसे कई एट्रिब्यूट हैं जो स्टाइलिंग के लिए ज़रूरी नहीं हैं और आपको रेंडरिंग की परफ़ॉर्मेंस को ऑप्टिमाइज़ करना है, तो ग़ैर-ज़रूरी एट्रिब्यूट हटाने के लिए फ़ाइल में बदलाव करें. एट्रिब्यूट की संख्या कम करने से, मैप की टाइल का साइज़ कम हो जाता है. इससे रेंडरिंग की परफ़ॉर्मेंस बेहतर होती है.

डेटा तैयार करने के सबसे सही तरीके

अगर आपका सोर्स डेटा जटिल या बड़ा है, जैसे कि डेंसिटी पॉइंट, लंबी लाइनस्ट्रिंग या पॉलीगॉन (अक्सर 50 एमबी से बड़ी सोर्स फ़ाइल का साइज़ इस कैटगरी में आता है), तो विज़ुअल मैप में सबसे अच्छी परफ़ॉर्मेंस पाने के लिए डेटा अपलोड करने से पहले उसे आसान बनाएं.

यहां अपना डेटा तैयार करने के कुछ सबसे सही तरीके बताए गए हैं:

1. सुविधा की प्रॉपर्टी को छोटा करना. सिर्फ़ अपने मैप को स्टाइल करने के लिए ज़रूरी फ़ीचर प्रॉपर्टी ही रखें, जैसे कि "id" और "category". आपके पास किसी क्लाइंट ऐप्लिकेशन की सुविधा में अन्य प्रॉपर्टी को जोड़ने की सुविधा होती है. इसके लिए, आपको यूनीक आइडेंटिफ़ायर कुंजी पर डेटा-ड्रिवन स्टाइल का इस्तेमाल करना होगा. उदाहरण के लिए, डेटा-ड्रिवन स्टाइल की मदद से रीयल टाइम में अपना डेटा देखना देखें.
2. जहां संभव हो, प्रॉपर्टी ऑब्जेक्ट के लिए आसान डेटा टाइप इस्तेमाल करें, जैसे कि पूर्णांक, टाइल के साइज़ को कम करने और मैप की परफ़ॉर्मेंस को बेहतर बनाने के लिए.
3. फ़ाइल अपलोड करने से पहले जटिल ज्यामितियां आसान बनाएं. इसके लिए, अपनी पसंद के जियोस्पेशियल टूल का इस्तेमाल किया जा सकता है. जैसे, ओपन सोर्स Mapshaper.org सुविधा. इसके अलावा, BigQuery में कॉम्प्लेक्स पॉलीगॉन ज्यामिति का इस्तेमाल करके ST_Simplify का इस्तेमाल किया जा सकता है.
4. फ़ाइल अपलोड करने से पहले बहुत सघन बिंदु. ऐसा करने के लिए, अपनी पसंद के जियोस्पेशियल टूल का इस्तेमाल किया जा सकता है. जैसे, ओपन सोर्स के turf.js क्लस्टर फ़ंक्शन या BigQuery में सघन बिंदु वाली ज्यामितीय आकृतियों के लिए ST_CLUSTERDBSCAN का इस्तेमाल करना.

डेटासेट और BigQuery की मदद से अपने डेटा को विज़ुअलाइज़ करना में, डेटासेट को इस्तेमाल करने के सबसे सही तरीकों के बारे में ज़्यादा जानकारी देखें.

GeoJSON से जुड़ी ज़रूरी शर्तें

Maps JavaScript API, GeoJSON के मौजूदा स्पेसिफ़िकेशन के साथ काम करता है. Maps JavaScript API, GeoJSON फ़ाइलों के साथ काम करता है जिनमें इनमें से कोई भी ऑब्जेक्ट टाइप शामिल होता है:

• ज्यामिति ऑब्जेक्ट. ज्यामिति ऑब्जेक्ट एक जगह का आकार होता है, जिसमें वैकल्पिक छेद वाले पॉइंट, लाइन, और पॉलीगॉन मिलकर होते हैं.
• फ़ीचर ऑब्जेक्ट. किसी फ़ीचर ऑब्जेक्ट में एक ज्यामिति के साथ-साथ अतिरिक्त नाम/वैल्यू पेयर होते हैं, जिनका मतलब ऐप्लिकेशन के हिसाब से अलग-अलग होता है.
• कलेक्शन दिखाएं. सुविधा संग्रह, फ़ीचर ऑब्जेक्ट का एक सेट होता है.

Maps JavaScript API, GeoJSON फ़ाइलों के साथ काम नहीं करता जिनमें WGS84 के अलावा, किसी कोऑर्डिनेट रेफ़रंस सिस्टम (CRS) में डेटा होता है.

GeoJSON के बारे में ज़्यादा जानकारी के लिए, आरएफ़सी 7946 का पालन करने वाला देखें.

KML की ज़रूरी शर्तें

Maps JavaScript API की ये ज़रूरी शर्तें हैं:

• सभी यूआरएल, फ़ाइल से जुड़े हुए (या मिलते-जुलते) होने चाहिए.
• पॉइंट, लाइन, और पॉलीगॉन की ज्यामितियां इस्तेमाल की जा सकती हैं.
• डेटा के सभी एट्रिब्यूट को स्ट्रिंग माना जाता है.

KML की ये सुविधाएं काम नहीं करती हैं:

• फ़ाइल के बाहर तय किए गए आइकॉन या <styleUrl>.
• नेटवर्क लिंक, जैसे कि <NetworkLink>
• ग्राउंड ओवरले, जैसे कि <GroundOverlay>
• 3D ज्यामितियां या ऊंचाई से संबंधित कोई भी टैग, जैसे कि <altitudeMode>
• कैमरे की खास जानकारी, जैसे कि <LookAt>
• KML फ़ाइल में तय की गई शैलियां.

CSV की ज़रूरी शर्तें

CSV फ़ाइलों के लिए, प्राथमिकता के हिसाब से इस्तेमाल किए जा सकने वाले कॉलम के नाम नीचे दिए गए हैं:

• latitude, longitude
• lat, long
• x, y
• wkt (जाने-पहचाने टेक्स्ट)
• address, city, state, zip
• address
• एक कॉलम जिसमें पते की सारी जानकारी होती है, जैसे 1600 Amphitheatre Parkway Mountain View, CA 94043

उदाहरण के लिए, आपकी फ़ाइल में x, y, और wkt नाम के कॉलम हैं. x और y की प्राथमिकता ज़्यादा है. इन्हें ऊपर दी गई सूची में इस्तेमाल किए जा सकने वाले कॉलम के नामों के क्रम से तय किया जाता है. इसलिए, x और y कॉलम की वैल्यू का इस्तेमाल किया जाता है और wkt कॉलम को अनदेखा कर दिया जाता है.

इसके अलावा:

• हर कॉलम का नाम एक ही कॉलम से जुड़ा होना चाहिए. इसका मतलब है कि आपके पास xy नाम का ऐसा कॉलम नहीं हो सकता जिसमें x और y दोनों कोऑर्डिनेट डेटा शामिल हो. x और y कोऑर्डिनेट अलग-अलग कॉलम में होने चाहिए.
• कॉलम के नाम केस-इनसेंसिटिव होते हैं.
• कॉलम के नामों का क्रम कोई मायने नहीं रखता. उदाहरण के लिए, अगर आपकी CSV फ़ाइल में lat और long कॉलम हैं, तो वे किसी भी क्रम में हो सकते हैं.

डेटा अपलोड करने में होने वाली गड़बड़ियां ठीक करना

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

GeoJSON से जुड़ी गड़बड़ियां

GeoJSON की सामान्य गड़बड़ियों में ये शामिल हैं:

• type फ़ील्ड मौजूद नहीं है या type कोई स्ट्रिंग नहीं है. अपलोड की गई GeoJSON डेटा फ़ाइल में, हर फ़ीचर ऑब्जेक्ट और जियोमेट्री ऑब्जेक्ट की परिभाषा के हिस्से के तौर पर, type नाम का एक स्ट्रिंग फ़ील्ड होना चाहिए.

KML गड़बड़ियां

KML की सामान्य गड़बड़ियों में ये शामिल हैं:

• डेटा फ़ाइल में, ऊपर दी गई सूची में काम न करने वाली कोई KML सुविधा नहीं होनी चाहिए. ऐसा न करने पर, हो सकता है कि डेटा इंपोर्ट न हो.

CSV फ़ाइल में गड़बड़ियां

CSV फ़ाइल में आम तौर पर होने वाली गड़बड़ियां:

• ज्यामिति कॉलम की कुछ पंक्तियों में वैल्यू नहीं हैं. CSV फ़ाइल की सभी पंक्तियों में ज्यामिति कॉलम के लिए ऐसे मान होने चाहिए जो खाली न हों. ज्यामिति कॉलम में ये शामिल हैं:
  • latitude, longitude
  • lat, long
  • x, y
  • wkt
  • address, city, state, zip
  • address
  • एक कॉलम जिसमें पते की सारी जानकारी होती है, जैसे 1600 Amphitheatre Parkway Mountain View, CA 94043
  ध्यान दें: इस गड़बड़ी को अक्सर एक मैसेज में बताया जाता है. मैसेज में इस तरह की जानकारी दी जाती है: "' ' को डबल में नहीं बदला जा सकता" या "देश या इलाके में इनपुट को पार्स नहीं किया जा सका.: देश या इलाके के हिसाब से वैल्यू मौजूद नहीं है".
• अगर x और y आपके ज्यामिति कॉलम हैं, तो पक्का करें कि यूनिट देशांतर और अक्षांश हों. कुछ सार्वजनिक डेटासेट, x और y हेडर के तहत अलग-अलग कोऑर्डिनेट सिस्टम का इस्तेमाल करते हैं. गलत इकाइयों का इस्तेमाल करने पर, डेटासेट इंपोर्ट हो सकता है. हालांकि, रेंडर किया गया डेटा, ऐसी जगहों पर डेटासेट पॉइंट दिखा सकता है जहां इसकी उम्मीद नहीं थी.

डेटासेट बनाना

डेटासेट बनाने के लिए:

1. Google Cloud Console में, डेटासेट पेज पर जाएं.
2. डेटासेट बनाएं पर क्लिक करें.
3. डेटासेट का नाम डालें. यह नाम सभी डेटासेट के बीच खास होना चाहिए.
4. डेटासेट के लिए जानकारी डालें. हालांकि, ऐसा करना ज़रूरी नहीं है.
5. जारी रखें पर क्लिक करें. इसके बाद, डेटा इंपोर्ट करें पेज दिखेगा.
6. डेटासेट को डेस्कटॉप के तौर पर भरने के लिए जिस डेटा का इस्तेमाल किया गया है उसका अपलोड सोर्स चुनें. इसका मतलब है कि आपके सिस्टम में मौजूद एक लोकल फ़ाइल या Google Cloud Storage बकेट.
   • डेस्कटॉप पर जाने के लिए, ब्राउज़ करें पर क्लिक करें. इसके बाद, फ़ाइल चुनने के विकल्प से फ़ाइल चुनें.
   • Google Cloud Storage बकेट के लिए, ब्राउज़ करें पर क्लिक करें और वह बकेट और फ़ाइल चुनें जिसमें डेटा है.
7. फ़ाइल फ़ॉर्मैट चुनें.
8. अपनी सेटिंग देखने के लिए जारी रखें पर क्लिक करें.
9. बनाएं पर क्लिक करें. ऐसा करने पर, डेटासेट पेज आपका नया डेटासेट दिखा रहा है. स्टेटस, प्रोसेस जारी है होनी चाहिए.
10. अपने डेटासेट की स्थिति पूरा हो गया होने तक इंतज़ार करें.

डेटासेट देखना या उसमें बदलाव करना

डेटासेट बनाने के बाद, उसका स्टेटस पूरा हो गया के तौर पर दिखता है. इसके बाद, डेटासेट की जानकारी देखी जा सकती है.

डेटासेट देखने या उसमें बदलाव करने के लिए:

1. Google Cloud Console में, डेटासेट पेज पर जाएं.
2. डेटासेट के नाम पर क्लिक करें. डेटासेट की जानकारी वाला पेज दिखेगा.
   1. डेटासेट के बारे में जानकारी देखने के लिए, ब्यौरा टैब पर क्लिक करें. इस टैब पर, डेटासेट के नाम और जानकारी में बदलाव भी किया जा सकता है.
   2. मैप पर अपना डेटासेट देखने के लिए, झलक देखें टैब पर क्लिक करें.
   3. डेटासेट के सभी एट्रिब्यूट देखने के लिए, टेबल का डेटा टैब पर क्लिक करें. ये ऐसे एट्रिब्यूट हैं जिनका इस्तेमाल करके मैप पर डेटासेट को स्टाइल किया जा सकता है.
   4. डेटा को किसी लोकल फ़ाइल में डाउनलोड करने के लिए, डाउनलोड करें बटन पर क्लिक करें.
   5. डेटासेट मिटाने के लिए, मिटाएं बटन पर क्लिक करें.

   6. डेटासेट में नया डेटा अपलोड करने के लिए, डेटा फ़ाइल इंपोर्ट करें बटन पर क्लिक करें.

      डेटासेट में नया डेटा अपलोड करने से, डेटासेट का एक नया वर्शन बन जाता है. अगर नया डेटा अपलोड हो जाता है, तो:

      • डेटासेट के नए वर्शन की स्थिति COMPLETED पर सेट है.
      • नया वर्शन, "ऐक्टिव" वर्शन बन जाता है. साथ ही, यह वह वर्शन होता है जिसे आपके ऐप्लिकेशन में इस्तेमाल किया जाता है.

      अगर अपलोड में कोई गड़बड़ी है, तो:

      • डेटासेट के नए वर्शन की स्थिति, COMPLETED के बजाय किसी दूसरी स्थिति पर सेट है. उदाहरण के लिए, अगर कोई पिछला "चालू" वर्शन मौजूद है, तो डेटासेट की स्थिति वापस ले ली गई पर सेट होती है.
      • डेटासेट का पिछला "चालू" वर्शन, "चालू" वर्शन के तौर पर ही रहता है और वही वर्शन आपके ऐप्लिकेशन में इस्तेमाल होता है.