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 Live Map खोलें और अपनी जगह की जानकारी खोजें. खोज बॉक्स में टाइप करें या ज़ूम इन करके, मैप के किसी खास सेगमेंट पर क्लिक करें.
- मैप के सबसे नीचे दाएं कोने में मौजूद, शेयर करें आइकॉन
पर क्लिक करें. - आपको एक डायलॉग दिखेगा. ड्राइविंग के दिशा-निर्देश शेयर करें पर क्लिक करें. इसके बाद, लिंक को कॉपी करें और चिपकाएं.
उदाहरण
यहां दिए गए उदाहरण में, मैप को न्यूयॉर्क के टाइम्स स्क्वेयर पर फ़ोकस किया गया है:
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 से बदलना होगा.
यहां दिए गए उदाहरण में, "66 Acacia Avenue" खोजा गया है:
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 Deep Links API का इस्तेमाल करने के उदाहरण दिए गए हैं.
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 इंस्टॉल है, तो यह lat/lon पर ले जाता है. अगर 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>