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

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

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

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

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

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

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

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

Swift

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

Objective-C

[[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 ऐप्लिकेशन की उपलब्धता देखना

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

Swift

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

Objective-C

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

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

Swift

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://");
}

Objective-C

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 और जेएफ़के एयरपोर्ट के बीच बस, मेट्रो वगैरह के रास्ते के लिए निर्देश दिखाए गए हैं:

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 ऐप्लिकेशन, डिवाइस पर उपलब्ध है और यूआरएल स्कीम के साथ काम करता है:

Swift

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

Objective-C

[[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