Waze डीप लिंक इस्तेमाल करने का तरीका

Waze ऐसे एपीआई के साथ काम करता है जिसकी मदद से डेवलपर, Waze क्लाइंट ऐप्लिकेशन या वेब पेज को बाहरी यूआरएल के ज़रिए खोल सकते हैं. यूआरएल को किसी दूसरे मोबाइल ऐप्लिकेशन या मोबाइल वेब पेज से ऐक्सेस किया जा सकता है.

Waze डीप लिंक इस्तेमाल करने के लिए बेस यूआरएल यह है:

https://waze.com/ul

इसके बाद, Waze ऐप्लिकेशन, इस यूआरएल पर भेजे गए पैरामीटर के आधार पर किसी पते का पता लगा सकता है. मैप पर कोई पता मार्क कर सकता है. इसके अलावा, वह पता या डेस्टिनेशन के लिए नेविगेशन सेशन भी शुरू कर सकता है.

डीप लिंक कैसे काम करते हैं

Waze को ऐप्लिकेशन के तौर पर या वेब पेज के तौर पर खोला जा सकता है, यह उपयोगकर्ता के सिस्टम कॉन्फ़िगरेशन पर निर्भर करता है:

  • डेस्कटॉप: Waze एक वेब पेज के रूप में खुलता है.
  • मोबाइल डिवाइस (और Waze ऐप्लिकेशन इंस्टॉल है): Waze ऐप्लिकेशन खुलता है.
  • मोबाइल डिवाइस (और Waze इंस्टॉल नहीं है): Waze एक वेब पेज के तौर पर खुलता है.

अगर आपको वाकई यह पता है कि Waze ऐप्लिकेशन इंस्टॉल किया गया है, तो बिना किसी अनुभव के, वेब पर ऐप्लिकेशन भेजने के लिए, यूआरएल "waze://" का इस्तेमाल कर सकते हैं. यह ऊपर बताए गए बेस यूआरएल की जगह है. इस विकल्प का इस्तेमाल सिर्फ़ तब करें, जब आपको लगे कि आपके उपयोगकर्ताओं ने Waze इंस्टॉल किया है. नहीं तो, अगर उपयोगकर्ता लिंक पर टैप करते हैं, तो कुछ नहीं होता.

Waze डीप लिंक का इस्तेमाल करना

Waze को किसी तीसरे पक्ष के ऐप्लिकेशन, ईमेल, मैसेज (एसएमएस), वेब पेज के लिंक या दूसरे सोर्स के पैरामीटर के साथ लॉन्च करने के लिए, इस यूआरएल का इस्तेमाल किया जा सकता है.

Waze डीप लिंक इस यूआरएल का इस्तेमाल करता है:

https://waze.com/ul?param_name=value[&param_name=value]

Waze डीप लिंक से जुड़े कई टास्क यहां दिए गए हैं.

किसी खास जगह पर जाने के लिए:

  1. Waze Live Map खोलें और अपनी जगह की जानकारी खोजें. खोज बॉक्स में टाइप करें या ज़ूम इन करें. इसके बाद, मैप के किसी खास हिस्से पर क्लिक करें.
  2. मैप के निचले दाएं कोने में दिए गए 'शेयर करें' आइकॉन पर क्लिक करें.
  3. एक डायलॉग बॉक्स दिखेगा. ड्राइविंग दिशा निर्देश शेयर करें पर क्लिक करें. इसके बाद लिंक को कॉपी करके चिपकाएं.

उदाहरण

नीचे दिए गए उदाहरण में, मैप को न्यूयॉर्क के टाइम्स स्क्वेयर पर दिखाया गया है:

https://www.waze.com/ul?ll=40.75889500%2C-73.98513100&navigate=yes&zoom=17

आप Waze ऐप्लिकेशन में सेव इन विकल्पों पर जा सकते हैं:

  • work
  • home

नीचे दिए गए यूआरएल का इस्तेमाल करके किसी पसंदीदा पसंदीदा पर जाएं:

https://waze.com/ul?favorite=favorite&navigate=yes

नीचे दिए गए उदाहरण में काम करने का डेस्टिनेशन सेट किया गया है:

https://waze.com/ul?favorite=work&navigate=yes

नीचे दिए गए सिंटैक्स के साथ कोई पता खोजें:

https://waze.com/ul?q=search_terms

पैरामीटर के लिए पास की गई वैल्यू, यूआरएल के हिसाब से होनी चाहिए. उदाहरण के लिए, आपको ऐसे स्पेस को %20 से बदलना होगा.

नीचे दिए गए उदाहरण में "66 Acacia Avenue" के लिए खोज की गई है:

https://waze.com/ul?q=66%20Acacia%20Avenue

