MapKit Search: टिप्स एंड ट्रिक्स

MapKit एक सॉफ्टवेयर लाइब्रेरी है जो आपको मोबाइल एप्लिकेशन में मैप डेटा और Yandex प्रौद्योगिकियों का उपयोग करने की अनुमति देता है। उसके पास आधिकारिक दस्तावेज हैं जिसमें पहले से ही एपीआई विधियों का विस्तृत विवरण है, इसलिए आज हम कुछ और के बारे में बात करेंगे।

इस पोस्ट में, मैं Habr पाठकों को MapKit में खोज की विशेषताओं के बारे में बताऊंगा और उन सिफारिशों और ट्रिक्स को साझा करूंगा जो आपके लिए उपयोगी हो सकते हैं।

TL, DR यदि आप पूरे लेख को नहीं पढ़ना चाहते हैं, तो यहां सबसे महत्वपूर्ण बिंदुओं में से दो सबसे महत्वपूर्ण हैं:

• सत्र बचाने के लिए मत भूलना, अन्यथा खोज काम नहीं करेगी।
• सभी सबसे दिलचस्प जानकारी ऑब्जेक्ट के मेटाडेटा में संग्रहीत होती है। यदि आप किसी विशेष कैफे में पूरा पता, खुलने का समय या कप्पुकिनो का एक कप खर्च करना चाहते हैं, तो आपको मेटाडेटा की आवश्यकता है।

पाठ में प्रलेखन के लिंक एंड्रॉइड के लिए होंगे, आईओएस के लिए कक्षाएं और तरीके उसी तरह से कहे जाते हैं।

क्या खोज सकता है

सबसे पहले, आइए बात करते हैं कि MapKit में कौन सी खोज कर सकते हैं। जब आप वहां कुछ ढूंढना चाहते हैं तो मैप मैप से आप जो उम्मीद करते हैं वह कर सकते हैं।

जब आप खोज बार "कैफे", "लेव टॉल्स्टॉय स्ट्रीट, 16" या "ट्राम 3" में टाइप करते हैं, तब टेक्स्ट सर्च काम करता है। यह खोज का सबसे परिष्कृत प्रकार है। इस अर्थ में ऊपर उठे कि वह ट्यूनिंग के लिए अधिकतम मापदंडों का समर्थन करता है। आप जिस मार्ग या मार्ग में रुचि रखते हैं, उसकी खोज करने के लिए तुरंत प्रयास कर सकते हैं, वांछित परिणामों की संख्या स्पष्ट कर सकते हैं, उपयोगकर्ता की स्थिति निर्धारित कर सकते हैं, और इसी तरह। यदि पहली खोज के बाद आप नक्शे को स्थानांतरित करना चाहते हैं या अनुरोध ("एक पूल के साथ फार्मेसियों") पर फ़िल्टर लागू करना चाहते हैं, तो ये फिर से अनुरोध हैं ।

उल्टा खोज अधिकांश उपयोगकर्ताओं को इस सवाल पर परिचित है कि "यहाँ क्या है?"। यह आपको मानचित्र पर क्लिक करने की अनुमति देता है कि यह निर्धारित करने के लिए कि कौन सी सड़क या घर "कर्सर के नीचे" है या कौन से संगठन इस बिंदु के पास हैं। जब आप किसी विशिष्ट ऑब्जेक्ट को ढूंढना चाहते हैं, तो URI द्वारा खोज आवश्यक है। इसका उपयोग, उदाहरण के लिए, किसी एप्लिकेशन में बुकमार्क बनाने के लिए किया जा सकता है। हमने अपना पसंदीदा कॉफी हाउस पाया, इसे एक तारांकन चिह्न के साथ चिह्नित किया - अगली बार यह संभव है कि यूआरआई द्वारा इस संगठन को खोजना संभव है, जहां भी मैप विंडो स्थित है। न तो रिवर्स लुकअप और न ही URI लुकअप पुन: अनुरोधों का समर्थन करते हैं, क्योंकि उनके लिए निर्दिष्ट करने के लिए कुछ भी नहीं है।

एक और अवसर जो खोज में रहता है वह खोज संकेत है , जो आपको टाइप करते समय क्वेरी को स्वचालित रूप से पूरक करने की अनुमति देता है। लेकिन हम उनके बारे में एक और समय के लिए एक विस्तृत कहानी को स्थगित कर देंगे।

कैसे निवेदन किया जाता है

