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 मैप ऐप्लिकेशन निम्न URL का समर्थन करता है स्कीम:

• comgooglemaps:// और comgooglemaps-x-callback:// - ये स्कीम आपको iOS के लिए Google Maps ऐप्लिकेशन लॉन्च करने और कई में से कोई एक काम करने की सुविधा देता है कार्रवाइयां:

  • किसी खास जगह और ज़ूम लेवल पर मैप दिखाएं.
  • जगहें या लोकेशन खोजें और उन्हें मैप पर दिखाएं.
  • एक जगह से दूसरी जगह जाने का रास्ता पूछना. यात्रा के चार साधनों के लिए निर्देश मिल सकते हैं: ड्राइविंग, पैदल, साइकल और सार्वजनिक परिवहन.
  • अपने ऐप्लिकेशन में नेविगेशन जोड़ें.
  • iOS 8 के ज़रिए, ऐप्लिकेशन पूरा होने के बाद कॉलबैक जारी करें. इसके लिए, comgooglemaps-x-callback://. कॉलबैक का इस्तेमाल अक्सर इन कामों के लिए किया जाता है उपयोगकर्ता को उस ऐप्लिकेशन पर वापस भेजता है, जिसने मूल रूप से iOS के लिए Google Maps खोला था. ध्यान दें कि iOS 9 पर, सिस्टम अपने आप "बैक टू" लिंक के बाएं कोने में स्टेटस बार पर क्लिक करें.

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

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

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

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

comgooglemaps://?parameters

या:

comgooglemaps-x-callback://?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: आपकी खोज के लिए क्वेरी स्ट्रिंग.

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

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.

उदाहरण URL 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

कॉलबैक यूआरएल की जानकारी देना

अगर आप कॉलबैक यूआरएल तय करना चाहते हैं, तो आपको comgooglemaps-x-callback:// यूआरएल स्कीम. यह स्कीम, x-callback-url स्पेसिफ़िकेशन का पालन करती है. जब आप iOS के लिए Google मैप ऐप्लिकेशन को कॉल करते हैं इस स्कीम का इस्तेमाल करने पर, ऐप्लिकेशन सबसे ऊपर एक बटन दिखाएगा. स्क्रीन. इस बटन पर टैप करने से, आपके बताए गए यूआरएल पर कॉलबैक भेजा जाएगा.

comgooglemaps-x-callback:// के लिए किए गए अनुरोध इस तरह के होने चाहिए:

comgooglemaps-x-callback://?parameters

पैरामीटर

x-callback यूआरएल स्कीम, comgooglemaps:// यूआरएल स्कीम के जैसे ही पैरामीटर स्वीकार करता है. साथ ही, इन अतिरिक्त पैरामीटर को भी स्वीकार करता है. दोनों पैरामीटर ज़रूरी हैं.

• x-source — x-कॉलबैक भेजने वाले ऐप्लिकेशन का नाम अनुरोध. छोटे नामों का इस्तेमाल करना बेहतर होता है.
• x-success — पूरा होने पर कॉल किया जाने वाला यूआरएल. अक्सर ऐसा होगा आपके ऐप्लिकेशन के लिए एक यूआरएल स्कीम होनी चाहिए. इससे लोग, ओरिजनल ऐप्लिकेशन पर वापस जा सकते हैं का इस्तेमाल करें.

ध्यान रखें कि आपके ऐप्लिकेशन को अपनी यूआरएल स्कीम रजिस्टर करनी होगी, ताकि वह कॉलबैक यूआरएल का जवाब दें.

1. पक्का करें कि आपके ऐप्लिकेशन ने ऐसा यूआरएल स्कीम रजिस्टर किया हो जो कॉलबैक अनुरोध का जवाब दे सके.
2. x-source पैरामीटर में कॉलबैक बटन का लेबल पास करें.
3. x-success पैरामीटर में कॉलबैक यूआरएल पास करें.

नीचे दिए गए उदाहरण में, iOS के लिए Google Maps ऐप्लिकेशन लॉन्च किया जाएगा और मैप दिखाया जाएगा पर आधारित है. ऐप्लिकेशन में "SourceApp" लेबल वाला बटन भी दिखेगा. "SourceApp" बटन पर क्लिक करने पर, iOS के लिए Google Maps ऐप्लिकेशन, sourceapp://?resume=true नाम के यूआरएल स्कीम पर कॉलबैक जारी करेगा.

comgooglemaps-x-callback://?center=40.765819,-73.975866&zoom=14
   &x-success=sourceapp://?resume=true
   &x-source=SourceApp

comgooglemaps:// यूआरएल स्कीम की तरह ही, आपको पहले यह पुष्टि करनी चाहिए कि डिवाइस पर iOS के लिए Google Maps ऐप्लिकेशन उपलब्ध है और वह x-callback यूआरएल स्कीम के साथ काम करता है. आपका ऐप्लिकेशन इस कोड की मदद से यह पता लगा सकता है कि यूआरएल स्कीम उपलब्ध है या नहीं:

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

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

