Google मैप्स से Yandex MapKit पर स्विच करना

हाल ही में मैंने Google मैप्स एपीआई v1 का उपयोग करके यैंडेक्स मैपकिट से एप्लिकेशन को स्थानांतरित करने के लिए हुआ।

रूस के लिए यैंडेक्स के नक्शे के बहुमत के व्यक्तिपरक राय के अनुसार उच्च विवरण है, और इसलिए, यदि आपका आवेदन केवल रूस या पूर्व-यूएसएसआर और तुर्की पर केंद्रित है (सामान्य रूप से, वे देश जहां यांडेक्स है), तो यह मैपकिट का उपयोग करने पर विचार करने के लिए समझ में आता है।

आवेदन में निम्नलिखित कार्यक्षमता है: इस पर वस्तुओं के बिंदुओं के साथ एक नक्शा और पता द्वारा इन बिंदुओं को खोजने की क्षमता, वर्तमान स्थान और ज़ूम प्रदर्शित करता है। प्रत्येक बिंदु के लिए, आप बिंदु के बारे में अतिरिक्त जानकारी वाले पॉप-अप गुब्बारे को टैप और देख सकते हैं। जब एक अलग गुब्बारे पर टैप किया जाता है, तो इस बिंदु के बारे में विस्तृत जानकारी और नक्शे का एक टुकड़ा के साथ एक नई गतिविधि खुलती है जो केवल इस एकल बिंदु को प्रदर्शित करती है।


चलो शुरू करते हैं ... हम गितुब जाते हैं और वहां से पुस्तकालय उठाते हैं। अगर आपने सोचा कि चूंकि लाइब्रेरी को GitHub के माध्यम से वितरित किया जाता है, तो यह OpenSource है, फिर यहां आपको निराशा मिलेगी। लाइब्रेरी को एक Android Library Project + jar- रूप में वितरित किया जाता Android Library Project + jar- , जिसमें ओफ़्फ़ुसेटेड कक्षाओं का एक गुच्छा होता है, जो कि libs । कोई स्रोत नहीं हैं, इसलिए, अंदर देखने और समझने के लिए कि हम काम नहीं कर सकते हैं, और कभी-कभी मैं वास्तव में चाहता हूं, क्योंकि प्रलेखन (पुस्तकालय फ़ोल्डर में javadoc है), इसे हल्के ढंग से खराब करने के लिए है: मौजूदा एपीआई का विवरण न्यूनतम है, और कई तरीकों का दस्तावेजीकरण नहीं किया गया है। इसलिए, नमूना लाइब्रेरी के बगल में स्थित परियोजना बहुत उपयोगी है।

वैसे, गीथब पर खुले कार्यों की प्रचुरता से चिंतित न हों। ये जरूरी कीड़े नहीं हैं - यह इस तरह से पुस्तकालय का उपयोग करने के बारे में समुदाय से पूछने के लिए है। ऐसे सवालों के लिए कोई मंच या अलग जगह नहीं है। एक सवाल है? मुद्दा बनाएँ!

कुंजी प्राप्त करने के लिए, आपको उन लोगों को एक अनुरोध भेजना होगा। यैंडेक्स समर्थन, और जब तक यह हमें जारी नहीं किया गया था, तब तक आप 1234567890 प्रकार की एक कुंजी को debug कुंजी के रूप में उपयोग कर सकते हैं (नमूना परियोजना के लिए धन्यवाद, प्रलेखन में इस बारे में एक शब्द नहीं)। चाबियों की MapView करें, तो पहला आश्चर्य हमें यहां है: MapView संसाधन फ़ाइल से कुंजी को नहीं पढ़ता है, इसलिए यदि आपके पास MapView अंदर कई लेआउट हैं, तो आपको प्रत्येक MapView की कुंजी को कॉपी करना होगा, इसे कॉन्फ़िगरेशन फ़ाइल में डालना होगा और इसके माध्यम से एक्सेस करना होगा। @string/api_key विफल हो जाएगी। इस पहेली ने मुझे बहुत समय लिया, इसी कार्य को बहुत समय पहले बनाया गया था, लेकिन जैसा कि आप देख सकते हैं, 3 महीने में स्थिति नहीं बदली है। सामान्य तौर पर, यैंडेक्स समर्थन की प्रतिक्रिया की गति डरावनी है।

इसलिए, किसी भी चीज को प्राप्त करने के बाद, पहली बात यह थी कि नमूना-परियोजना एकत्र करना और उसके साथ खेलना था। रिपॉजिटरी में प्रोजेक्ट की एक्लिप्स फाइलें हैं, मैं IntelliJ IDEA का उपयोग करता हूं, इसलिए पहली बात यह थी कि मौजूदा स्रोतों से प्रोजेक्ट बनाना और कॉन्फ़िगर करना। यहां एक आश्चर्य था - अब तक मुझे यह समझ में नहीं आया कि मामला क्या था, लेकिन स्थिति इस प्रकार थी: परियोजना को सामान्य रूप से संकलित और एपीके में पैक किया गया था, लेकिन तब रनटाइम में, जब किसी भी गतिविधि पर स्विच करने का प्रयास किया गया, तो यह एक string resource not found साथ क्रैश हो गया, जिसमें त्रुटि string resource not found ( मुझे अब त्रुटि का शाब्दिक पाठ याद नहीं है)। लाइब्रेरी फ़ाइलों में एक खाली R फ़ाइल स्टब होता है, मैं सुझाव देता हूं कि समस्या यह थी कि किसी कारण से IDEA इसे अंतिम apk फ़ाइल में पैक कर रही थी, जिसके कारण आगे त्रुटियां apk । नमूना-प्रोजेक्ट निर्भरता से लाइब्रेरी मॉड्यूल को हटाकर और इसे फिर से जोड़कर समस्या हल की गई थी।

