אפליקציית 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[¶m_name=value]
ברשימה הבאה תוכלו למצוא כמה משימות נפוצות של קישורי עומק ב-Waze.
ניווט למיקום
כדי לנווט למיקום ספציפי:
- פותחים את המפה החיה של Waze ומחפשים את המיקום שלכם. צריך להקליד בתיבת החיפוש או להגדיל את התצוגה וללחוץ על פלח ספציפי במפה.
- לוחצים על סמל השיתוף בפינה השמאלית התחתונה של המפה.
- תופיע תיבת דו-שיח. לוחצים על שיתוף מסלול נסיעה, ולאחר מכן מעתיקים את הקישור ומדביקים אותו.
דוגמה
בדוגמה הבאה המפה מורכבת מטיימס סקוור בניו יורק:
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>