मैप पर दिखाएं

Waze के मैप व्यू में, मैप को ज़ूम करने का लेवल (या ज़ूम) सेट करने के लिए, नीचे दिए गए सिंटैक्स का इस्तेमाल करें:

https://waze.com/ul?z=magnification_level

magnification_level के लिए कम से कम वैल्यू छह होनी चाहिए. यह सबसे ज़्यादा या सबसे बड़ा होना चाहिए. magnification_level के लिए ज़्यादा से ज़्यादा वैल्यू 8192 (सबसे लंबी या सबसे कम ज़ूम करने की सुविधा) है.

नीचे दिए गए उदाहरण में, ज़ूम करने की सुविधा को 8 पर सेट किया गया है:

https://waze.com/ul?z=8

पैरामीटर जोड़ें

पैरामीटर में, नाम और वैल्यू के जोड़े को &"" के साथ अलग करके, एक ही यूआरएल में पैरामीटर का इस्तेमाल किया जा सकता है. नीचे दिए गए उदाहरणों में बताया गया है कि पैरामीटर के कॉम्बिनेशन का इस्तेमाल कैसे करें:

  • मैप को मैरीहिल पर केंद्रित करने के लिए 10 पर ज़ूम करें:

    https://waze.com/ul?ll=45.6906304,-120.810983&z=10

  • किसी पते को खोजने के लिए, उस पते पर जाएं:

    https://waze.com/ul?q=66%20Acacia%20Avenue&ll=45.6906304,-120.810983&navigate=yes

utm_source शामिल करें

अगर लागू करने की प्रक्रिया में utm_source को शामिल किया जाता है, तो हम इसके इस्तेमाल को कुछ खास पार्टनर के साथ जोड़ सकते हैं. अगर इंटिग्रेशन से जुड़ी किसी समस्या का असर पड़ता है, तो utm_source की मदद से हम पार्टनर से संपर्क कर पाते हैं और पार्टनर को बेहतर अनुभव दे पाते हैं. ज़्यादा जानकारी के लिए, iOS का उदाहरण देखें. अगर आपको कोई समस्या आती है, तो बेझिझक हमसे संपर्क करें.

उदाहरण

इस सेक्शन में Android और iOS प्लैटफ़ॉर्म पर Waze डीप लिंक एपीआई के इस्तेमाल का तरीका बताया गया है.

Android का उदाहरण

नीचे दिए गए कोड स्निपेट का उदाहरण है, अगर Waze इंस्टॉल है, तो बताई गई जगह का पता लगाने के लिए Waze लॉन्च करता है. अगर Waze इंस्टॉल नहीं किया गया है, तो इससे Google Play में Waze पेज खुलता है:

try {
  // Launch Waze to look for Hawaii:
  String url = "https://waze.com/ul?q=Hawaii";
  Intent intent = new Intent(Intent.ACTION_VIEW, Uri.parse(url));
  startActivity(intent);
} catch (ActivityNotFoundException ex) {
  // If Waze is not installed, open it in Google Play:
  Intent intent = new Intent(Intent.ACTION_VIEW, Uri.parse("market://details?id=com.waze"));
  startActivity(intent);
}

iOS का उदाहरण

Waze के इंस्टॉल होने पर, नीचे दिया गया कोड स्निपेट का उदाहरण लैटिन/देशांतर में नेविगेट करता है; नहीं तो, यह Waze इंस्टॉल करने के लिए App Store लॉन्च करता है:

- (void) navigateToLatitude:(double)latitude longitude:(double)longitude
{
  if ([[UIApplication sharedApplication]
    canOpenURL:[NSURL URLWithString:@"waze://"]]) {
      NSString *bundleIdentifier = NSBundle.mainBundle.bundleIdentifier;
      // Waze is installed. Launch Waze and start navigation
      NSString *urlStr =
        [NSString stringWithFormat:@"https://waze.com/ul?ll=%f,%f&navigate=yes&utm_source=%s",
        latitude, longitude, bundleIdentifier];
      [[UIApplication sharedApplication] openURL:[NSURL URLWithString:urlStr]];
  } else {
    // Waze is not installed. Launch AppStore to install Waze app
    [[UIApplication sharedApplication] openURL:[NSURL
      URLWithString:@"http://itunes.apple.com/us/app/id323229106"]];
  }
}

iOS SDK 9.0 और उसके बाद के वर्शन के साथ कंपाइल करने पर, आपको अपने ऐप्लिकेशन की प्रॉपर्टी की सूची फ़ाइल को अपडेट करके, इनमें ये शामिल करने होंगे:

<key>LSApplicationQueriesSchemes</key>
<array>
  <string>waze</string>
</array>