iOS के लिए Google Maps की यूआरएल स्कीम

iOS 9 और इसके बाद के वर्शन पर काम करने वाले डिवाइसों पर, Google Maps का यूआरएल होने पर, Google Maps को लॉन्च करने के लिए यूनिवर्सल लिंक का इस्तेमाल किया जा सकता है.

Google Maps के यूआरएल स्कीम का इस्तेमाल करके, iOS के लिए Google Maps ऐप्लिकेशन लॉन्च किया जा सकता है. साथ ही, खोजें की जा सकती हैं, दिशा-निर्देशों के अनुरोध किए जा सकते हैं, और मैप व्यू दिखाए जा सकते हैं. Google Maps लॉन्च करने पर, आपके बंडल आइडेंटिफ़ायर को अनुरोध के हिस्से के तौर पर अपने-आप भेज दिया जाता है.

Google Maps यूआरएल स्कीम का इस्तेमाल करने के लिए, Google API पासकोड की ज़रूरत नहीं होती.

यूनिवर्सल लिंक और Google Maps

iOS के लिए Google Maps, iOS 9 या इसके बाद के वर्शन वाले डिवाइसों पर यूनिवर्सल लिंक के साथ काम करता है.

अगर आपका यूआरएल इस रेगुलर एक्सप्रेशन से मेल खाता है और डिवाइस में iOS 9 या इसके बाद का वर्शन है, तो सीधे openURL: मेथड का इस्तेमाल किया जा सकता है.

