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

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

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

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

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

इसके अलावा, डेटासेट मैनेज करने के लिए इस्तेमाल किए जाने वाले उपयोगकर्ता खाते या सेवा खाते को ये 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 में दिखाया जाता है. कुछ भाषाओं में, हर वर्ण को कई बाइट में दिखाया जा सकता है.
• ब्यौरे 1,000 बाइट से कम होने चाहिए.

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

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

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

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

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

1. सुविधा की प्रॉपर्टी कम करें. अपने मैप को स्टाइल देने के लिए, सिर्फ़ ज़रूरी फ़ीचर प्रॉपर्टी रखें. उदाहरण के लिए, "आईडी" और "कैटगरी". यूनीक आइडेंटिफ़ायर कुंजी पर डेटा-ड्रिवन स्टाइल का इस्तेमाल करके, क्लाइंट ऐप्लिकेशन में किसी सुविधा में अन्य प्रॉपर्टी जोड़ी जा सकती हैं. उदाहरण के लिए, देखें कि डेटा-ड्रिवन स्टाइलिंग की मदद से, रीयल टाइम में अपना डेटा कैसे देखा जा सकता है.
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 के अलावा किसी दूसरे कोऑर्डिनेट रेफ़रंस सिस्टम (सीआरएस) में डेटा हो.

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

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

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

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

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

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

CSV फ़ाइल से जुड़ी ज़रूरी शर्तें

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

• latitude, longitude
• lat, long
• x, y
• wkt (Well-Known Text)
• 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. बनाएं पर क्लिक करें. डेटासेट पेज दिखेगा, जिसमें आपका नया डेटासेट दिखेगा. स्टेटस प्रोसेसिंग में है होना चाहिए.

   डेटा अपलोड होने पर:

   • डेटासेट का स्टेटस पूरा हो गया पर सेट है.
   • डेटासेट, "चालू" वर्शन बन जाता है और यह वह वर्शन होता है जिसका इस्तेमाल आपके ऐप्लिकेशन में किया जाता है.

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

   • डेटासेट के नए वर्शन का स्टेटस, पूरा हो गया के अलावा किसी दूसरे स्टेटस पर सेट हो.

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

डेटासेट बनाने के बाद, उसे देखा जा सकता है या उसमें बदलाव किया जा सकता है:

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

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

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

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

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

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