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

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

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

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

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

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

सुविधाएं

भौगोलिक JSON लेयर वाला मैप

अपने मैप में GeoJSON को इंपोर्ट करें

सुविधाओं को भौगोलिक JSON फ़ॉर्मैट में सेव किया जा सकता है. साथ ही, इसे मैप के ऊपर किसी लेयर के तौर पर रेंडर करने के लिए, इस सुविधा का इस्तेमाल किया जा सकता है. मैप में अपना GeoJSON डेटा जोड़ने के लिए, addLayer() पर कॉल करें. आप GeoJsonFeature ऑब्जेक्ट में addFeature() को कॉल करके, अलग-अलग सुविधाएं भी जोड़ सकते हैं.

ज़्यादा जानकारी के लिए, Google Maps के Android GeoJSON Utility पर दस्तावेज़ देखें.

KML परत वाला मैप

अपने मैप पर KML इंपोर्ट करें

इस उपयोगिता का इस्तेमाल करके, आप KML ऑब्जेक्ट को भौगोलिक आकार में बदल सकते हैं और उन्हें मैप के ऊपर एक परत के रूप में रेंडर कर सकते हैं. मैप पर अपनी लेयर जोड़ने के लिए, addLayerToMap() को कॉल करें. आप किसी भी प्लेसमार्क, ग्राउंड ओवरले, दस्तावेज़ या फ़ोल्डर पर मौजूद getProperties() को कॉल करके, KML ऑब्जेक्ट में प्रॉपर्टी ऐक्सेस कर सकते हैं.

जानकारी के लिए, Google Maps Android KML Utility पर दस्तावेज़ देखें.

हीटमैप वाला मैप

अपने मैप में हीटमैप जोड़ें

हीटमैप की मदद से, दर्शक मैप पर मौजूद डेटा पॉइंट के डिस्ट्रिब्यूशन और उनकी तुलना करने की प्रोसेस को आसानी से समझ सकते हैं. हर जगह पर मार्कर रखने के बजाय, हीटमैप डेटा के वितरण को दिखाने के लिए रंग और आकार का इस्तेमाल करता है. एक HeatmapTileProvider बनाएं, जो इसे मैप पर मौजूद लोकप्रिय चीज़ों को दिखाने वाले LatLng ऑब्जेक्ट का कलेक्शन पास करे. इसके बाद, नया TileOverlay बनाएं, उसे हीटमैप टाइल की सेवा देने वाली कंपनी को पास करें. साथ ही, मैप पर टाइल ओवरले जोड़ें.

ज़्यादा जानकारी के लिए, Google Maps Android हीटमैप यूटिलिटी के दस्तावेज़ देखें.

बबल आइकॉन वाला मैप

बबल आइकॉन की मदद से मार्कर को पसंद के मुताबिक बनाना

अपने मार्कर पर जानकारी के स्निपेट दिखाने के लिए IconGenerator जोड़ें. यह सुविधा आपके मार्कर आइकॉन को जानकारी विंडो की तरह दिखने का एक तरीका देती है. इसमें मार्कर में टेक्स्ट और दूसरी सामग्री हो सकती है. इसका फ़ायदा यह है कि आप एक बार में एक से ज़्यादा मार्कर को खुला रख सकते हैं, जबकि एक बार में सिर्फ़ एक जानकारी विंडो खोली जा सकती है. आप मार्करों की स्टाइल भी बदल सकते हैं, मार्कर और/या कॉन्टेंट का ओरिएंटेशन बदल सकते हैं, और मार्कर' की बैकग्राउंड इमेज/9-पैच को बदल सकते हैं.

क्लस्टर किए गए मार्कर वाला मैप

मार्कर क्लस्टर मैनेज करें

ClusterManager से, आपको अलग-अलग ज़ूम लेवल पर, एक से ज़्यादा मार्कर मैनेज करने में मदद मिलती है. इसका मतलब है कि आप मैप पर पढ़ना मुश्किल बनाए बिना, मैप पर बड़ी संख्या में मार्कर रख सकते हैं. जब कोई उपयोगकर्ता मैप को ज़्यादा ज़ूम लेवल पर देखता है, तो अलग-अलग मार्कर मैप पर दिखते हैं. जब उपयोगकर्ता, निचले लेवल के ज़ूम को ज़ूम आउट करता है, तो मार्कर को क्लस्टर में इकट्ठा किया जाता है, ताकि मैप को आसानी से देखा जा सके.