यह ऐसे यूआरएल का उदाहरण है जिससे उपयोगकर्ता, डेज़र्ट खोजने के बाद ऐप्लिकेशन पर वापस आ सकते हैं.

comgooglemaps-x-callback://?q=dessert&center=37.759748,-122.427135
   &x-success=sourceapp://?resume=true
   &x-source=Nom+Nom

आपके ऐप्लिकेशन में नेविगेशन किया जा रहा है

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

इस कोड स्निपेट में, comgooglemaps-x-callback:// स्कीम इस्तेमाल करने का तरीका बताया गया है निर्देशों का अनुरोध करें और जब आपका उपयोगकर्ता तैयार हो, तो अपने ऐप्लिकेशन पर वापस आ जाएं. कॉन्टेंट बनाने कोड ये काम करेगा:

1. पुष्टि करें कि comgooglemaps-x-callback:// यूआरएल स्कीम उपलब्ध है.
2. iOS के लिए Google Maps ऐप्लिकेशन लॉन्च करें और JFK हवाई अड्डे आने-जाने के लिए निर्देशों का अनुरोध करें दिल्ली. यहां से निर्देशों का अनुरोध करने के लिए, शुरुआती पते को खाली छोड़ दें उपयोगकर्ता की मौजूदा जगह की जानकारी.
3. "AirApp" लेबल वाला बटन जोड़ें Android के लिए Google Maps ऐप्लिकेशन में बदल सकते हैं. बटन के लेबल को x-source पैरामीटर से तय किया जाता है.
4. जब उपयोगकर्ताsourceapp:// 'वापस जाएं' बटन.

let testURL = URL(string: "comgooglemaps-x-callback://")!
if UIApplication.shared.canOpenURL(testURL) {
  let directionsRequest = "comgooglemaps-x-callback://" +
    "?daddr=John+F.+Kennedy+International+Airport,+Van+Wyck+Expressway,+Jamaica,+New+York" +
    "&x-success=sourceapp://?resume=true&x-source=AirApp"

  let directionsURL = URL(string: directionsRequest)!
  UIApplication.shared.openURL(directionsURL)
} else {
  NSLog("Can't use comgooglemaps-x-callback:// on this device.")
}

NSURL *testURL = [NSURL URLWithString:@"comgooglemaps-x-callback://"];
if ([[UIApplication sharedApplication] canOpenURL:testURL]) {
  NSString *directionsRequest = @"comgooglemaps-x-callback://" +
      @"?daddr=John+F.+Kennedy+International+Airport,+Van+Wyck+Expressway,+Jamaica,+New+York" +
      @"&x-success=sourceapp://?resume=true&x-source=AirApp";
  NSURL *directionsURL = [NSURL URLWithString:directionsRequest];
  [[UIApplication sharedApplication] openURL:directionsURL];
} else {
  NSLog(@"Can't use comgooglemaps-x-callback:// on this device.");
}

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

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

1. http:// या https:// स्कीम को comgooglemapsurl:// से बदलें.
2. अगर आपको कॉलबैक का इस्तेमाल करना है, तो x-source और x-success पैरामीटर शामिल करें. यह स्कीम, x-callback-url स्पेसिफ़िकेशन का पालन करती है.

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:"comgooglemaps-x-callback://")!)

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

x-callback की मदद से, टोक्यो टावर तक पहुंचने के लिए निर्देश का अनुरोध करने का उदाहरण:

Google Maps का मूल यूआरएल:

http://maps.google.com/maps?f=d&daddr=Tokyo+Tower,+Tokyo,+Japan&sll=35.6586,139.7454&sspn=0.2,0.1&nav=1

इस उदाहरण में, iOS के लिए Google Maps ऐप्लिकेशन लॉन्च होगा और Tokyo Tower के निर्देशों वाला मैप दिखेगा. यह मैप, ऊपर दिए गए Google Maps के मूल यूआरएल में बताए गए निर्देशों के मुताबिक दिखेगा. ऐप्लिकेशन पर एक बटन भी दिखेगा, जिस पर "SourceApp" चुनें. "SourceApp" बटन पर क्लिक करने पर, iOS के लिए Google Maps ऐप्लिकेशन, sourceapp://?resume=true नाम के यूआरएल स्कीम पर कॉलबैक जारी करेगा.

comgooglemapsurl://maps.google.com/maps?f=d&daddr=Tokyo+Tower,+Tokyo,+Japan&sll=35.6586,139.7454&sspn=0.2,0.1&nav=1
    &x-source=SourceApp
    &x-success=sourceapp://?resume=true