كيفية استخدام الروابط لصفحات في تطبيق Waze

يتيح Waze واجهة برمجة تطبيقات (API) للمطوّرين لفتح تطبيق Waze أو صفحة الويب من خلال عنوان URL خارجي. ويمكن الوصول إلى عنوان URL من داخل تطبيق آخر على الأجهزة الجوّالة أو صفحة ويب على الأجهزة الجوّالة.

عنوان URL الأساسي الذي يجب استخدامه للروابط العميقة في Waze هو:

https://waze.com/ul

يمكن لتطبيق Waze بعد ذلك تحديد موقع عنوان أو وضع علامة عليه على الخريطة أو بدء جلسة تنقّل إلى عنوان أو وجهة، استنادًا إلى المَعلمات التي تمرِّرها إلى عنوان URL هذا.

طريقة عمل الروابط العميقة

يعتمد فتح Waze كتطبيق أو صفحة ويب على إعدادات نظام المستخدم:

  • أجهزة الكمبيوتر: يتم فتح Waze كصفحة ويب.
  • الأجهزة الجوّالة (مع تثبيت تطبيق Waze): يتم فتح تطبيق Waze.
  • الأجهزة الجوّالة (بدون تثبيت Waze): يتم فتح Waze كصفحة ويب.

إذا كنت متأكدًا من تثبيت تطبيق Waze، يمكنك استخدام عنوان URL ‏"waze://" للتواصل بين التطبيقات بدون تجربة الويب. ويحلّ هذا العنوان محل عنوان URL الأساسي الذي تم وصفه سابقًا. لا تستخدِم هذا الخيار إلا إذا كنت متأكدًا من أنّ المستخدمين قد ثبّتوا Waze، وإلا فلن يحدث أي شيء إذا نقروا على الرابط.

استخدام الروابط العميقة في Waze

يمكنك استخدام عنوان URL التالي لتشغيل Waze مع مَعلمات من تطبيق خارجي أو رسالة إلكترونية أو رسالة قصيرة أو رابط صفحة ويب أو مصدر آخر.

تستخدم الروابط العميقة في Waze عنوان URL التالي:

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

في ما يلي عدد من المهام الشائعة للروابط العميقة في Waze:

للتنقّل إلى موقع جغرافي معيّن:

  1. افتح خريطة حركة المرور المباشرة على Waze و ابحث عن موقعك الجغرافي. يمكنك الكتابة في مربّع البحث أو تكبير الخريطة والنقر على جزء معيّن منها.
  2. انقر على رمز المشاركة في أسفل يسار الخريطة.
  3. يظهر مربّع حوار. انقر على مشاركة اتّجاهات القيادة، ثم انسخ الرابط والصقه.

مثال

يركّز المثال التالي الخريطة على تايمز سكوير في نيويورك:

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 شارع المحطة":

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

عرض على الخريطة

استخدِم الصيغة التالية لضبط مستوى التكبير أو التصغير (zoom) في طريقة عرض خريطة Waze:

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

الحد الأدنى لقيمة magnification_level هو 6 (الأقرب أو الأكبر تكبيرًا). الحد الأقصى لقيمة magnification_level هو 8192 (الأبعد أو الأقل تكبيرًا).

يضبط المثال التالي مستوى التكبير أو التصغير على 8:

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

معلمات عنوان URL

يوضّح الجدول التالي مَعلمات التوجيه المتاحة للروابط العميقة في Waze:

المَعلمة مطلوب؟ الوصف
avoid_tolls اختياري لتحديد ما إذا كان يجب احتساب مسار يتجنّب رسوم العبور اضبط القيمة على true أو t لتجنّب رسوم العبور. اضبط القيمة على false أو f للسماح بالطرق التي تفرض رسوم عبور. الإعداد التلقائي هو السماح برسوم العبور (false).
avoid_ferries اختياري لتحديد ما إذا كان يجب احتساب مسار يتجنّب العبّارات اضبط القيمة على true أو t لتجنّب العبّارات. اضبط القيمة على false أو f للسماح بالعبّارات. الإعداد التلقائي هو السماح بالعبّارات (false).
avoid_freeways اختياري لتحديد ما إذا كان يجب احتساب مسار يتجنّب الطرق السريعة اضبط الق0/} أو t لتجنّب الطرق السريعة.true اضبط القيمة على false أو f للسماح بالطرق السريعة. الإعداد التلقائي هو السماح بالطرق السريعة (false).
avoid_dangerous_turns اختياري لتحديد ما إذا كان يجب تجنّب المنعطفات الخطيرة اضبط القيمة على true أو t لتجنّب المنعطفات الخطيرة. اضبط القيمة على false أو f للسماح بالمنعطفات الخطيرة. الإعداد التلقائي هو تجنّب المنعطفات الخطيرة (true).
avoid_trails اختياري

لتحديد إعدادات التوجيه المفضّلة للطرق غير المُعبَّدة القيمتان المسموح بإدراجهما هما:

  • avoid_all (تلقائي): لتجنّب جميع الطرق غير المُعبَّدة
  • allow: للسماح بالطرق غير المُعبَّدة
  • avoid_long: لتجنّب الطرق غير المُعبَّدة الطويلة
vehicle_type اختياري

لتحديد نوع المركبة القيم المسموح بها هي:

  • private (تلقائي): مركبة خاصة
  • taxi: سيارة أجرة
  • motorcycle: درّاجة نارية

الجمع بين المَعلمات

يمكنك استخدام المَعلمات معًا في عنوان URL نفسه عن طريق فصل أزواج الاسم والقيمة بعلامة "&". توضّح الأمثلة التالية كيفية استخدام مجموعات من المَعلمات:

  • لتوسيط الخريطة على ماري هيل وتكبيرها إلى 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. إذا واجهتك أي مشاكل، يُرجى التواصل معنا.

أمثلة

يقدّم هذا القسم أمثلة على كيفية استخدام Waze Deep Links API على منصتَي Android وiOS.

مثال لنظام التشغيل Android

يشغّل مثال مقتطف الرمز التالي Waze للبحث عن الموقع الجغرافي المحدّد، إذا كان Waze مثبَّتًا. إذا لم يكن Waze مثبَّتًا، يتم فتح صفحة Waze في Google Play:

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 مثبَّتًا، وإلا فسيتم تشغيل 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>