ज़्यादा जानकारी के लिए, Google Maps के Android मार्कर क्लस्टर की सुविधा से जुड़े दस्तावेज़ देखें.

कई लेयर वाला मैप

एक ही मैप में कई परतें जोड़ें

आप भौगोलिक JSON, KML, और क्लस्टर की मदद से अपने मैप, पॉलीलाइन, और पॉलीगॉन की सुविधाएं एक ही मैप पर दिखा सकते हैं. हर लेयर के लिए, क्लिक लिसनर जोड़कर इन लेयर को इंटरैक्टिव भी बनाया जा सकता है. MarkerManager, GroundOverlayManager, PolygonManager, और PolylineManager क्लास को इंस्टैंशिएट करें. इसके बाद, GeoJsonLayer, KmlLayer, और ClusterManager को कंस्ट्रक्टर में पास करें. इसके बाद, मैप पर अपने मार्कर, पॉलीलाइन, और पॉलीगॉन जोड़ने के लिए, ऊपर दी गई Manager क्लास का सीधे इस्तेमाल किया जा सकता है.

ज़्यादा जानकारी के लिए, Google Maps पर Android के 'एक से ज़्यादा लेयर' वाले डेमो का दस्तावेज़ देखें.

कोड में बदली गई पॉलीलाइन वाला मैप

पॉलीलाइन को कोड में बदलें और उसे डिकोड करें

PolyUtil, कोड में बदली गई पॉलीलाइन और पॉलीगॉन को अक्षांश/देशांतर निर्देशांकों में बदलने के लिए उपयोगी है. इसी तरह, पॉलीगॉन को अक्षांश/देशांतर निर्देशांकों में बदलने में भी मदद मिलती है.

Google Maps में, पॉलीलाइन या पॉलीगॉन के बारे में बताने वाले अक्षांश और देशांतर के निर्देशांक, कोड में बदली गई स्ट्रिंग के तौर पर सेव किए जाते हैं. पॉलीलाइन एन्कोडिंग के बारे में ज़्यादा जानकारी देखें. आपको कोड में बदली गई यह स्ट्रिंग, Google API के रिस्पॉन्स के तौर पर मिल सकती है. जैसे, निर्देश एपीआई.

अक्षांश/देशांतर निर्देशांकों ('LatLngs') के क्रम को कोड में बदलने के लिए और Android कोड के लाटएलजी के क्रम में कोड में बदली गई स्ट्रिंग को डिकोड करने के लिए, आप Android Utility लाइब्रेरी के Maps SDK टूल में PolyUtil का इस्तेमाल कर सकते हैं. इससे यह पक्का होगा कि Google Maps API वेब सेवाओं के साथ इंटरऑपरेबिलिटी (दूसरे सिस्टम के साथ काम करना) की सुविधा दी गई है.

मैप पर दो बिंदुओं के बीच की गणना

गोल आकार वाली ज्यामिति की मदद से दूरी, इलाके, और शीर्षकों का हिसाब लगाना

SphericalUtil में गोलाकार ज्यामिति सेवाओं का इस्तेमाल करके, आप अक्षांश और देशांतर के हिसाब से दूरी, इलाके, और शीर्षक का हिसाब लगा सकते हैं. उपयोगिता में उपलब्ध कुछ तरीके यहां दिए गए हैं:

  • computeDistanceBetween() – दो अक्षांश/देशांतर निर्देशांकों के बीच, दूरी की जानकारी देता है.
  • computeHeading() – दो अक्षांश/देशांतर निर्देशांकों के बीच, डिग्री में बियरिंग दिखाता है.
  • computeArea() – Earth पर बंद पाथ का इलाका, वर्ग मीटर में दिखाता है.
  • interpolate() – किसी पॉइंट के अक्षांश/देशांतर के निर्देशांक को दिखाता है. यह वैल्यू, दिए गए दो बिंदुओं के बीच की दूरी के अंश के बराबर होती है. इसका इस्तेमाल, दो बिंदुओं के बीच मार्कर को ऐनिमेट करने के लिए किया जा सकता है, उदाहरण के लिए.

यूटिलिटी में दिए गए तरीकों की पूरी सूची देखने के लिए, रेफ़रंस दस्तावेज़ देखें.