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

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

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

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

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

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

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

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 (लोकप्रिय टेक्स्ट)
  • 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. डेटासेट मिटाने के लिए, मिटाएं बटन पर क्लिक करें.