تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

يتيح Waze واجهة برمجة تطبيقات تتيح لمطوّري البرامج فتح تطبيق عميل 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.

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

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

افتح خريطة Waze المباشرة وابحَث عن موقعك الجغرافي. اكتب إما في مربع البحث أو كبّر وانقر على جزء معين من الخريطة.
انقر على رمز المشاركة في أسفل يسار الخريطة.
سيظهر مربع حوار. انقر على مشاركة اتجاهات القيادة، ثم انسخ الرابط والصقه.
ملاحظة: يظهر مستوى التكبير/التصغير للعرض على الخريطة المباشرة في رمز التضمين. يمكنك تعديل مستوى التكبير أو التصغير باستخدام معلمة التكبير/التصغير. لمزيد من المعلومات، راجِع معلّمات عناوين URL.

مثال

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

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

الانتقال إلى المفضّلة

يمكنك الانتقال إلى المفضّلة التالية المحفوظة في تطبيق Waze:

work
home

استخدِم عنوان URL التالي للانتقال إلى عنوان 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&quot:

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

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

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

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

الحد الأدنى لقيمة magnification_level هو 6 (الأقرب أو معظم التكبير). وتكون القيمة القصوى لـ magnification_level 8, 192 (أبعد، أو أقل تكبير).

يحدّد المثال التالي مستوى التكبير: 8:

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

دمج المعلمات

يمكنك استخدام المعلّمات معًا في عنوان 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 على منصّتَي 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"]];
  }
}

عند استخدام الإصدار 9.0 أو الإصدارات الأحدث من حزمة تطوير البرامج (SDK) لنظام التشغيل iOS، عليك تعديل ملف قائمة المواقع الإلكترونية في تطبيقك باستخدام ما يلي لتضمين Waze:

<key>LSApplicationQueriesSchemes</key>
<array>
  <string>waze</string>
</array>