(http(s?)://)?
((maps\.google\.{TLD}/)|
 ((www\.)?google\.{TLD}/maps/)|
 (goo.gl/maps/))
.*

उदाहरण के लिए,

UIApplication.shared.openURL(URL(string:"https://www.google.com/maps/@42.585444,13.007813,6z")!)

[[UIApplication sharedApplication] openURL:
   [NSURL URLWithString:@"https://www.google.com/maps/@42.585444,13.007813,6z"]];

खास जानकारी

यूआरएल स्कीम की मदद से, किसी iOS ऐप्लिकेशन को दूसरे iOS ऐप्लिकेशन या वेब ऐप्लिकेशन से लॉन्च किया जा सकता है. यूआरएल में ऐसे विकल्प सेट किए जा सकते हैं जिन्हें लॉन्च किए गए ऐप्लिकेशन को पास किया जाता है. iOS के लिए Google Maps ऐप्लिकेशन, यहां दी गई यूआरएल स्कीम के साथ काम करता है:

• comgooglemaps:// - इस स्कीम की मदद से, iOS के लिए Google Maps ऐप्लिकेशन लॉन्च किया जा सकता है. साथ ही, कई कार्रवाइयां की जा सकती हैं:

  • किसी तय जगह और ज़ूम करने के लेवल पर मैप दिखाएं.
  • जगहों या जगहों को खोजें और उन्हें मैप पर दिखाएं.
  • एक जगह से दूसरी जगह जाने का रास्ता पूछना. रास्ते की जानकारी, यात्रा के चार तरीकों के लिए दी जा सकती है: ड्राइविंग, पैदल चलना, साइकल चलाना, और सार्वजनिक परिवहन.
  • अपने ऐप्लिकेशन में नेविगेशन जोड़ें.

• comgooglemapsurl:// - इस स्कीम की मदद से, डेस्कटॉप पर Google Maps की वेबसाइट से मिले यूआरएल का इस्तेमाल करके, iOS के लिए Google Maps ऐप्लिकेशन लॉन्च किया जा सकता है. इसका मतलब है कि Google Maps की वेबसाइट लोड करने के बजाय, उपयोगकर्ताओं को मोबाइल ऐप्लिकेशन का अनुभव दिया जा सकता है.

  • मूल यूआरएल, maps.google.com या google.com/maps के लिए हो सकता है. इसके अलावा, com के बजाय किसी मान्य टॉप-लेवल कंट्री डोमेन का इस्तेमाल किया जा सकता है. goo.gl/maps रीडायरेक्शन यूआरएल भी पास किए जा सकते हैं.

iOS के लिए Google Maps ऐप्लिकेशन लॉन्च करना और कोई खास फ़ंक्शन इस्तेमाल करना

iOS के लिए Google Maps ऐप्लिकेशन लॉन्च करने और ज़रूरत पड़ने पर, काम करने वाले किसी फ़ंक्शन को पूरा करने के लिए, इस फ़ॉर्म का यूआरएल स्कीम इस्तेमाल करें:

comgooglemaps://?parameters

इस दस्तावेज़ में, पैरामीटर के बारे में ज़्यादा जानकारी दी गई है.

यह देखना कि डिवाइस पर Google Maps ऐप्लिकेशन उपलब्ध है या नहीं

अपने ऐप्लिकेशन में किसी उपयोगकर्ता को इनमें से कोई यूआरएल दिखाने से पहले, आपको यह पुष्टि करनी चाहिए कि ऐप्लिकेशन इंस्टॉल है. आपका ऐप्लिकेशन, इस कोड की मदद से यह जांच कर सकता है कि यूआरएल स्कीम उपलब्ध है या नहीं:

UIApplication.shared.canOpenURL(URL(string:"comgooglemaps://")!)

[[UIApplication sharedApplication] canOpenURL:
    [NSURL URLWithString:@"comgooglemaps://"]];

उदाहरण के लिए, न्यूयॉर्क के सेंट्रल पार्क का मैप दिखाने के लिए, इस कोड का इस्तेमाल किया जा सकता है:

if (UIApplication.shared.canOpenURL(URL(string:"comgooglemaps://")!)) {
  UIApplication.shared.openURL(URL(string:
    "comgooglemaps://?center=40.765819,-73.975866&zoom=14&views=traffic")!)
} else {
  print("Can't use comgooglemaps://");
}

if ([[UIApplication sharedApplication] canOpenURL:
     [NSURL URLWithString:@"comgooglemaps://"]]) {
  [[UIApplication sharedApplication] openURL:
   [NSURL URLWithString:@"comgooglemaps://?center=40.765819,-73.975866&zoom=14&views=traffic"]];
} else {
  NSLog(@"Can't use comgooglemaps://");
}

मैप डिसप्ले करने का तरीका

किसी तय ज़ूम करने के लेवल और लोकेशन पर मैप दिखाने के लिए, यूआरएल स्कीम का इस्तेमाल करें. मैप के ऊपर अन्य व्यू भी दिखाए जा सकते हैं. इसके अलावा, Street View की तस्वीरें भी दिखाई जा सकती हैं.

पैरामीटर

यहां दिए गए सभी पैरामीटर को इस्तेमाल करना या न करना आपकी ज़रूरत पर तय करता है. अगर कोई पैरामीटर सेट नहीं किया जाता है, तो यूआरएल स्कीम, iOS के लिए Google Maps ऐप्लिकेशन लॉन्च करेगी.

• center: यह मैप व्यूपोर्ट का केंद्र बिंदु है. इसे कॉमा लगाकर अलग की गई latitude,longitude की स्ट्रिंग के तौर पर फ़ॉर्मैट किया जाता है.
• mapmode: इससे यह तय होता है कि मैप किस तरह का दिखेगा. इसे standard या streetview पर सेट किया जा सकता है. अगर यह जानकारी नहीं दी जाती है, तो ऐप्लिकेशन की मौजूदा सेटिंग का इस्तेमाल किया जाएगा.
• views: इससे कुछ खास व्यू चालू/बंद किए जाते हैं. इसे satellite, traffic या transit पर सेट किया जा सकता है. कॉमा सेपरेटर का इस्तेमाल करके, एक से ज़्यादा वैल्यू सेट की जा सकती हैं. अगर पैरामीटर को बिना किसी वैल्यू के सेट किया जाता है, तो यह सभी व्यू को मिटा देगा.
• zoom: इससे मैप का ज़ूम करने का लेवल तय होता है.

इस उदाहरण यूआरएल में, न्यूयॉर्क पर फ़ोकस किया गया मैप दिखाया गया है. इसमें ज़ूम लेवल 14 है और ट्रैफ़िक की जानकारी दिख रही है:

comgooglemaps://?center=40.765819,-73.975866&zoom=14&views=traffic

यहां कुछ और उदाहरण दिए गए हैं:

comgooglemaps://?center=37.788463,-122.392545&zoom=12

comgooglemaps://?center=46.414382,10.013988&mapmode=streetview

खोजें

इस स्कीम का इस्तेमाल करके, खोज क्वेरी को व्यूपोर्ट की तय की गई जगह पर दिखाया जा सकता है.

पैरामीटर

Search, मैप दिखाने के लिए इस्तेमाल किए जाने वाले पैरामीटर के साथ-साथ q पैरामीटर का भी इस्तेमाल करता है.

• q: यह आपकी खोज के लिए क्वेरी स्ट्रिंग है.

इस उदाहरण में दिए गए यूआरएल का इस्तेमाल, बताई गई जगह के आस-पास “पिज़्ज़ा” खोजने के लिए किया जाता है:

comgooglemaps://?q=Pizza&center=37.759748,-122.427135

यहां कुछ और उदाहरण दिए गए हैं:

comgooglemaps://?q=Steamers+Lane+Santa+Cruz,+CA&center=37.782652,-122.410126&views=satellite,traffic&zoom=15

comgooglemaps://?q=Google+Japan,+Minato,+Tokyo,+Japan&center=35.660888,139.73073&zoom=15&views=transit

दिशा-निर्देश दिखाना

इस स्कीम का इस्तेमाल करके, दो जगहों के बीच के रास्ते की जानकारी का अनुरोध किया जा सकता है और उसे दिखाया जा सकता है. यात्रा का साधन भी बताया जा सकता है.

पैरामीटर

• saddr: यह विकल्प, दिशा-निर्देशों के लिए की जाने वाली खोजों के यात्रा शुरू करने की जगह को सेट करता है. यह अक्षांश,देशांतर या क्वेरी के हिसाब से फ़ॉर्मैट किया गया पता हो सकता है. अगर यह एक क्वेरी स्ट्रिंग है, जो एक से ज़्यादा नतीजे दिखाती है, तो पहले नतीजे को चुना जाएगा. अगर वैल्यू को खाली छोड़ दिया जाता है, तो उपयोगकर्ता की मौजूदा जगह की जानकारी का इस्तेमाल किया जाएगा.
• daddr: इससे दिशा-निर्देशों के लिए खोजों का नेविगेशन खत्म होने की जगह सेट किया जाता है. इसका फ़ॉर्मैट और व्यवहार, saddr जैसा ही होता है.
• directionsmode: परिवहन का तरीका. इसे driving, transit, bicycling या walking पर सेट किया जा सकता है.

उदाहरण के तौर पर दिए गए यूआरएल में, Google NYC और JFK एयरपोर्ट के बीच बस, मेट्रो वगैरह से जाने का तरीका दिखाया गया है:

comgooglemaps://?saddr=Google+Inc,+8th+Avenue,+New+York,+NY&daddr=John+F.+Kennedy+International+Airport,+Van+Wyck+Expressway,+Jamaica,+New+York&directionsmode=transit

यहां कुछ और उदाहरण दिए गए हैं:

comgooglemaps://?saddr=Google,+1600+Amphitheatre+Parkway,+Mountain+View,+CA+94043&daddr=Google+Inc,+345+Spear+Street,+San+Francisco,+CA&center=37.422185,-122.083898&zoom=10

comgooglemaps://?saddr=2025+Garcia+Ave,+Mountain+View,+CA,+USA&daddr=Google,+1600+Amphitheatre+Parkway,+Mountain+View,+CA,+United+States&center=37.423725,-122.0877&directionsmode=walking&zoom=17

अपने ऐप्लिकेशन में नेविगेशन की सुविधा जोड़ना

रास्ते के दिशा-निर्देशों के अनुरोध के साथ iOS के लिए Google Maps ऐप्लिकेशन लॉन्च करने से, आपके ऐप्लिकेशन के उपयोगकर्ताओं को रास्ते के दिशा-निर्देशों की सुविधा मिलती है. इसके लिए, comgooglemaps:// यूआरएल स्कीम का इस्तेमाल किया जा सकता है.

Google Maps के डेस्कटॉप यूआरएल से, iOS के लिए Google Maps ऐप्लिकेशन लॉन्च करना

अगर आपके ऐप्लिकेशन के पास पहले से मौजूद Google Maps के यूआरएल का ऐक्सेस है, जैसे कि किसी वेब पेज या डेटाबेस पर, तो इस स्कीम का इस्तेमाल करके, iOS के लिए Google Maps ऐप्लिकेशन में यूआरएल खोला जा सकता है. इससे आपके उपयोगकर्ताओं को मोबाइल पर बेहतरीन अनुभव मिलेगा.

• http:// या https:// स्कीम को comgooglemapsurl:// से बदलें.

Google Maps पर काम करने वाले यूआरएल फ़ॉर्मैट

comgooglemapsurl:// स्कीम, इस रेगुलर एक्सप्रेशन से मेल खाने वाले यूआरएल के साथ काम करती है. इसमें {TLD} का मतलब, देश के किसी भी मान्य टॉप-लेवल डोमेन से है. लाइन ब्रेक को साफ़ तौर पर दिखाने के लिए जोड़ा गया है:

(http(s?)://)?
((maps\.google\.{TLD}/)|
 ((www\.)?google\.{TLD}/maps/)|
 (goo.gl/maps/))
.*

Google Maps ऐप्लिकेशन की उपलब्धता की जांच करना

सबसे पहले, पुष्टि करें कि iOS के लिए Google Maps ऐप्लिकेशन, डिवाइस पर उपलब्ध है. साथ ही, यह यूआरएल स्कीम के साथ काम करता है:

UIApplication.shared.canOpenURL(URL(string:"comgooglemapsurl://")!)

[[UIApplication sharedApplication] canOpenURL:
   [NSURL URLWithString:@"comgooglemapsurl://"]];

उदाहरण

Google Maps के सामान्य यूआरएल का उदाहरण:

Google Maps का ओरिजनल यूआरएल:

https://www.google.com/maps/preview/@42.585444,13.007813,6z

यूआरएल स्कीम का इस्तेमाल करके:

comgooglemapsurl://www.google.com/maps/preview/@42.585444,13.007813,6z

Google Maps के सामान्य यूआरएल का उदाहरण:

Google Maps का ओरिजनल यूआरएल:

https://maps.google.com/?q=@37.3161,-122.1836

यूआरएल स्कीम का इस्तेमाल करके:

comgooglemapsurl://maps.google.com/?q=@37.3161,-122.1836