איך להשתמש בקישורי עומק ב-Waze

אפליקציית Waze תומכת ב-API שמאפשר למפתחים לפתוח את אפליקציית הלקוח או דף האינטרנט של Waze דרך כתובת 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.

כדי לנווט למיקום ספציפי:

  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 Acacia Avenue"

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

הדוגמה הבאה של קטע הקוד מנווטת ל-lat/lon אם 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>