ऐसा लगता है कि दोनों पुस्तकालयों में एक समान एपीआई है और संक्रमण को बहुत अधिक समय नहीं लेना चाहिए: दोनों MapController और MapController दोनों वहाँ और GeoPoint ... लेकिन समानताएं वहाँ समाप्त होती हैं। समान श्रेणी के नामों के बावजूद, तरीकों को अलग-अलग नाम दिया गया है और Google API से हर विधि के लिए नहीं है, इसका सीधा सादृश्य MapKit से है। उदाहरण के लिए, MapKit में कोई विधि नहीं है जो आपको ViewPort (मानचित्र के दृश्य क्षेत्र) के निर्देशांक प्राप्त करने की अनुमति देती है, इसलिए आपको इसे स्वयं लागू करना होगा - स्क्रीन ( ScreenPoint ) निर्देशांक को वैश्विक ( GeoPoint ) - हजार में परिवर्तित करके। स्क्रीन निर्देशांक को स्क्रीन के सापेक्ष नहीं, बल्कि MapView सापेक्ष गिना जाना चाहिए।

Google मैप्स में एक बैलून (एक बिंदु पर टैप के साथ फ्लोटिंग व्यू) एक तत्व के साथ ही पॉइंट, मैपकिट में यह एक अलग ऑब्जेक्ट है। इसलिए, गुब्बारे के काम करने के तर्क को लगभग पूरी तरह से फिर से लिखना होगा।

Google API में, GeoPoint स्टोर्स एक जोड़े की तरह के रूप में समन्वयित करता है - यह longitude / latutude * 1E6 , longitude / latutude * 1E6 के लिए यह double देशांतर और अक्षांश है। एक ओर, double बजाय int उपयोग से आप मेमोरी के बाइट्स के एक जोड़े को बचा सकते हैं और निर्देशांक से जुड़े गणना को गति दे सकते हैं (पूर्णांक संचालन हमेशा फ्लोटिंग-पॉइंट ऑपरेशंस की तुलना में तेज होता है)। दूसरी ओर, यह फॉर्म के निर्माणों के साथ कोड को बाढ़ देता है: *1E6 , /1E6 । सामान्य तौर पर, यहां मैंने 1E6 निरंतर गुणन / विभाजन के बिना 1E6 लिए एक प्लस लगाया, यह एपीआई के साथ काम करने के लिए अधिक सुविधाजनक है, और प्रदर्शन लाभ की सुविधा का अनुपात, मेरी राय में, इस स्थिति में महान नहीं है।

एक अन्य चुनौती थी Balloon का अप्रत्याशित व्यवहार । तथ्य यह है कि समय-समय पर खोले गए गुब्बारे अन्य OverlayItem तहत प्रदर्शित किए जाते हैं और अवरुद्ध होते हैं। इसी समय, setPriority विधि, जो सभी तत्वों को नक्शे पर प्रदर्शित करती है, कोई प्रभाव नहीं पड़ता है। जैसा कि यह बाद में पता चला, compareTo विधि को सही ढंग से ओवरराइड नहीं करने का कारण। जेड-प्लेन में वस्तुओं को सॉर्ट करने के लिए गुब्बारा दिखाते समय इस विधि का उपयोग किया जाता है। इस समस्या के बारे में न तो दस्तावेज़ीकरण और न ही उदाहरण में कोई जानकारी है; यह निर्भरता आम तौर पर प्रयोगों के दौरान दुर्घटना द्वारा स्थापित की गई थी।

और अंत में, Yandex MapKit और Google Maps के बीच एक और महत्वपूर्ण अंतर यह है कि MapKit प्रत्यक्ष जियोकोडिंग का समर्थन नहीं करता है, केवल विपरीत। यानी पुस्तकालय भौगोलिक निर्देशांक (lat / long) को एक पते या स्थान के नाम ( GeoCode क्लास देखें) में अनुवाद करने का एक तरीका प्रदान करता है। लेकिन विपरीत दिशा में - सड़क या शहर को पता नहीं है कि कैसे समन्वय करना है, इसलिए प्रत्यक्ष जियोकोडिंग को स्वतंत्र रूप से लागू करना होगा, उदाहरण के लिए, उसी यैंडेक्स मैप्स वेब एपीआई का उपयोग करना। Google दोनों दिशाओं में तुरंत ऐसा करने में सक्षम है।

अंत में, मैं यह कहना चाहूंगा कि सामान्य तौर पर, यैंडेक्स मैप्स का उपयोग करने की धारणा सकारात्मक है, एपीआई काफी सुविधाजनक है, मेरे कार्यों की क्षमता पर्याप्त हो गई है, लेकिन मुख्य ऋण प्रलेखन है। आइए आशा करते हैं कि यैंडेक्स अभी भी सब कुछ क्रम में रखेगा।