نحوه استفاده از Waze Deep Links

ویز از یک رابط برنامه‌نویسی کاربردی (API) پشتیبانی می‌کند که به توسعه‌دهندگان امکان می‌دهد برنامه‌ی کلاینت ویز یا صفحه‌ی وب آن را از طریق یک URL خارجی باز کنند. این URL را می‌توان از درون یک برنامه‌ی موبایل دیگر یا یک صفحه‌ی وب موبایل مشاهده کرد.

آدرس اینترنتی (URL) پایه برای استفاده از Waze Deep Links به صورت زیر است:

https://waze.com/ul

سپس برنامه Waze می‌تواند بر اساس پارامترهایی که به این URL ارسال می‌کنید، یک آدرس را پیدا کند، آن را روی نقشه علامت‌گذاری کند یا یک جلسه ناوبری به سمت یک آدرس یا مقصد را آغاز کند.

نحوه عملکرد لینک‌های عمیق

اینکه Waze به عنوان یک برنامه کلاینت یا یک صفحه وب باز شود، به پیکربندی سیستم کاربر بستگی دارد:

  • دسکتاپ : ویز به صورت یک صفحه وب باز می‌شود.
  • دستگاه تلفن همراه (و برنامه Waze نصب شده است): برنامه Waze باز می‌شود.
  • دستگاه همراه (و Waze نصب نشده باشد): Waze به صورت یک صفحه وب باز می‌شود.

اگر مطمئن هستید که برنامه Waze نصب شده است، می‌توانید از آدرس اینترنتی "waze://" برای ارتباط بین برنامه‌ها بدون نیاز به وب استفاده کنید. این آدرس جایگزین آدرس اینترنتی اصلی است که در بالا توضیح داده شد. فقط در صورتی از این گزینه استفاده کنید که مطمئن هستید کاربران شما Waze را نصب کرده‌اند. در غیر این صورت، اگر کاربران روی لینک کلیک کنند، هیچ اتفاقی نمی‌افتد.

از لینک‌های عمیق Waze استفاده کنید

شما می‌توانید از آدرس اینترنتی زیر برای اجرای Waze با پارامترهایی از یک برنامه شخص ثالث، ایمیل، پیامک، لینک صفحه وب یا منبع دیگر استفاده کنید.

لینک‌های عمیق Waze از آدرس اینترنتی زیر استفاده می‌کنند:

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

در ادامه تعدادی از وظایف رایج Waze Deep Links آمده است.

برای رفتن به یک مکان خاص:

  1. نقشه زنده Waze را باز کنید و مکان خود را جستجو کنید. یا در کادر جستجو تایپ کنید یا بزرگنمایی کنید و روی بخش خاصی از نقشه کلیک کنید.
  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

مقادیری که برای پارامترها ارسال می‌کنید باید با 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 واحد، از آنها با هم استفاده کنید. مثال‌های زیر نحوه استفاده از ترکیب پارامترها را نشان می‌دهند:

  • برای قرار دادن نقشه در مرکز Maryhill و بزرگنمایی تا 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 مراجعه کنید. در صورت بروز هرگونه مشکل، با ما تماس بگیرید .

مثال‌ها

این بخش نمونه‌هایی از نحوه استفاده از API Waze Deep Links در پلتفرم‌های اندروید و iOS را ارائه می‌دهد.

مثال اندروید

قطعه کد زیر، در صورت نصب بودن Waze، آن را برای جستجوی مکان مشخص شده اجرا می‌کند. اگر Waze نصب نشده باشد، صفحه 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 می‌رود؛ در غیر این صورت، App Store را برای نصب 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>