डेटासेट की मदद से, आप किसी स्थानीय फ़ाइल या Google Cloud Storage से जियोस्पेशल डेटा को Google Maps Platform. इसके बाद, डेटासेट को एक या उससे ज़्यादा मैप स्टाइल से जोड़ा जा सकता है Cloud Console पर जाना होगा. डेटासेट को मैप की शैली से जोड़ने के बाद, डेटा-ड्रिवन स्टाइलिंग एपीआई, ताकि आपके मैप ऐप्लिकेशन को डाइनैमिक तरीके से स्टाइल किया जा सके.
अपने जियोस्पेशियल डेटा को किसी डेटासेट में अपलोड करने के लिए, REST API का इस्तेमाल भी किया जा सकता है. ज़्यादा जानकारी के लिए, Maps Datasets API देखें
भूमिकाएं कॉन्फ़िगर करें
Google Cloud प्रोजेक्ट में डेटासेट बनाने और उन्हें मैनेज करने के लिए, आपको मालिक या एडिटर आईएएम की भूमिका प्रोजेक्ट पर.
इसके अलावा, किसी उपयोगकर्ता खाते को यहां दी गई आईएएम भूमिकाएं असाइन की जा सकती हैं या सेवा खाता मौजूद होना चाहिए, जिसका इस्तेमाल डेटासेट मैनेज करने के लिए किया जाता है:
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 फ़ाइल टाइप का इस्तेमाल किया जा सकता है.
- फ़ाइल का साइज़ 500 एमबी से ज़्यादा नहीं होना चाहिए.
- विशेषता कॉलम के नाम स्ट्रिंग "?_" से शुरू नहीं हो सकते.
- 3-डाइमेंशन वाली ज्यामितियां काम नहीं करतीं. इसमें "Z" शामिल है WKT फ़ॉर्मैट में सफ़िक्स है, और GeoJSON फ़ॉर्मैट में ऊंचाई कोऑर्डिनेट सबमिट किए जा सकते हैं.
डेटा तैयार करने के सबसे सही तरीके
अगर आपका सोर्स डेटा जटिल या बड़ा है, जैसे कि सघन बिंदु, लंबी लाइनस्ट्रिंग या पॉलीगॉन (अक्सर 50 एमबी से बड़ी सोर्स फ़ाइल इस कैटगरी में आती है), इसलिए अपने डेटा को आसान बनाने के बारे में सोचें अपलोड करने से पहले, ताकि विज़ुअल मैप में सबसे अच्छी परफ़ॉर्मेंस मिल सके.
यहां अपना डेटा तैयार करने के कुछ सबसे सही तरीके बताए गए हैं:
- सुविधा की प्रॉपर्टी को छोटा करना. स्टाइल के लिए ज़रूरी सुविधा प्रॉपर्टी ही रखें आपका मैप, उदाहरण के लिए "id" और "कैटगरी" चुनें. क्लाइंट की एक सुविधा में दूसरी प्रॉपर्टी भी जोड़ी जा सकती हैं किसी यूनीक आइडेंटिफ़ायर कुंजी पर डेटा-ड्रिवन स्टाइल का इस्तेमाल करने वाला ऐप्लिकेशन. उदाहरण के लिए, देखें डेटा-ड्रिवन स्टाइल की मदद से, रीयल टाइम में अपना डेटा देखना.
- जहां संभव हो, प्रॉपर्टी ऑब्जेक्ट के लिए आसान डेटा टाइप इस्तेमाल करें, जैसे कि पूर्णांक, टाइल के साइज़ को कम करने और मैप की परफ़ॉर्मेंस को बेहतर बनाने के लिए.
- फ़ाइल अपलोड करने से पहले जटिल ज्यामितियां आसान बनाएं. इसकी मदद से, अपनी पसंद का जियोस्पेशियल टूल, जैसे कि ओपन सोर्स Mapshaper.org सुविधा या BigQuery में ST_Simplify जटिल पॉलीगॉन ज्यामितियों पर.
- फ़ाइल अपलोड करने से पहले बहुत सघन बिंदु. इसकी मदद से, अपनी पसंद का जियोस्पेशियल टूल, जैसे कि ओपन सोर्स turf.js क्लस्टर फ़ंक्शन या BigQuery में ST_CLUSTERDBSCAN का इस्तेमाल करके सघन बिंदु ज्यामितियों पर.
डेटासेट इस्तेमाल करने के सबसे सही तरीकों के बारे में ज़्यादा जानकारी के लिए, यहां जाएं: डेटासेट और BigQuery की मदद से अपने डेटा को विज़ुअलाइज़ करें.
GeoJSON से जुड़ी ज़रूरी शर्तें
Android के लिए Maps SDK, मौजूदा GeoJSON खास जानकारी. Android के लिए Maps SDK टूल, GeoJSON फ़ाइलों के साथ काम करता है जिनमें इनमें से कोई भी ऑब्जेक्ट टाइप शामिल होता है:
- ज्यामिति ऑब्जेक्ट. ज्यामिति ऑब्जेक्ट एक स्पेशल आकार होता है, जिसे यूनियन के तौर पर दिखाया जाता है वैकल्पिक छेद वाले पॉइंट, लाइनें, और पॉलीगॉन चुनें.
- फ़ीचर ऑब्जेक्ट. सुविधा ऑब्जेक्ट में एक ज्यामिति और अतिरिक्त शामिल है नाम/वैल्यू पेयर, जिनका मतलब ऐप्लिकेशन के हिसाब से अलग-अलग होता है.
- कलेक्शन दिखाएं. सुविधा संग्रह, फ़ीचर ऑब्जेक्ट का एक सेट होता है.
Android के लिए Maps SDK टूल, GeoJSON फ़ाइलों के साथ काम नहीं करता जिनमें कोऑर्डिनेट रेफ़रंस सिस्टम में डेटा होता है WGS84 के अलावा कोई और (CRS).
GeoJSON के बारे में ज़्यादा जानकारी के लिए, यहां देखें आरएफ़सी 7946 का पालन करना.
KML की ज़रूरी शर्तें
Android के लिए Maps SDK टूल की ये ज़रूरी शर्तें हैं:
- सभी यूआरएल, फ़ाइल से जुड़े हुए (या मिलते-जुलते) होने चाहिए.
- पॉइंट, लाइन, और पॉलीगॉन की ज्यामितियां इस्तेमाल की जा सकती हैं.
- डेटा के सभी एट्रिब्यूट को स्ट्रिंग माना जाता है.
- फ़ाइल के बाहर तय किए गए आइकॉन या
<styleUrl>. - नेटवर्क लिंक, जैसे कि
<NetworkLink> - ग्राउंड ओवरले, जैसे कि
<GroundOverlay> - 3D ज्यामितियां या ऊंचाई से संबंधित कोई भी टैग, जैसे कि
<altitudeMode> - कैमरे की खास जानकारी, जैसे कि
<LookAt> - KML फ़ाइल में तय की गई शैलियां.
CSV की ज़रूरी शर्तें
CSV फ़ाइलों के लिए, प्राथमिकता के हिसाब से इस्तेमाल किए जा सकने वाले कॉलम के नाम नीचे दिए गए हैं:
latitude,longitudelat,longx,ywkt(जाने-पहचाने टेक्स्ट)address,city,state,zipaddress- पते की सारी जानकारी वाला एक कॉलम, जैसे कि
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,longitudelat,longx,ywktaddress,city,state,zipaddress- पते की सारी जानकारी वाला एक कॉलम, जैसे कि
1600 Amphitheatre Parkway Mountain View, CA 94043
- अगर
xऔरyआपके ज्यामिति कॉलम हैं, तो पक्का करें कि इकाइयां देशांतर और अक्षांश. कुछ सार्वजनिक डेटासेट, हेडर के नीचे अलग-अलग निर्देशांक सिस्टम का इस्तेमाल करते हैंxऔरy. गलत इकाइयों का इस्तेमाल करने पर, डेटासेट इंपोर्ट हो सकता है लेकिन रेंडर किया गया डेटा, ऐसी जगहों पर डेटासेट पॉइंट दिखा सकता है जहां इसकी उम्मीद नहीं थी.
डेटासेट बनाना
डेटासेट बनाने के लिए:
- Google Cloud Console में, डेटासेट पेज पर जाएं.
- डेटासेट बनाएं पर क्लिक करें.
- डेटासेट का नाम डालें. यह नाम सभी डेटासेट के बीच खास होना चाहिए.
- डेटासेट के लिए जानकारी डालें. हालांकि, ऐसा करना ज़रूरी नहीं है.
- जारी रखें पर क्लिक करें. इसके बाद, डेटा इंपोर्ट करें पेज दिखेगा.
- डेटासेट को अपने-आप भरने के लिए इस्तेमाल किए जाने वाले डेटा का अपलोड सोर्स चुनें
डेस्कटॉप, जिसका मतलब है आपके सिस्टम पर मौजूद कोई लोकल फ़ाइल या
Google Cloud Storage बकेट.
- डेस्कटॉप पर जाने के लिए, ब्राउज़ करें पर क्लिक करें. इसके बाद, यहां से फ़ाइल चुनें: फ़ाइल चुनने वाला टूल.
- Google Cloud Storage बकेट के लिए, ब्राउज़ करें पर क्लिक करें और चुनें बकेट और फ़ाइल में डेटा शामिल करें.
- फ़ाइल फ़ॉर्मैट चुनें.
- अपनी सेटिंग देखने के लिए जारी रखें पर क्लिक करें.
बनाएं पर क्लिक करें. डेटासेट पेज दिखाई देता है, जो आपके नए डेटासेट को दिखा रहा है डेटासेट. स्टेटस, प्रोसेस जारी है होनी चाहिए.
अगर डेटा अपलोड हो जाता है, तो:
- डेटासेट की स्थिति COMPLETED पर सेट है.
- डेटासेट "चालू" हो जाता है वर्शन है और यही वह वर्शन है जिसका इस्तेमाल आपके ऐप्लिकेशन में किया जाता है.
अगर अपलोड में कोई गड़बड़ी है, तो:
- नए डेटासेट वर्शन की स्थिति को पूरा हुआ.
डेटासेट देखना या उसमें बदलाव करना
डेटासेट बनाने के बाद, उसे देखा जा सकता है या उसमें बदलाव किया जा सकता है:
- Google Cloud Console में, डेटासेट पेज पर जाएं.
- डेटासेट के नाम पर क्लिक करें. डेटासेट की जानकारी वाला पेज दिखेगा.
- डेटासेट के बारे में जानकारी देखने के लिए, ब्यौरा टैब पर क्लिक करें. इस टैब पर डेटासेट के नाम और जानकारी में बदलाव भी किया जा सकता है.
- मैप पर अपना डेटासेट देखने के लिए झलक देखें टैब पर क्लिक करें (ऐसे डेटासेट सिर्फ़ पूरा हो गया या पूरी तरह उलट होने की स्थिति.
- डेटासेट (डेटासेट) के सभी एट्रिब्यूट देखने के लिए, टेबल डेटा टैब पर क्लिक करें सिर्फ़ पूरा हुआ या उल्टी की स्थिति के साथ. ये हैं एट्रिब्यूट का इस्तेमाल करें, जिनका इस्तेमाल मैप पर डेटासेट की स्टाइल तय करने के लिए किया जा सकता है.
- डेटा को किसी लोकल फ़ाइल में डाउनलोड करने के लिए, डाउनलोड करें बटन पर क्लिक करें.
- डेटासेट मिटाने के लिए, मिटाएं बटन पर क्लिक करें.
डेटासेट में नया डेटा अपलोड करने के लिए, डेटा फ़ाइल इंपोर्ट करें बटन पर क्लिक करें.
डेटासेट में नया डेटा अपलोड करने से, डेटासेट का एक नया वर्शन बन जाता है. अगर नया डेटा अपलोड हो गया:
- डेटासेट के नए वर्शन की स्थिति COMPLETED पर सेट है.
- नया वर्शन "चालू" हो जाता है वर्शन है और यही वह वर्शन है जिसका इस्तेमाल आपके ऐप्लिकेशन में किया जाता है.
अगर अपलोड में कोई गड़बड़ी है, तो:
- नए डेटासेट वर्शन की स्थिति को पूरा हुआ. उदाहरण के लिए, अगर कोई पिछला "ऐक्टिव" है वर्शन है, तो डेटासेट की स्थिति वापस नहीं पर सेट की गई है.
- पिछली बार "चालू है" डेटासेट वर्शन "चालू है" ही रहता है वर्शन है और आपके ऐप्लिकेशन में इस्तेमाल किया गया वर्शन हो.