मैप्स एक्सप्लोरर के उदाहरण पर नोकिया मैप्स एपीआई

यह डेवलपर्स के लिए नोकिया एपीआई की रिलीज पर तीसरा लेख है।
जो लोग चूक गए, उनके लिए यहां पहले दो भाग हैं:
नोकिया संगीत एपीआई
उन्नत कैमरा एपीआई

आज हम नोकिया मैप्स एपीआई का उपयोग करने के बारे में बात करेंगे।

मानचित्र अन्वेषक

मैप एक्सप्लोरर एक सरल सिल्वरलाइट एप्लिकेशन है जो दर्शाता है कि विंडोज फोन 7 में उपयोग किए गए बिंग मैप्स के बजाय विंडोज फोन 8 मैप्स एपीआई का उपयोग कैसे किया जाए।

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

डिज़ाइन

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



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

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

अतिरिक्त सेटिंग्स एप्लिकेशन मेनू में हैं, जहां आप पैरामीटर जैसे आकर्षण, लंबी पैदल यात्रा के मार्ग और दिशाओं के प्रदर्शन को सक्षम कर सकते हैं। यहां आप कार्ड का रंग मोड चुन सकते हैं: गहरा और हल्का।

वास्तुकला अवलोकन

वास्तुकला का विश्लेषण

उपयोगकर्ता इंटरफ़ेस

यूजर इंटरफेस में मेनपेज और इंफॉर्मेशन अबाउटपेज शामिल है - जो कि फोनएप्लीकेशनपेज से लिया गया है। MainPage में मानचित्र और इस एप्लिकेशन की सभी कार्टोग्राफिक कार्यक्षमता शामिल है।

विंडोज फोन लोकेशन एपीआई

Windows Phone स्थान API का उपयोग वर्तमान स्थान निर्धारित करने के लिए Windows.Devices.Geolocation नाम स्थान में किया जाता है। किसी अनुप्रयोग के पास स्थान सेवाओं का उपयोग करने के लिए WMAppManifest.xml फ़ाइल में निर्दिष्ट ID_CAP_LOCATION होना चाहिए।

मैप्स एपीआई

नया विंडोज फोन 8 मैप्स एपीआई वैध मानचित्र नियंत्रण (Microsoft.Phone.Maps.Controls) और संबंधित मानचित्र सेवाएं (Microsoft.Phone.Maps.Services) प्रदान करता है। मैप्स एपीआई का उपयोग करने के लिए, आवेदन में WMAppManifest.xml फ़ाइल में निर्दिष्ट ID_CAP_LOCATION होना चाहिए।

मानचित्र सेटिंग्स के साथ प्रत्यक्ष बातचीत

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

<Slider x:Name="PitchSlider" ... Minimum="0" Maximum="70" Value="0" ValueChanged="PitchValueChanged"/> 

तब ValueChanged ईवेंट के इवेंट हैंडलर को MainPage.xaml.cs फ़ाइल में निष्पादित किया जाता है।

 using Microsoft.Phone.Maps.Controls; ... public partial class MainPage : PhoneApplicationPage { ... private void PitchValueChanged(object sender, EventArgs e) { if (PitchSlider != null) { MyMap.Pitch = PitchSlider.Value; } } ... } 

