आरंभ करने से पहले

इस दस्तावेज़ में ज़रूरी शर्तों, सबसे सही तरीकों, और सामान्य गड़बड़ियों के बारे में बताया गया है डेटासेट के साथ काम करते समय.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Maps Datasets API, GeoJSON फ़ाइलों के साथ काम नहीं करता है जिनमें निर्देशांक रेफ़रंस सिस्टम में डेटा मौजूद होता है WGS84 के अलावा कोई और (CRS).

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

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

Maps Datasets 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. गलत इकाइयों का इस्तेमाल करने पर, डेटासेट इंपोर्ट हो सकता है लेकिन रेंडर किया गया डेटा, ऐसी जगहों पर डेटासेट पॉइंट दिखा सकता है जहां इसकी उम्मीद नहीं थी.