Android Utility लाइब्रेरी के लिए Maps SDK टूल

प्लैटफ़ॉर्म चुनें: Android iOS

क्या आपको अपने मैप में बेहतर सुविधाएं जोड़नी हैं? Android Utility लाइब्रेरी के लिए Maps SDK टूल, क्लास की एक ओपन-सोर्स लाइब्रेरी है. यह कई ऐप्लिकेशन के लिए काम की है. GitHub रिपॉज़िटरी में, काम की क्लास और एक डेमो ऐप्लिकेशन शामिल है. इससे हर क्लास के इस्तेमाल के बारे में पता चलता है.

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

त्‍वरित सेटअप

Android Utility लाइब्रेरी के लिए Maps SDK टूल इंस्टॉल करने के लिए, सेटअप गाइड पढ़ें.

काम की चीज़ें

	अपने मैप पर GeoJSON इंपोर्ट करना सुविधाओं को GeoJSON फ़ॉर्मैट में सेव किया जा सकता है. साथ ही, इस सुविधा का इस्तेमाल करके उन्हें मैप के ऊपर लेयर के तौर पर रेंडर किया जा सकता है. मैप में अपना GeoJSON डेटा जोड़ने के लिए, addLayer() को कॉल करें. addFeature() को कॉल करके, GeoJsonFeature ऑब्जेक्ट को पास करके भी अलग-अलग सुविधाएं जोड़ी जा सकती हैं. ज़्यादा जानकारी के लिए, Google Maps के Android GeoJSON टूल का दस्तावेज़ देखें.
	अपने मैप पर KML फ़ाइल इंपोर्ट करना इस सुविधा का इस्तेमाल करके, KML ऑब्जेक्ट को भौगोलिक आकार में बदला जा सकता है. साथ ही, उन्हें मैप के ऊपर लेयर के तौर पर रेंडर किया जा सकता है. मैप में अपनी लेयर जोड़ने के लिए, addLayerToMap() को कॉल करें. किसी भी प्लेसमार्क, ग्राउंडओवरले, दस्तावेज़ या फ़ोल्डर पर getProperties() को कॉल करके, KML ऑब्जेक्ट में प्रॉपर्टी ऐक्सेस की जा सकती हैं. ज़्यादा जानकारी के लिए, Google Maps के लिए Android KML यूटिलिटी के दस्तावेज़ देखें.
	अपने मैप में हीटमैप जोड़ना हीटमैप की मदद से, दर्शक मैप पर डेटा पॉइंट के डिस्ट्रिब्यूशन और उनके बीच के अंतर को आसानी से समझ सकते हैं. हीटमैप में हर जगह पर मार्कर लगाने के बजाय, डेटा के डिस्ट्रिब्यूशन को दिखाने के लिए रंग और आकार का इस्तेमाल किया जाता है. HeatmapTileProvider बनाएं और उसमें मैप पर दिलचस्प जगहों को दिखाने वाले LatLng ऑब्जेक्ट का कलेक्शन पास करें. इसके बाद, एक नया TileOverlay बनाएं और उसे हीटमैप टाइल प्रोवाइडर के तौर पर इस्तेमाल करें. साथ ही, मैप में टाइल ओवरले जोड़ें. ज़्यादा जानकारी के लिए, Google Maps के Android हीटमैप की सुविधा से जुड़ा दस्तावेज़ देखें.
	बबल आइकॉन की मदद से मार्कर को पसंद के मुताबिक बनाना अपने मार्कर पर जानकारी के स्निपेट दिखाने के लिए, IconGenerator जोड़ें. इस सुविधा की मदद से, मार्कर आइकॉन को जानकारी वाली विंडो की तरह दिखाया जा सकता है. इसमें मार्कर में टेक्स्ट और अन्य कॉन्टेंट शामिल किया जा सकता है. इसका फ़ायदा यह है कि एक ही समय में एक से ज़्यादा मार्कर रखे जा सकते हैं, जबकि जानकारी वाली विंडो एक बार में सिर्फ़ एक ही खोली जा सकती है. मार्कर की स्टाइल भी बदली जा सकती है. साथ ही, मार्कर और/या कॉन्टेंट का ओरिएंटेशन भी बदला जा सकता है. इसके अलावा, मार्कर की बैकग्राउंड इमेज/नाइन-पैच भी बदला जा सकता है.
	मार्कर क्लस्टर मैनेज करना ClusterManager की मदद से, अलग-अलग ज़ूम लेवल पर कई मार्कर मैनेज किए जा सकते हैं. इसका मतलब है कि मैप पर बड़ी संख्या में मार्कर डाले जा सकते हैं, ताकि मैप को पढ़ने में मुश्किल न हो. जब कोई उपयोगकर्ता मैप को ज़ूम करके देखता है, तो मैप पर अलग-अलग मार्कर दिखते हैं. जब उपयोगकर्ता कम ज़ूम लेवल पर ज़ूम आउट करता है, तो मैप को आसानी से देखने के लिए मार्कर एक साथ क्लस्टर में इकट्ठा हो जाते हैं. ज़्यादा जानकारी के लिए, Google Maps के Android मार्कर क्लस्टरिंग टूल से जुड़ा दस्तावेज़ देखें.
	एक ही मैप में कई लेयर जोड़ना एक ही मैप पर, GeoJSON, KML, और क्लस्टर के साथ-साथ अपने मार्कर, पॉलीलाइन, और पॉलीगॉन की सुविधाएं दिखाई जा सकती हैं. हर लेयर में क्लिक करने पर होने वाली कार्रवाई तय करके, इन लेयर को इंटरैक्टिव भी बनाया जा सकता है. MarkerManager, GroundOverlayManager, PolygonManager, और PolylineManager क्लास को सेट अप करते समय, उन्हें इंस्टैंशिएट करें और GeoJsonLayer, KmlLayer, ClusterManager के कन्स्ट्रक्टर में पास करें. इसके बाद, मैप में अपने मार्कर, पॉलीलाइन, और पॉलीगॉन जोड़ने के लिए, ऊपर बताई गई Manager क्लास का सीधे तौर पर इस्तेमाल किया जा सकता है. ज़्यादा जानकारी के लिए, Google Maps के Android मल्टी लेयर डेमो पर मौजूद दस्तावेज़ देखें.
	पॉलीलाइन को कोड में बदलना और कोड से बदलना PolyUtil, कोड में बदली गई पॉलीलाइन और पॉलीगॉन को अक्षांश/देशांतर के निर्देशांक में बदलने के लिए काम आता है. इसके अलावा, अक्षांश/देशांतर के निर्देशांक को पॉलीलाइन और पॉलीगॉन में बदलने के लिए भी इसका इस्तेमाल किया जा सकता है. Google Maps में, किसी पॉलीलाइन या पॉलीगॉन की जानकारी देने वाले अक्षांश और देशांतर के निर्देशांक, कोड में बदली गई स्ट्रिंग के तौर पर सेव किए जाते हैं. पॉलीलाइन कोड के बारे में ज़्यादा जानकारी देखें. आपको यह कोड की गई स्ट्रिंग, Google के किसी एपीआई से मिले रिस्पॉन्स में मिल सकती है. जैसे, Directions API (लेगसी). Maps SDK for Android की यूटिलिटी लाइब्रेरी में PolyUtil का इस्तेमाल करके, अक्षांश/देशांतर निर्देशांक ('LatLngs') के क्रम को कोड में बदली गई पाथ स्ट्रिंग में बदला जा सकता है. साथ ही, कोड में बदली गई पाथ स्ट्रिंग को LatLngs के क्रम में बदला जा सकता है. इससे, Google Maps APIs की वेब सेवाओं के साथ इंटरऑपरेबिलिटी की पुष्टि होगी.
	गोलाकार ज्यामिति की मदद से, दूरियों, क्षेत्रों, और हेडिंग का हिसाब लगाना SphericalUtil में गोलाकार ज्यामिति की सुविधाओं का इस्तेमाल करके, अक्षांश और देशांतर के आधार पर, दूरी, क्षेत्रफल, और हेडिंग का हिसाब लगाया जा सकता है. यहां इस सुविधा में उपलब्ध कुछ तरीके दिए गए हैं: computeDistanceBetween() – दो अक्षांश/देशांतर निर्देशांक के बीच की दूरी, मीटर में दिखाता है. computeHeading() – दो अक्षांश/देशांतर निर्देशांकों के बीच के डिग्री में, दिशा की जानकारी देता है. computeArea() – यह फ़ंक्शन, पृथ्वी पर किसी बंद पाथ का क्षेत्रफल, वर्ग मीटर में दिखाता है. interpolate() – यह किसी ऐसे बिंदु के अक्षांश/देशांतर के निर्देशांक दिखाता है जो दो दिए गए बिंदुओं के बीच की दूरी के किसी दिए गए हिस्से पर स्थित है. उदाहरण के लिए, इसका इस्तेमाल दो बिंदुओं के बीच मार्कर को ऐनिमेट करने के लिए किया जा सकता है. यूटिलिटी में मौजूद तरीकों की पूरी सूची देखने के लिए, रेफ़रंस दस्तावेज़ देखें.
	देखें कि किसी जगह के लिए Street View उपलब्ध है या नहीं. StreetViewUtil क्लास, यह जांचने की सुविधा देती है कि किसी जगह के लिए, स्ट्रीट व्यू की सुविधा उपलब्ध है या नहीं. Android ऐप्लिकेशन में स्ट्रीट व्यू पैनोरमा जोड़ते समय, गड़बड़ियों से बचा जा सकता है. इसके लिए, इस मेटाडेटा की सुविधा को कॉल करें और सिर्फ़ OK के जवाब मिलने पर स्ट्रीट व्यू पैनोरमा जोड़ें. ज़्यादा जानकारी के लिए, GitHub पर Street View के मेटाडेटा की सुविधा के दस्तावेज़ देखें.