💹 🗨️ ⤵️ Yandex.Maps API के साथ मेरा (नैनो) अनुभव या मुझे निर्देश की आवश्यकता क्यों है ⌛️ 🏢 ⛑️

परिचय

मैं एक Android डेवलपर हूं और ...

मैं एक छोटी परियोजना (~ 500h) को पूरा करने के लिए हुआ था, जिसमें शुरुआत में Yandex.Maps API का उपयोग करने का निर्णय लिया गया था, क्योंकि अगर हमारे हैं तो मास्को के लिए Google मानचित्रों का उपयोग क्यों करें। अब मैं आपको बताता हूँ कि यह कैसे हुआ।

मैंने गहरी हुड अनुसंधान का संचालन नहीं किया और मैंने कोई रहस्य नहीं खोला। लेकिन, यदि आप, मेरी तरह, बहुत जल्दी (कल) अपनी परियोजना में कार्ड का उपयोग करना शुरू करते हैं, मुझे आशा है कि मैं थोड़ा समय बचाने में मदद कर सकता हूं।

यदि आप पढ़ने के लिए बहुत आलसी हैं या आपको तुरंत एक निष्कर्ष की आवश्यकता है, तो मैं इसे अंतिम "एक्शन 4" पर भेजता हूं: यह अंत / टीएल; डीआर "है।

क्रिया ०: परिभाषाएँ

आइए परिभाषाओं के साथ शुरू करें: क्या, क्यों, क्यों।

कार्य : मॉस्को का एक नक्शा प्रदर्शित करने के लिए, पिन के साथ विशिष्ट स्थानों को इंगित करने के लिए, वर्तमान स्थिति से एक विशिष्ट बिंदु (या कई तक) का मार्ग बनाने में सक्षम होने के लिए।
प्रौद्योगिकी : Yandex.Maps API। नीचे दिए गए प्रलेखन के संदर्भ [1]।
कुल : प्रलेखन पढ़ें, सुविधाओं को लागू करें।

सब कुछ सरल दिखता है, क्या गलत हो सकता है।

चरण 1: खोज

इससे पहले कि आप दस्तावेज़ का अध्ययन करें, आपको इसे खोजने की आवश्यकता है। खोज यांडेक्स, निश्चित रूप से, हम Google में होंगे - हम [2] या पाएंगे ~~[२]~~ [3]। हम डेवलपर्स हैं, हम बटन "डेवलपर्स के लिए" देखते हैं - क्लिक करें। विशाल "मैप्स एपीआई" आइकन वैसा ही दिखता है जैसा हमें चाहिए! (यह एक जाल है!)

"... / नक्शे" [4] में हम केवल एक अंतहीन खोज, निराशा और पीड़ा की प्रतीक्षा कर रहे हैं। जो मुझे आवश्यक दस्तावेज तक नहीं ले गया।

हम एक कदम पीछे चलते हैं, नीचे स्क्रॉल करते हैं और MapKit [5] पाते हैं - यहाँ हम हैं। यहाँ नेविगेशन बहुत दुखद है, इसलिए यहाँ महत्वपूर्ण लिंक हैं - एंड्रॉइड के नमूने [6] और प्रलेखन [7] (कभी-कभी आप यहां कभी-कभी कुछ उपयोगी पा सकते हैं)।

कार्रवाई 2: चलो चलते हैं

आरंभ करें और आरंभ करें। शुरुआत में, सब कुछ सरल है।

"चरण 3 पर। पुस्तकालय स्थापित करें" सवाल उठते हैं। दृश्य और कारखाने को अलग-अलग शुरू और बंद किया जाना चाहिए, अन्यथा, जैसा कि हमें सूचित किया जाता है, कुछ भी काम नहीं करेगा। क्यों? और अगर कुछ शुरू किया जाता है तो क्या होगा, लेकिन कुछ नहीं है, या कुछ बाद में शुरू हुआ है? और अगर कुछ विचार, तो प्रत्येक के लिए आपको एक कारखाने की आवश्यकता है, या क्या यह एक सिंगलटन है?

शायद यह सिर्फ क्विकस्टार्ट है और फिर हम एक विस्तृत विवरण पाएंगे! (नहीं)

आइए देखें कि प्रलेखन पर क्या है। और वह सब है, और कुछ नहीं। टिप्पणियों के साथ केवल उत्पन्न दस्तावेज हैं:

Class MapKitFactory Methods getInstance() - Gets the MapKit factory instance. initialize(Context context) - Initializes the MapKit factory. setApiKey(String apiKey) - Sets the API key to use for requests.

धन्यवाद यैंडेक्स।

ठीक है, गिथब पर उपयोग के उदाहरणों के साथ एक और परियोजना है [8]। प्रत्येक गतिविधि वर्ग के अंदर, यह टिप्पणी करता है कि यह क्या करता है और इसकी आवश्यकता क्यों है (प्रलेखन के बाद यह सिर्फ भाग्य का उपहार है)। कई परिदृश्य हैं: एक कस्टम मानचित्र परत बनाना, एक कार के लिए एक मार्ग का निर्माण, एक नक्शे पर वस्तुओं के साथ काम करना, और कुछ अन्य।

क्या आपी शक्तिशाली दिखती है? हां।
क्या यह स्पष्ट है कि उदाहरणों की तुलना में थोड़ा अधिक जटिल मामलों में इसका उपयोग कैसे किया जाए? नहीं (
इसे कैसे समझें? ¯_ (¯) _ /, कोड में गोता लगाएँ, शोध के परिणामों के अनुसार, जो कुछ भी मिला है उसके बारे में एक किताब बेचें।

क्रिया 3: विकास करना

कार्य 1: एक नक्शा प्रदर्शित करें
मैं किसी भी कठिनाइयों को पूरा नहीं करता था, सब कुछ गाइड में है।

कार्य 2: प्रदर्शन पिन
हमें "MapObjectsActivity.java" की आवश्यकता है, जिसे हम ढूंढ रहे हैं, उसे स्थल चिह्न कहा जाता है। हम कोड में देखते हैं कि उनके साथ क्या करना है।

कार्य 3: एक मार्ग बनाएँ
यहाँ हमारा मित्र “MasstransitRoutingActivity.java” है। आप एक अलग मार्ग के लिए पूछ सकते हैं: केवल कार से, केवल पैदल, और इसी तरह; यह सुनिश्चित करने के लिए कि आप अभी भी मेट्रो और अन्य विभिन्न चीजों को ध्यान में रख सकते हैं, लेकिन मैंने बतख नहीं किया।

अतिरिक्त कार्य: पोजिशनिंग डायरेक्ट और रिवर्स। हमें स्थान निर्धारित करने में भी सक्षम होना चाहिए। प्रत्यक्ष जियोकोडिंग - नाम से निर्देशांक निर्धारित करें, इसके विपरीत - निर्देशांक द्वारा नाम निर्धारित करें।

इस समस्या को हल करने के लिए, आपको खोज पर लौटना होगा और js [9] के लिए दस्तावेज ढूंढना होगा। यह बहुत अधिक विस्तृत और बड़ा लगता है (मैं ईर्ष्या करता हूं)। हमें "HTTP जियोकोडिंग अनुरोध" [10] की आवश्यकता है - यह बहुत स्पष्ट है कि यह क्या है और इसका उपयोग कैसे करना है। यह मोबाइल फोन पर http अनुरोध-प्रतिक्रियाओं के कार्यान्वयन पर निर्भर है।

कार्रवाई 4: यह अंत / टीएल; डीआर है

सामान्य परिणाम:
यांडेक्स कार्ड शांत हैं। उनका उपयोग कैसे करें यह स्पष्ट नहीं है।

सेवा को "स्पर्श" करने के लिए अच्छा प्रलेखन। इसके साथ कुछ करने के लिए भयानक दस्तावेज। लिंक की संरचना "आप हॉर्सडरिश पाएंगे", खोज की गुणवत्ता "यहां पहिया है, यह रोलिंग है।" और फिर आप स्वयं आसानी से एक कार, एक रॉकेट, एक पनडुब्बी का आविष्कार कर सकते हैं। "

मुख्य विशेषताएं:
किसी प्रोजेक्ट में नक्शा कैसे प्रदर्शित करें? लिंक [7], यहाँ सब कुछ सरल है।
कार्ड में पिन कैसे जोड़ें? कीवर्ड स्थान-चिह्न, MapObjects। नमूनों में खोजें।
मार्ग का निर्माण कैसे करें? खोजशब्द MasstransitRouting। नमूनों में खोजें।
कुछ और कैसे करें? नमूनों में खोजें। अगर वहाँ नहीं है, तो आप एक समस्या है।

संदर्भ:

Yandex.Maps API के साथ मेरा (नैनो) अनुभव या मुझे निर्देश की आवश्यकता क्यों है