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

איך משתמשים בקישורי עומק ב-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

אפשר להשתמש בכתובת האתר הבאה כדי להפעיל את Waze עם פרמטרים מאפליקציית צד שלישי, מאימייל, מ-SMS, מקישור לדף אינטרנט או ממקור אחר.

קישורי עומק ב-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 הבאה:

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 הוא 8192 (הכי רחוק, או ההגדלה הכי קטנה).

בדוגמה הבאה, רמת ההגדלה מוגדרת ל-8:

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

פרמטרים של כתובת אתר

בטבלה הבאה מפורטים פרמטרי הניתוב שזמינים לקישורים עמוקים ב-Waze:

פרמטר	חובה?	תיאור
`avoid_tolls`	אופציונלי	השדה מציין אם לחשב מסלול שבו לא משלמים אגרה. מגדירים את הערך ל-`true` או ל-`t` כדי להימנע מכבישי אגרה. מגדירים את האפשרות `false` או `f` כדי לאפשר נסיעה בכבישי אגרה. ברירת המחדל היא לאפשר נסיעה בכבישי אגרה (`false`).
`avoid_ferries`	אופציונלי	השדה מציין אם לחשב מסלול שבו לא עוברים במעבורות. מגדירים את הערך `true` או `t` כדי להימנע ממעבורות. מגדירים את האפשרות `false` או `f` כדי לאפשר מעבורות. ברירת המחדל היא לאפשר מעבורות (`false`).
`avoid_freeways`	אופציונלי	השדה מציין אם לחשב מסלול שבו נמנעים מכבישים מהירים. מגדירים את הערך ל-`true` או ל-`t` כדי להימנע מכבישים מהירים. מגדירים את האפשרות `false` או `f` כדי לאפשר נסיעה בכבישים מהירים. ברירת המחדל היא לאפשר נסיעה בכבישים מהירים (`false`).
`avoid_dangerous_turns`	אופציונלי	קובעת אם להימנע מפניות מסוכנות. כדי להימנע מפניות מסוכנות, מגדירים את האפשרות `true` או `t`. מגדירים את הערך ל-`false` או ל-`f` כדי לאפשר פניות מסוכנות. ברירת המחדל היא הימנעות מפניות מסוכנות (`true`).
`avoid_trails`	אופציונלי	מציין את העדפות המסלול לדרכים לא סלולות או לשבילים. הערכים הנתמכים הם: ‫`avoid_all` (ברירת מחדל): הימנעות מכל השבילים. ‫`allow`: מאפשרת להשתמש בנסיעות עם נגרר. ‫`avoid_long`: הימנעות משבילים ארוכים.
`vehicle_type`	אופציונלי	מציין את סוג כלי הרכב. הערכים הנתמכים הם: ‫`private` (ברירת מחדל): רכב נוסעים. ‫`taxi`: מונית. ‫`motorcycle`: אופנוע.

שילוב פרמטרים

אפשר להשתמש בפרמטרים יחד באותה כתובת 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"]];
  }
}

כשמבצעים קומפילציה באמצעות iOS SDK 9.0 ואילך, צריך לעדכן את קובץ רשימת המאפיינים של האפליקציה עם הערכים הבאים כדי לכלול את Waze:

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