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

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

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

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

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 ऐप्लिकेशन लॉन्च किया जा सकता है या वेब ऐप्लिकेशन होना चाहिए. आप URL में विकल्प सेट कर सकते हैं, जिसे ऐप्लिकेशन लॉन्च किया गया. 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 रीडायरेक्शन यूआरएल भी पास करने का विकल्प होता है.
    • x-source और x-success का इस्तेमाल करके, कॉलबैक जारी किया जा सकता है comgooglemapsurl:// यूआरएल स्कीम वाले पैरामीटर.

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

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

comgooglemaps://?parameters

या:

comgooglemaps-x-callback://?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: इससे मैप का ज़ूम लेवल पता चलता है.

यह उदाहरण URL, न्यूयॉर्क के केंद्र में ज़ूम 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.

उदाहरण के तौर पर दिया गया यूआरएल, 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 URL स्कीम वही पैरामीटर स्वीकार करती है जो 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 URL स्कीम. आपका ऐप्लिकेशन यह देख सकता है कि यूआरएल स्कीम उपलब्ध है या नहीं कोड का इस्तेमाल करें:

Swift

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

Objective-C

[[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 ऐप्लिकेशन लॉन्च करना, इससे उपयोगकर्ता आपके ऐप्लिकेशन के मोड़-दर-मोड़ नेविगेशन का ऐक्सेस कर सकते हैं. इस्तेमाल करने के लिए 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:// 'वापस जाएं' बटन.

Swift

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.")
}

Objective-C

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

Swift

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

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

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 ऐप्लिकेशन लॉन्च किया जाएगा और मैप दिखाया जाएगा के निर्देशों के साथ, जैसा कि मूल Google मैप URL में बताया गया है (ऊपर). ऐप्लिकेशन पर एक बटन भी दिखेगा, जिस पर "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