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[¶m_name=value]
यहां Waze के डीप लिंक से जुड़े कुछ सामान्य टास्क दिए गए हैं.
किसी जगह पर नेविगेट करना
किसी खास जगह पर नेविगेट करने के लिए:
- Waze का लाइव मैप खोलें और अपनी जगह खोजें. खोज बॉक्स में टाइप करें या ज़ूम इन करें और मैप के किसी खास सेगमेंट पर क्लिक करें.
- मैप के निचले दाएं कोने में मौजूद, शेयर करें आइकॉन
पर क्लिक करें. - आपको एक डायलॉग दिखेगा. ड्राइविंग के दिशा-निर्देश शेयर करें पर क्लिक करें. इसके बाद, लिंक को कॉपी करके चिपकाएं.
उदाहरण
इस उदाहरण में, मैप को न्यूयॉर्क के टाइम्स स्क्वेयर पर सेंटर किया गया है:
https://www.waze.com/ul?ll=40.75889500%2C-73.98513100&navigate=yes&zoom=17
पसंदीदा जगह पर नेविगेट करना
Waze ऐप्लिकेशन में सेव की गई इन पसंदीदा जगहों पर नेविगेट किया जा सकता है:
workhome
किसी पसंदीदा जगह पर नेविगेट करने के लिए, इस यूआरएल का इस्तेमाल करें:
https://waze.com/ul?favorite=favorite&navigate=yes
इस उदाहरण में, डेस्टिनेशन को काम करने की जगह पर सेट किया गया है:
https://waze.com/ul?favorite=work&navigate=yes
खोजें
इस सिंटैक्स का इस्तेमाल करके, कोई पता खोजें:
https://waze.com/ul?q=search_terms
पैरामीटर के लिए पास की गई वैल्यू को कोड में बदलना ज़रूरी है. उदाहरण के लिए, आपको
स्पेस को %20 से बदलना होगा.
इस उदाहरण में, "हाई स्ट्रीट" खोजा गया है:
https://waze.com/ul?q=66%20Acacia%20Avenue
मैप पर दिखाएं
Waze के मैप व्यू के मैग्निफ़िकेशन लेवल (या ज़ूम) को सेट करने के लिए, इस सिंटैक्स का इस्तेमाल करें:
https://waze.com/ul?z=magnification_level
magnification_level की कम से कम वैल्यू 6 होती है. इसका मतलब है कि मैप सबसे ज़्यादा ज़ूम इन होगा. magnification_level की ज़्यादा से ज़्यादा वैल्यू 8192 होती है. इसका मतलब है कि मैप सबसे ज़्यादा ज़ूम आउट होगा.
इस उदाहरण में, मैग्निफ़िकेशन लेवल को 8 पर सेट किया गया है:
https://waze.com/ul?z=8
यूआरएल पैरामीटर
इस टेबल में, Waze के डीप लिंक के लिए उपलब्ध राउटिंग पैरामीटर की जानकारी दी गई है:
| पैरामीटर | ज़रूरी है? | ब्यौरा |
|---|---|---|
avoid_tolls |
वैकल्पिक | इससे यह तय होता है कि टोल से बचने वाला रूट कैलकुलेट करना है या नहीं. टोल से बचने के लिए, इसे true या t पर सेट करें. टोल वाले रास्ते की अनुमति देने के लिए, इसे false या f पर सेट करें. डिफ़ॉल्ट रूप से, टोल की अनुमति दी जाती है (false). |
avoid_ferries |
वैकल्पिक | इससे यह तय होता है कि फ़ेरी से बचने वाला रूट कैलकुलेट करना है या नहीं. फ़ेरी से बचने के लिए, इसे true या t पर सेट करें. फ़ेरी की अनुमति देने के लिए, इसे false या f पर सेट करें. डिफ़ॉल्ट रूप से, फ़ेरी की अनुमति दी जाती है (false). |
avoid_freeways |
वैकल्पिक | इससे यह तय होता है कि फ़्रीवे से बचने वाला रूट कैलकुलेट करना है या नहीं. फ़्रीवे से बचने के लिए, इसे true या t पर सेट करें. फ़्रीवे की अनुमति देने के लिए, इसे false या f पर सेट करें. डिफ़ॉल्ट रूप से, फ़्रीवे की अनुमति दी जाती है (false). |
avoid_dangerous_turns |
वैकल्पिक | इससे यह तय होता है कि खतरनाक मोड़ से बचना है या नहीं. खतरनाक मोड़ से बचने के लिए, इसे true या t पर सेट करें. खतरनाक मोड़ की अनुमति देने के लिए, इसे false या f पर सेट करें. डिफ़ॉल्ट रूप से, खतरनाक मोड़ से बचा जाता है (true). |
avoid_trails |
वैकल्पिक |
इससे, पक्की सड़कों या पगडंडियों के लिए राउटिंग की प्राथमिकताएं तय होती हैं. इन वैल्यू का इस्तेमाल किया जा सकता है:
|
vehicle_type |
वैकल्पिक |
इससे, वाहन का टाइप तय होता है. इन वैल्यू का इस्तेमाल किया जा सकता है:
|
पैरामीटर जोड़ना
नाम-वैल्यू पेयर को "&" से अलग करके, पैरामीटर को एक ही यूआरएल में इस्तेमाल किया जा सकता है. यहां दिए गए उदाहरणों में, पैरामीटर के कॉम्बिनेशन इस्तेमाल करने का तरीका बताया गया है:
मैप को मैरीहिल पर सेंटर करने और 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 इंस्टॉल नहीं है, तो यह 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 और इसके बाद के वर्शन के साथ कंपाइल करते समय, Waze को शामिल करने के लिए, आपको अपने ऐप्लिकेशन की प्रॉपर्टी की सूची वाली फ़ाइल को इससे अपडेट करना होगा:
<key>LSApplicationQueriesSchemes</key> <array> <string>waze</string> </array>