কিভাবে Waze Deep Links ব্যবহার করবেন

Waze একটি API সমর্থন করে, যা ডেভেলপারদের একটি বাহ্যিক URL-এর মাধ্যমে Waze ক্লায়েন্ট অ্যাপ্লিকেশন বা ওয়েব পেজ খোলার সুযোগ দেয়। এই URL-টি অন্য কোনো মোবাইল অ্যাপ্লিকেশন বা মোবাইল ওয়েব পেজের ভেতর থেকেও অ্যাক্সেস করা যায়।

Waze Deep Links ব্যবহার করার জন্য মূল URL-টি হলো:

https://waze.com/ul

আপনি এই URL-এ যে প্যারামিটারগুলো পাঠাবেন, তার উপর ভিত্তি করে Waze অ্যাপ্লিকেশনটি তখন একটি ঠিকানা খুঁজে বের করতে, মানচিত্রে ঠিকানাটি চিহ্নিত করতে, অথবা কোনো ঠিকানা বা গন্তব্যে নেভিগেশন সেশন শুরু করতে পারে।

ডিপ লিঙ্ক কীভাবে কাজ করে

Waze ক্লায়েন্ট অ্যাপ হিসেবে খুলবে নাকি ওয়েব পেজ হিসেবে, তা ব্যবহারকারীর সিস্টেম কনফিগারেশনের উপর নির্ভর করে:

  • ডেস্কটপ : Waze একটি ওয়েব পেজ হিসেবে খোলে।
  • মোবাইল ডিভাইস (এবং Waze অ্যাপ ইনস্টল করা আছে): Waze অ্যাপটি খোলে।
  • মোবাইল ডিভাইস (এবং Waze ইনস্টল করা নেই): Waze একটি ওয়েব পেজ হিসেবে খোলে।

আপনি যদি নিশ্চিত হন যে Waze অ্যাপটি ইনস্টল করা আছে, তাহলে ওয়েব অভিজ্ঞতা ছাড়াই অ্যাপ-টু-অ্যাপ যোগাযোগের জন্য আপনি 'waze://' ইউআরএলটি ব্যবহার করতে পারেন। এটি উপরে বর্ণিত মূল ইউআরএলটির পরিবর্তে ব্যবহৃত হয়। এই বিকল্পটি কেবল তখনই ব্যবহার করুন যখন আপনি নিশ্চিত হন যে আপনার ব্যবহারকারীদের সিস্টেমে Waze ইনস্টল করা আছে; অন্যথায়, ব্যবহারকারীরা লিঙ্কটিতে ট্যাপ করলে কিছুই ঘটবে না।

Waze Deep Links ব্যবহার করুন

আপনি কোনো থার্ড-পার্টি অ্যাপ, ইমেল, এসএমএস, ওয়েব পেজের লিঙ্ক বা অন্য কোনো উৎস থেকে প্যারামিটারসহ Waze চালু করতে নিম্নলিখিত URL-টি ব্যবহার করতে পারেন।

Waze Deep Links নিম্নলিখিত URL ব্যবহার করে:

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

নিচে Waze Deep Links-এর কয়েকটি সাধারণ কাজ উল্লেখ করা হলো।

কোনো নির্দিষ্ট স্থানে যেতে:

  1. Waze Live Map খুলুন এবং আপনার অবস্থান অনুসন্ধান করুন। সার্চ বক্সে টাইপ করুন অথবা জুম ইন করে ম্যাপের একটি নির্দিষ্ট অংশে ক্লিক করুন।
  2. শেয়ার আইকনে ক্লিক করুন মানচিত্রের নীচের ডান কোণায়।
  3. একটি ডায়ালগ বক্স আসবে। ‘Share driving directions’- এ ক্লিক করুন, তারপর লিঙ্কটি কপি করে পেস্ট করুন।

উদাহরণ

নিম্নলিখিত উদাহরণটি মানচিত্রটিকে নিউ ইয়র্কের টাইমস স্কোয়ারে কেন্দ্র করে:

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

আপনি Waze অ্যাপে সংরক্ষিত নিম্নলিখিত পছন্দের স্থানগুলিতে যেতে পারেন:

  • work
  • home

নির্দিষ্ট পছন্দের জায়গায় যেতে নিম্নলিখিত URL-টি ব্যবহার করুন:

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

নিম্নলিখিত উদাহরণটি কাজের জন্য গন্তব্য নির্ধারণ করে:

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

নিম্নলিখিত সিনট্যাক্স ব্যবহার করে একটি ঠিকানা অনুসন্ধান করুন:

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

প্যারামিটার হিসেবে আপনি যে মানগুলো দেবেন, সেগুলো অবশ্যই URL-এনকোড করা থাকতে হবে। উদাহরণস্বরূপ, আপনাকে স্পেসের পরিবর্তে %20 ব্যবহার করতে হবে।

নিম্নলিখিত উদাহরণটি "66 Acacia Avenue" অনুসন্ধান করে:

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

মানচিত্রে দেখান

Waze ম্যাপ ভিউয়ের বিবর্ধন স্তর (বা জুম ) সেট করতে নিম্নলিখিত সিনট্যাক্সটি ব্যবহার করুন:

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

magnification_level এর সর্বনিম্ন মান হলো ৬ (সবচেয়ে কাছের বা সর্বোচ্চ বিবর্ধন)। magnification_level এর সর্বোচ্চ মান হলো ৮১৯২ (সবচেয়ে দূরের বা সর্বনিম্ন বিবর্ধন)।

নিম্নলিখিত উদাহরণটি বিবর্ধন স্তর ৮-এ সেট করে:

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

প্যারামিটার একত্রিত করুন

আপনি নেম-ভ্যালু পেয়ারগুলোকে একটি "&" দিয়ে আলাদা করে একই URL-এ প্যারামিটারগুলো একসাথে ব্যবহার করতে পারেন। নিচের উদাহরণগুলোতে প্যারামিটারগুলোর বিভিন্ন সংমিশ্রণ কীভাবে ব্যবহার করতে হয় তা দেখানো হয়েছে:

  • মেরিহিলের উপর মানচিত্রটি কেন্দ্র করতে এবং ১০ পর্যন্ত জুম করতে: 

    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 উদাহরণটি দেখুন। আপনি যদি কোনো সমস্যার সম্মুখীন হন, তাহলে নির্দ্বিধায় আমাদের সাথে যোগাযোগ করুন ।

উদাহরণ

এই বিভাগে অ্যান্ড্রয়েড এবং আইওএস প্ল্যাটফর্মে কীভাবে Waze Deep Links API ব্যবহার করতে হয় তার উদাহরণ দেওয়া হয়েছে।

অ্যান্ড্রয়েড উদাহরণ

নিম্নলিখিত কোড স্নিপেট উদাহরণটি, যদি 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 ইনস্টল করার জন্য অ্যাপ স্টোর চালু করে: 

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