MapKit के कई हिस्सों की तरह खोज, अतुल्यकालिक रूप से काम करता है। इस अतुल्यकालिक के साथ काम करने के लिए मुख्य वस्तु खोज सत्र है । एक छोटा सा उदाहरण देखते हैं।

 // `searchManager`  `searchSession` –  .    //    ,     . searchManager = SearchFactory.getInstance().createSearchManager( SearchManagerType.ONLINE ) val point = Geometry.fromPoint(Point(59.95, 30.32)) searchSession = searchManager!!.submit("", point, SearchOptions(), object: Session.SearchListener { override fun onSearchError(p0: Error) { showMessage("Error") } override fun onSearchResponse(p0: Response) { showMessage("Success") } } ) 

submit कॉल submit तुरंत बाद submit नियंत्रण आपके कोड पर वापस आ जाएगा, और जब MapKit को सर्वर से प्रतिक्रिया मिलती है, तो SearchListener को कॉल किया जाएगा।

खोज सत्र आपको इसकी अनुमति देता है:

• अनुरोध रद्द करें । उदाहरण के लिए, यदि उपयोगकर्ता खोज स्क्रीन बंद कर देता है।
• त्रुटि के मामले में अनुरोध दोहराएं । उदाहरण के लिए, यदि नेटवर्क के साथ कोई समस्या थी।
• प्रतिक्रिया प्राप्त होने के बाद खोज के साथ सहभागिता जारी रखें। सत्र के माध्यम से पुनः अनुरोध किया जाता है।

निरस्तीकरण पर एक सत्र स्वतः रद्द हो जाता है। इसका मतलब है कि अगर यह क्लाइंट कोड साइड में सेव नहीं है, तो सर्च काम नहीं करेगा।
सत्र को बचाने के लिए मत भूलना, सत्र आपका दोस्त है!

विकल्प खोजें

खोज क्वेरी को कॉन्फ़िगर करने का एक सामान्य तरीका SearchOptions class है, जो आपको क्वेरी पैरामीटर को संशोधित करने की अनुमति देता है।

• इन मापदंडों में से मुख्य SearchType । यह आपको यह निर्दिष्ट करने की अनुमति देता है कि क्या आप उत्तर में शीर्षलेख, संगठन या परिवहन देखना चाहते हैं (आपको सबसे अधिक संभावना अन्य प्रकार की आवश्यकता नहीं होगी)।
• एक अन्य महत्वपूर्ण क्वेरी पैरामीटर स्निपेट्स है । हम प्रतिक्रिया डिवाइस पर अनुभाग में उनके बारे में अधिक विस्तार से बात करेंगे।
• यदि आप setGeometry(true) उदाहरण के लिए, सड़कों या क्षेत्रों) की ज्यामिति प्राप्त करना चाहते हैं, तो आपको इसे setGeometry(true) माध्यम से ऑर्डर करने की आवश्यकता है। ध्यान रखें कि संचरित डेटा के मामले में ज्यामिति काफी "भारी" है।
• डिफ़ॉल्ट रूप से, खोज बंद (अस्थायी या स्थायी रूप से) संगठनों पर नहीं setSearchClosed(true) , लेकिन यदि आपको उनकी आवश्यकता है, तो आपको setSearchClosed(true) सेट setSearchClosed(true) ।

सूचीबद्ध मापदंडों के अलावा, कुछ और भी हैं जो आपके लिए उपयोगी हो सकते हैं, वे कक्षा के लिए प्रलेखन में पाए जा सकते हैं। ध्यान दें कि सभी क्वेरीज़ पैरामीटर के सभी संयोजनों का समर्थन नहीं करती हैं। प्रत्येक SearchManager या Session विधि के लिए दस्तावेज़ीकरण इंगित करता है कि SearchOptions से कौन से पैरामीटर इसे समझते हैं।

उत्तर की व्यवस्था कैसे की जाती है

