במאמר הזה מוסבר איך להגדיר את Navigation Connect API, ומפורטות הדרישות מהמכשיר של הנהג כדי להשתמש ב-Navigation Connect API.
תהליך ההגדרה של Navigation Connect
כדי להשתמש ב-Navigation Connect API, צריך לבצע את השלבים הבאים:
- יצירה והגדרה של פרויקט ב-Google Cloud
- מפעילים את Navigation Connect API ומאמתים את האפליקציה.
- מגדירים את OAuth כדי ליצור אסימוני OAuth.
- מגדירים את חשבון השירות כדי לאפשר תקשורת בין תשתית הקצה העורפי שלכם לבין מפות Google או Waze.
דרישות המכשיר המינימליות לשימוש ב-Navigation Connect
הדרישות האלה נחוצות כדי שהמכשיר של הנהג יוכל להפעיל בהצלחה סשן של Navigation Connect. במהלך סשן, Navigation Connect API שולח לשרת הבק-אנד נתוני נסיעה בזמן אמת, כמו מיקום וזמן הגעה משוער.
גרסאות נתמכות של האפליקציה
במכשיר צריכה להיות מותקנת אפליקציית Waze או מפות Google ל-Android. בטבלה הבאה מפורטת הגרסה המינימלית של כל אפליקציה ל-Navigation Connect ולתכונות שדורשות גרסה עדכנית יותר.
| אפליקציה | גירסת מינימום | דיווח על המסלול שנותר | דיווח על סטייה מהמסלול |
|---|---|---|---|
| Waze ל-Android | 5.15.5 | 5.20.0.2 | 5.22 |
| Waze ל-iOS | 5.15.5 | 5.20.0.1 | 5.22 |
| היישום מפות Google למערכת ההפעלה Android | 26.14 | 26.27 | לא נתמך |
המיקום המדויק מופעל
מבקשים מהנהג להפעיל את הרשאות המיקום המדויק במכשיר שלו. כדי להתחיל לנווט ב-Waze ובמפות Google, צריך להפעיל את המיקום המדויק.
הסכמת הנהג/ת
כדי להשתמש ב-Navigation Connect, הנהג צריך להסכים לשתף את נתוני הנסיעה. אתם לא צריכים להפעיל את תיבת הדו-שיח להבעת הסכמה. מפות Google או Waze מטפלים בממשק המשתמש הזה באופן אוטומטי.
בנסיעה הראשונה שמתחילה מהאפליקציה, מופיעה בקשה לנהג במפות Google או ב-Waze לשתף את נתוני הנסיעה.
- אם הנהג לוחץ על אישור, Navigation Connect מתחיל לשתף את נתוני המיקום בזמן אמת וזמן ההגעה המשוער עם הקצה העורפי שלכם.
- אם הנהג לוחץ על לא מאשר או מבטל את ההסכמה מאוחר יותר, אפליקציית מפות Google או Waze מספקת מסלול מפורט, אבל Navigation Connect לא שולחת נתונים. ה-backend מקבל סטטוס
CLIENT_ERRORבמטען הייעודי (payload) של נתוני הנסיעה.
הנהגים צריכים לאשר מחדש את ההסכמה הזו כל 12 חודשים.
המאמרים הבאים
השלב הראשון בהגדרת Navigation Connect API הוא ליצור ולהגדיר פרויקט ב-Google Cloud.