वर्तमान स्थान के निर्देशांक प्राप्त करना

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

 using System.Device.Location; using Windows.Devices.Geolocation; public partial class MainPage : PhoneApplicationPage { ... private GeoCoordinate MyCoordinate = null; private double _accuracy = 0.0; ... private async void GetCurrentCoordinate() { ... Geolocator geolocator = new Geolocator(); geolocator.DesiredAccuracy = PositionAccuracy.High; try { Geoposition currentPosition = await geolocator.GetGeopositionAsync(TimeSpan.FromMinutes(1), TimeSpan.FromSeconds(10)); _accuracy = currentPosition.Coordinate.Accuracy; ... Dispatcher.BeginInvoke(() => { MyCoordinate = new GeoCoordinate(currentPosition.Coordinate.Latitude, currentPosition.Coordinate.Longitude); ... }); } catch (Exception ex) { //     –      MessageBox.Show("Current location cannot be obtained. Check that location service is turned on in phone settings."); } ... } ... } 

स्थान की जानकारी प्राप्त करना

आप ReverseGeocodeQuery का उपयोग करके किसी विशिष्ट स्थान के बारे में जानकारी का अनुरोध कर सकते हैं। मैप एक्सप्लोरर में, जब आप मैप पर किसी टैग को छूते हैं तो ReverseGeocodeQuery शुरू होता है। प्रत्येक टैग के जियो-निर्देशांक टैग बहुभुज सेटिंग में उस समय संग्रहीत किए जाते हैं जब टैग बनाया जाता है।

 using using Microsoft.Phone.Maps.Services; public partial class MainPage : PhoneApplicationPage { ... private ReverseGeocodeQuery MyReverseGeocodeQuery = null; ... private void Marker_Click(object sender, EventArgs e) { Polygon p = (Polygon)sender; GeoCoordinate geoCoordinate = (GeoCoordinate)p.Tag; MyReverseGeocodeQuery = new ReverseGeocodeQuery(); MyReverseGeocodeQuery.GeoCoordinate = new GeoCoordinate(geoCoordinate.Latitude, geoCoordinate.Longitude); MyReverseGeocodeQuery.QueryCompleted += ReverseGeocodeQuery_QueryCompleted; MyReverseGeocodeQuery.QueryAsync(); } private void ReverseGeocodeQuery_QueryCompleted(object sender, QueryCompletedEventArgs<IList<MapLocation>> e) { if (e.Error == null) { if (e.Result.Count > 0) { MapAddress address = e.Result[0].Information.Address; String msgBoxText = ""; ... if (address.Country.Length > 0) msgBoxText += "\n" + address.Country; MessageBox.Show(msgBoxText, AppResources.ApplicationTitle, MessageBoxButton.OK); } ... } } ... } 

मानचित्र पर कीवर्ड द्वारा खोजें

GeocodeQuery का उपयोग किसी दिए गए क्वेरी के स्थान को खोजने के लिए किया जा सकता है, जैसे शहर या सड़क का नाम। कीवर्ड द्वारा खोज करने और मार्ग का निर्माण करते समय GeocodeQuery_QueryCompleted इवेंट हैंडलर दोनों को कहा जाता है। मार्ग के संबंध में एक विवरण नीचे दिया गया है। GeocodeQuery का परिणाम SearchTerm क्वेरी से मेल खाता एक सूची है। प्रत्येक MapLocation में एक मानचित्र पर एक स्थान की स्थिति के लिए एक GeoCoordinate है, साथ ही एक नाम, विवरण और MapAdress स्थान के साथ एक विस्तृत स्थान सूचना है।

 using Microsoft.Phone.Maps.Services; public partial class MainPage : PhoneApplicationPage { ... private GeoCoordinate MyCoordinate = null; private List<GeoCoordinate> MyCoordinates = new List<GeoCoordinate>(); private GeocodeQuery MyGeocodeQuery = null; private bool _isRouteSearch = false; // True    ,  false ... private void SearchForTerm(String searchTerm) { ... MyGeocodeQuery = new GeocodeQuery(); MyGeocodeQuery.SearchTerm = searchTerm; MyGeocodeQuery.GeoCoordinate = MyCoordinate == null ? new GeoCoordinate(0, 0) : MyCoordinate; MyGeocodeQuery.QueryCompleted += GeocodeQuery_QueryCompleted; MyGeocodeQuery.QueryAsync(); } private void GeocodeQuery_QueryCompleted(object sender, QueryCompletedEventArgs<IList<MapLocation>> e) { ... if (e.Error == null) { if (e.Result.Count > 0) { if (_isRouteSearch) //        { ... } else //        { //    MyCoordinates     . for (int i = 0; i < e.Result.Count; i++) { MyCoordinates.Add(e.Result[i].GeoCoordinate); } ... } } else { MessageBox.Show("No match found. Narrow your search eg Seattle WA."); } } ... } 

वर्तमान बिंदु से गंतव्य तक मार्ग प्रदर्शित करें

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

 public partial class MainPage : PhoneApplicationPage { ... private GeoCoordinate MyCoordinate = null; private List<GeoCoordinate> MyCoordinates = new List<GeoCoordinate>(); private RouteQuery MyRouteQuery = null; private Route MyRoute = null; private MapRoute MyMapRoute = null; private bool _isRouteSearch = false; // True    ,  false private TravelMode _travelMode = TravelMode.Driving; // Travel mode     .... private void GeocodeQuery_QueryCompleted(object sender, QueryCompletedEventArgs<IList<MapLocation>> e) { ... if (e.Error == null) { if (e.Result.Count > 0) { if (_isRouteSearch) //        { //         MyCoordinates.Add(e.Result[0].GeoCoordinate); //         List<GeoCoordinate> routeCoordinates = new List<GeoCoordinate>(); routeCoordinates.Add(MyCoordinate); routeCoordinates.Add(e.Result[0].GeoCoordinate); CalculateRoute(routeCoordinates); } else //        { ... } } ... } ... } private void CalculateRoute(List<GeoCoordinate> route) { ... MyRouteQuery = new RouteQuery(); MyRouteQuery.TravelMode = _travelMode; MyRouteQuery.Waypoints = route; MyRouteQuery.QueryCompleted += RouteQuery_QueryCompleted; MyRouteQuery.QueryAsync(); } private void RouteQuery_QueryCompleted(object sender, QueryCompletedEventArgs<Route> e) { ... if (e.Error == null) { MyRoute = e.Result; MyMapRoute = new MapRoute(MyRoute); MyMap.AddRoute(MyMapRoute); //       List<string> routeInstructions = new List<string>(); foreach (RouteLeg leg in MyRoute.Legs) { for (int i = 0; i < leg.Maneuvers.Count; i++) { RouteManeuver maneuver = leg.Maneuvers[i]; string instructionText = maneuver.InstructionText; ... routeInstructions.Add(instructionText); } } ... } ... } } 

अतिरिक्त जानकारी

मानचित्र नियंत्रण और अतिरिक्त सेवाओं के बारे में जानकारी की गहन समझ के लिए, मैप्स के लिए मार्गदर्शिका देखें।

डाउनलोड

नक्शा एक्सप्लोरर v1.0 परियोजना
मैप एक्सप्लोरर एप्लिकेशन बाइनरी फाइल v1.0

यह एप्लिकेशन नोकिया डेवलपर प्रोजेक्ट्स पर स्थित है, जहां आप हमेशा नवीनतम गतिविधि देख सकते हैं, त्रुटि की रिपोर्ट कर सकते हैं, कोड देख सकते हैं, प्रश्न पूछ सकते हैं या प्रोजेक्ट में योगदान दे सकते हैं।