समर्थन में प्रश्नों को देखते हुए, अधिकांश उपयोगकर्ता खोज प्रतिक्रिया के प्रारूप से भ्रमित होते हैं। यदि आप प्रतिक्रिया वर्ग को देखते हैं, तो यह काफी सरल लगता है (कम से कम, हमारे लिए दिलचस्प हिस्सा):

 public class Response { public synchronized SearchMetadata getMetadata(); public synchronized GeoObjectCollection getCollection(); // ... } 

यहां getCollection() प्रतिक्रिया में ऑब्जेक्ट्स लौटाता है, और getMetadata() कुछ अतिरिक्त डेटा हैं, जिनमें उदाहरण के लिए, प्रतिक्रिया विंडो के बारे में जानकारी, रैंकिंग का प्रकार और परिणामों की संख्या पाई जाती है । यदि आप GeoObjectCollection अंदर देखते हैं GeoObjectCollection तो आप देख सकते हैं कि इसमें कुछ Item s हैं जो या तो अन्य GeoObjectCollection या GeoObject ।

खोज में संग्रह के अंदर कोई संग्रह नहीं है (कम से कम अभी तक नहीं), तो चलिए GeoObject पर एक नज़र GeoObject । ऑब्जेक्ट के अंदर एक नाम ( getName() ), एक विवरण ( getDescriptionText() ), एक फ्रेम ( getBoundingBox() ), ज्यामिति का एक सेट ( getGeometry() ), और कुछ अन्य बहुत स्पष्ट तरीके नहीं हैं। संगठन के फ़ोन नंबर कहाँ हैं? कैसे समझा जाए कि कौन से शहर का नाम किस ओर है?

ऑब्जेक्ट के तरीकों के अनुसार, यह बहुत स्पष्ट नहीं है।

GeoObject

यह GeoObject बारे में अधिक बात करने का समय है।

GeoObject एक ऐसी बुनियादी "कार्ड" वस्तु है। इसके अंदर एक सड़क घटना हो सकती है, खोज परिणाम से अलग वस्तु, मार्ग में एक पैंतरेबाज़ी या नक्शे पर एक वस्तु (पीओआई), जैसे कि एक स्मारक या कुछ उल्लेखनीय संगठन।

ऑब्जेक्ट के बारे में सभी सबसे दिलचस्प मेटाडेटा में संग्रहीत हैं। उन्हें getMetadataContainer() विधि का उपयोग करके एक्सेस किया जा सकता है। इस कंटेनर में कुंजी मेटाडेटा प्रकार है। यदि आप Metadata शब्द के साथ समाप्त होने वाले दस्तावेज़ में कुछ देखते हैं, तो आप यहाँ सबसे अधिक संभावना रखते हैं। विभिन्न "मेटाडेटा" टुकड़ों की खोज में 15।

मेटाडेटा को कई प्रकारों में विभाजित किया जा सकता है। पहला प्रकार मेटाडेटा है जो निर्धारित करता है कि ऑब्जेक्ट किस प्रकार का है: toponyms ( ToponymObjectMetadata ), संगठन ( BusinessObjectMetadata ) या परिवहन ( TransitObjectMetadata )। शीर्षलेख के मेटाडेटा में, आप एक संरचित पता और विस्तृत ज्यामिति पा सकते हैं। संगठन के लिए मेटाडेटा संचालन के घंटे या कंपनी की साइट है। यह मेटाडेटा अनुरोध में खोज के प्रकार द्वारा निर्धारित किया जाता है - यदि आपने केवल टॉपऑनम्स के लिए खोज की है, तो प्रतिक्रिया में प्रत्येक ऑब्जेक्ट में संबंधित मेटाडेटा होना चाहिए। यदि आप जगह के नाम या संगठनों की तलाश कर रहे थे, तो प्रत्येक ऑब्जेक्ट में कम से कम दो "मेटाडेटा" होंगे।

कंपनी फ़ोन नंबर खोजने का तरीका यहां दिया गया है:

 val phones = response.collection.children.firstOrNull()?.obj ?.metadataContainer ?.getItem(BusinessObjectMetadata::class.java) ?.phones 

और यहाँ एक संरचित पते में शहर को कैसे खोजना है:

 val city = response.collection.children.firstOrNull()?.obj ?.metadataContainer ?.getItem(ToponymObjectMetadata::class.java) ?.address ?.components ?.firstOrNull { it.kinds.contains(Address.Component.Kind.LOCALITY) } ?.name 

दूसरा प्रकार मेटाडेटा है जो ऑब्जेक्ट के साथ आता है, हालांकि आपने इसके बारे में नहीं पूछा। आपके बारे में जानने के लिए मुख्य प्रकार URIObjectMetadata । URIObjectMetadata अंदर URIObjectMetadata ऑब्जेक्ट की विशिष्ट पहचानकर्ता संग्रहीत की जाती है, जिसे URI द्वारा खोज में पारित किया जाना चाहिए।

 //       «»,     //     val uri = response.collection.children.firstOrNull()?.obj ?.metadataContainer ?.getItem(UriObjectMetadata::class.java) ?.uris ?.firstOrNull() ?.value 

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

 val point = Geometry.fromPoint(Point(59.95, 30.32)) val options = SearchOptions() options.snippets = Snippet.FUEL.value searchSession = searchManager!!.submit("", point, options, this) ... override fun onSearchResponse(response: Response) { //         showMessage(response.collection.children.firstOrNull()?.obj ?.metadataContainer ?.getItem(FuelMetadata::class.java) ?.fuels ?.joinToString("\n") { "Fuel(name=${it.name}, price=${it.price?.text})" } ?: "No fuel" ) } 

ऊपर सूचीबद्ध सभी मेटाडेटा को प्रतिक्रिया में व्यक्तिगत वस्तुओं में जोड़ा जाता है। मेटाडेटा भी है जिसे संपूर्ण प्रतिक्रिया में जोड़ा जाता है। लेकिन उन्हें SearchMetadata विधियों में लाया जाता है और उन्हें किसी विशेष संग्रह से निकालने की आवश्यकता नहीं होती है।

 //            response.metadata.businessResultMetadata?.categories //     (  )     response.metadata.toponymResultMetadata?.responseInfo?.mode 

उपयोग के उदाहरण

अब चलो खोज वर्गों के मुख्य तरीकों से गुजरते हैं, उपयोग के उदाहरणों को देखते हैं और उनसे जुड़े कुछ गैर-स्पष्ट बिंदुओं पर।

पाठ खोज

पाठ खोज के लिए मुख्य विधि (और संपूर्ण खोज के लिए, शायद) submit :

 Session submit( String text, Geometry geometry, SearchOptions searchOptions, SearchListener searchListener ); 

• text पैरामीटर में वह पाठ शामिल होने की उम्मीद की जाती है जिसे आप खोजना चाहते हैं।
• geometry पैरामीटर थोड़ा पेचीदा है। किस प्रकार की ज्यामिति स्थानांतरित की जाती है, इसके आधार पर, खोज अलग तरह से व्यवहार करेगी:
  
  • यदि आप एक बिंदु पास करते हैं, तो इस बिंदु के बगल में एक छोटी सी खिड़की में खोज की जाएगी।
  • यदि आप एक आयताकार खिड़की ( BoundingBox ) या चार बिंदुओं के बहुभुज को पास करते हैं, तो इसका उपयोग खोज बॉक्स के रूप में किया जाएगा। ऐसी खिड़की का एक सरल उदाहरण नक्शे का दृश्य क्षेत्र है।
  • अंत में, यदि आप पॉलीलाइन पास करते हैं, तो उसका वर्णन करने वाली विंडो का उपयोग खोज विंडो के रूप में किया जाएगा, और रैंकिंग को इस पॉलीलाइन को ध्यान में रखते हुए किया जाएगा।
• हमने पहले ही ऊपर SearchListener और SearchListener बारे में बात की थी।

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

submit विधि में एक submit ट्विन है:

 Session submit( String text, Polyline polyline, Geometry geometry, SearchOptions searchOptions, SearchListener searchListener ); 

एक अतिरिक्त पैरामीटर के साथ। इस पैरामीटर का उपयोग बड़ी पॉलीलाइन (उदाहरण के लिए, किसी अन्य शहर के लिए एक मार्ग) और एक छोटी खोज विंडो को स्थानांतरित करने के लिए किया जा सकता है। तब खोज स्वयं स्थानांतरित पॉलीलाइन के आवश्यक हिस्से को काट देगी और क्वेरी के लिए केवल इसका उपयोग करेगी।

पुनर्प्रयास

अन्य प्रकार के अनुरोधों के विपरीत, पुनः अनुरोध, एक खोज सत्र की मदद से किया जाता है, जो एक ही submit और उसके जुड़वा भाई को वापस करता है। सत्र के तरीकों का हिस्सा सरल और सीधा है:

• आप अनुरोध विंडो को बदल सकते हैं (जब उपयोगकर्ता, उदाहरण के लिए, कार्ड को स्थानांतरित करता है)
• खोज विकल्प अपडेट किए जा सकते हैं (उदाहरण के लिए, उपयोगकर्ता की स्थिति को अपडेट करने के लिए)
• आप रैंकिंग के प्रकार - दूरी या रेटिंग के अनुसार बदल सकते हैं।

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

फिल्टर

चूंकि हम फिल्टर के बारे में बात कर रहे हैं। फिल्टर तब होते हैं जब वाई-फाई और इतालवी भोजन। वे शायद MapKit में सभी खोज इंटरफेस के सबसे भ्रामक वाक्यविन्यास हैं। यह इस तथ्य के कारण है कि खोज प्रतिक्रिया से फ़िल्टर प्राप्त करने और पुनः अनुरोध में फ़िल्टर निर्दिष्ट करने के लिए समान डेटा संरचनाओं का उपयोग किया जाता है।

फिल्टर दो प्रकार से आते हैं। बूलियन फिल्टर केवल दो परस्पर अनन्य मान लेते हैं - हां या नहीं। यह एक कैफे में वाई-फाई, गैस स्टेशन पर एक शौचालय या संगठन के पास पार्किंग की उपस्थिति हो सकती है। Enum फ़िल्टर कई मान लेते हैं जिन्हें एक साथ अनुरोध किया जा सकता है। यह, उदाहरण के लिए, एक गैस स्टेशन पर एक कैफे के लिए रसोई का प्रकार या ईंधन का प्रकार है।

सबसे पहले, आइए देखें कि वर्तमान रीबूट के लिए फ़िल्टर कैसे उपलब्ध हैं:

 private fun filters(response: Response): String? { fun enumValues(filter: BusinessFilter) = filter .values .enums ?.joinToString(prefix = " -> ") { e -> e.value.id } ?: "" return response .metadata .businessResultMetadata ?.businessFilters ?.joinToString(separator = "\n") { f -> "${f.id}${enumValues(f)}" } } 

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

 val boolFilter = BusinessFilter( /* id= */ "wi_fi", /* name= */ "", /* disabled= */ false, /* values= */ BusinessFilter.Values.fromBooleans( listOf(BusinessFilter.BooleanValue(true, true)) ) ) 

अब एनम फिल्टर:

 val enumFilter = BusinessFilter( /* id= */ "type_cuisine", /* name= */ "", /* disabled= */ false, /* values= */ BusinessFilter.Values.fromEnums( listOf(BusinessFilter.EnumValue( Feature.FeatureEnumValue( /* id= */ "italian_cuisine", /* name= */ "", /* imageUrlTemplate= */ "" ), true, true )) ) ) 

अंत में, आप सत्र में फ़िल्टर जोड़ सकते हैं और resubmit() कर सकते हैं resubmit() :

 searchSession!!.setFilters(listOf(boolFilter, enumFilter)) searchSession!!.resubmit(this) 

कृपया ध्यान दें कि आप पहली क्वेरी के लिए फ़िल्टर सेट नहीं कर सकते हैं। पहले आपको एक खोज प्रतिक्रिया प्राप्त करने की आवश्यकता है जो उपलब्ध फ़िल्टर को सूचीबद्ध करती है। और उसके बाद ही रिबूट बनाने के लिए।

अतिरिक्त परिणाम

एक और सत्र आपको यह जांचने की अनुमति देता है कि आपके अनुरोध के लिए अतिरिक्त खोज परिणाम हैं या नहीं। और, यदि वे हैं, तो उन्हें प्राप्त करें। उदाहरण के लिए, जब आप अपने शहर में एक कैफे की तलाश में होते हैं, तो सबसे अधिक संभावना है कि उनमें से सभी खोज उत्तर के एक पृष्ठ पर फिट नहीं होंगे। सूची में निम्नलिखित पृष्ठों को देखने के लिए hasNextPage और fetchNextPage की एक जोड़ी की आवश्यकता है। यहां आपको यह जानने की जरूरत है कि अगर hasNextPage विधि false तो सबसे पहले, कॉलिंग fetchNextPage को कॉल fetchNextPage एक अपवाद होगा। और दूसरी बात, इन विधियों के उपयोग का अर्थ है कि शेष पैरामीटर नहीं बदलते हैं। यही है, सत्र का उपयोग या तो अनुरोध को फिर से परिष्कृत करने के लिए किया जाता है ( resubmit() ), या निम्नलिखित पृष्ठों को पुनः प्राप्त करने के लिए ( fetchNextPage() )। इन विधियों को संयोजित करना आवश्यक नहीं है।

उलटा खोज

सुविधा के लिए रिवर्स खोज को submit भी कहा जाता है:

 Session submit( Point point, Integer zoom, SearchOptions searchOptions, SearchListener searchListener ) 

यह अन्य प्रकार के प्रश्नों से भिन्न है, इसमें प्रवेश के लिए केवल एक प्रकार की खोज की आवश्यकता होती है । आप या तो GEO टाइप पास करते हैं और जगह के नाम, या BIZ टाइप करते हैं और संगठनों की तलाश करते हैं। कोई तीसरा नहीं है।

जब GEO प्रकार के साथ वापस खोज करते हैं, तो ऐसे बिंदु होते हैं जिन्हें स्पष्टीकरण की आवश्यकता होती है। कृपया ध्यान दें कि उत्तर में पदानुक्रम में कई ऑब्जेक्ट होंगे (अर्थात, उत्तर में एक घर, सड़क, शहर, और इसी तरह शामिल होंगे)। साधारण मामलों में, आप सिर्फ पहली वस्तु ले सकते हैं। अधिक जटिल लोगों में, आप चाहते हैं कि पदानुक्रम के माध्यम से खोज करें।

उपयोगकर्ता मानचित्र पर क्या देखता है, इसके आधार पर पर्याप्त परिणाम उत्पन्न करने के लिए ज़ूम स्तर की आवश्यकता होती है। एक राष्ट्रव्यापी मानचित्र को देखने वाले उपयोगकर्ता की कल्पना करें। यदि उपयोगकर्ता गलती से उन में जाने में कामयाब हो जाता है, तो उसके लिए एक अलग सड़क या घर पर क्लिक करना अजीब होगा। काफी शहरों में। यह वही है जो zoom पैरामीटर के लिए है।

 val point = Point(55.734, 37.588) //         «  , 16» searchSession = searchManager!!.submit(point, 16, SearchOptions(), this) //    –  " " searchSession = searchManager!!.submit(point, 14, SearchOptions(), this) 

URI द्वारा खोजें

यहां सब कुछ काफी स्पष्ट है - हम यूआरआई को URIObjectMetadata से URIObjectMetadata , इसे याद रखें, थोड़ी देर के बाद हम खोज में जाते हैं और इस यूआरआई से हमें वह वस्तु मिलती है जो हमें याद थी।

 searchSession = searchManager!!.resolveURI(uri, SearchOptions(), this) 

किसी तरह उबाऊ भी।

खोज परत और उज्ज्वल भविष्य

SearchManager बगल में अभी भी एक चीज़ है जिसे खोज लेयर कहा जाता है। मानचित्र के साथ खोज को संयोजित करने के लिए परत की कल्पना की गई थी। वह स्वयं जानता है कि परिणामों को कैसे जोड़ना है, मानचित्र को स्थानांतरित करें ताकि ये परिणाम तब दिखाई दें जब उपयोगकर्ता मानचित्र को स्थानांतरित करे। कई मायनों में, यह संयुक्त SearchManager और Session समान है, लेकिन नक्शे के साथ अंतर्निहित कार्य में नई सुविधाएँ शामिल हैं। और उनके बारे में बात करना इस लेख के दायरे से परे है। MapKit 3.1 की रिलीज़ के समय, हम पहले ही वास्तविक अनुप्रयोगों में खोज परत के चारों ओर भाग चुके थे, इसलिए आप इसे अपने घर में उपयोग करने का प्रयास कर सकते हैं। शायद यह आपकी खोज का काम आसान कर देगा।

निष्कर्ष

मुझे उम्मीद है कि लेख पढ़ने के बाद आपको पूरी ताकत में MapKit में खोज के साथ काम करने की समझ होगी। निश्चित रूप से अभी भी कुछ सूक्ष्म और गैर-तुच्छ क्षण थे (उदाहरण के लिए, हमने लगभग युक्तियों और खोज परत के बारे में बात नहीं की थी)। कुछ दस्तावेज में पाया जा सकता है, कुछ गिटहब पर परियोजनाओं में स्पष्ट करने या हमारा समर्थन पूछने के लिए।

MapKit का प्रयास करें, इसमें खोज का उपयोग करें और उन्हें और भी बेहतर बनाने के लिए मानचित्र पर आएं !

PS और 29 नवंबर को मोटर वाहन राउटिंग बैकेंड की व्यवस्था के बारे में सुनने के लिए भी हमसे मिलने आए। जो, वैसे, MapKit में भी इस्तेमाल किया जा सकता है, लेकिन यह एक पूरी तरह से अलग कहानी है।