Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

كيفية استخدام الروابط لصفحات في تطبيق 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 مع مَعلمات من تطبيق خارجي أو رسالة إلكترونية أو رسالة SMS أو رابط صفحة ويب أو مصدر آخر.

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

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

في ما يلي عدد من المهام الشائعة التي يمكن تنفيذها باستخدام الروابط لصفحات في تطبيق Waze.

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

للانتقال إلى موقع جغرافي معيّن، اتّبِع الخطوات التالية:

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

مثال

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

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

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

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

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

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

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

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

أمثلة

يقدّم هذا القسم أمثلة على كيفية استخدام 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"]];
  }
}

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

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