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

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

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

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

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

'Android यूटिलिटी लाइब्रेरी' के लिए, Maps SDK टूल इंस्टॉल करने के लिए, सेटअप गाइड में दिए गए निर्देशों का पालन करें.

उपयोगिताएं

	अपने मैप पर GeoJSON इंपोर्ट करें सुविधाओं को GeoJSON फ़ॉर्मैट में सेव किया जा सकता है और इस उपयोगिता का इस्तेमाल करके, उन्हें मैप पर एक लेयर के तौर पर दिखाया जा सकता है. मैप में अपना GeoJSON डेटा जोड़ने के लिए, addLayer() को कॉल करें. आपके पास addFeature() को कॉल करके, अलग-अलग सुविधाएं जोड़ने का भी विकल्प होता है. यह विकल्प GeoJsonFeature ऑब्जेक्ट में पास होता है. ज़्यादा जानकारी के लिए, Google Maps Android GeoJSON Utility पर मौजूद दस्तावेज़ देखें.
	KML को अपने मैप पर इंपोर्ट करना इस सुविधा का इस्तेमाल करके, KML ऑब्जेक्ट को भौगोलिक आकार में बदला जा सकता है और उन्हें मैप पर एक लेयर के तौर पर रेंडर किया जा सकता है. मैप पर अपनी लेयर जोड़ने के लिए, addLayerToMap() को कॉल करें. किसी भी प्लेसमार्क, ग्राउंडओवरले, दस्तावेज़ या फ़ोल्डर पर getProperties() को कॉल करके, KML ऑब्जेक्ट में प्रॉपर्टी ऐक्सेस की जा सकती हैं. ज़्यादा जानकारी के लिए, Google Maps के Android KML Utility पर दिए गए दस्तावेज़ देखें.
	अपने मैप में हीटमैप जोड़ें हीटमैप से, दर्शकों को मैप पर दिए गए डेटा पॉइंट के डिस्ट्रिब्यूशन और उसकी तीव्रता को समझने में आसानी होती है. हर जगह पर मार्कर लगाने के बजाय, हीटमैप में डेटा का डिस्ट्रिब्यूशन दिखाने के लिए, रंग और आकार का इस्तेमाल किया जाता है. एक 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 API से रिस्पॉन्स के तौर पर मिल सकती है, जैसे कि निर्देश एपीआई. Android Utility लाइब्रेरी के लिए Maps SDK टूल में, PolyUtil का इस्तेमाल करके, अक्षांश/देशांतर निर्देशांक ('LatLngs') के क्रम को कोड में बदलकर, पाथ स्ट्रिंग को कोड में बदला जा सकता है. साथ ही, कोड में बदले गए पाथ स्ट्रिंग को LatLngs के एक क्रम में बदला जा सकता है. इससे यह पक्का होगा कि Google Maps API वेब सेवाओं के साथ इंटरऑपरेबिलिटी (दूसरे सिस्टम के साथ काम करना) किया जा सकेगा.
	गोलीय ज्यामिति की मदद से दूरी, क्षेत्रफल, और शीर्षक निकालना SphericalUtil में गोलाकार ज्यामिति टूल का इस्तेमाल करके, अक्षांश और देशांतर के आधार पर दूरी, क्षेत्रफल, और शीर्षक का पता लगाया जा सकता है. यूटिलिटी में उपलब्ध कुछ तरीके यहां दिए गए हैं: computeDistanceBetween() – दो अक्षांश/देशांतर निर्देशांकों के बीच की दूरी, मीटर में दिखाता है. computeHeading() – दो अक्षांश/देशांतर निर्देशांकों के बीच डिग्री में बियरिंग देता है. computeArea() – पृथ्वी के किसी बंद पाथ का क्षेत्रफल, वर्ग मीटर में दिखाता है. interpolate() – उस बिंदु के अक्षांश/देशांतर निर्देशांक दिखाता है जो दो दिए गए पॉइंट के बीच की दूरी का दिया गया अंश होता है. उदाहरण के लिए, इसका इस्तेमाल दो पॉइंट के बीच मार्कर को ऐनिमेट करने के लिए किया जा सकता है. यूटिलिटी में इस्तेमाल करने के तरीकों की पूरी सूची के लिए, रेफ़रंस दस्तावेज़ देखें.
	देखें कि Street View में कोई जगह काम करती है या नहीं. StreetViewUtil क्लास, यह पता लगाने की सुविधा देती है कि कोई जगह Street View में काम करती है या नहीं. किसी Android ऐप्लिकेशन में Street View पैनोरामा जोड़ते समय होने वाली गड़बड़ियों से बचा जा सकता है. इसके लिए, इस मेटाडेटा यूटिलिटी को कॉल करें और रिस्पॉन्स OK मिलने पर ही Street View पैनोरामा जोड़ें. ज़्यादा जानकारी के लिए, GitHub पर Street View मेटाडेटा यूटिलिटी पर दिया गया दस्तावेज़ देखें.