סקירה כללית ודרישות של ההגדרה

במאמר הזה מוסבר איך להגדיר את Navigation Connect API, ומפורטות הדרישות מהמכשיר של הנהג כדי להשתמש ב-Navigation Connect API.

תהליך ההגדרה של Navigation Connect

כדי להשתמש ב-Navigation Connect API, צריך לבצע את השלבים הבאים:

  1. יצירה והגדרה של פרויקט ב-Google Cloud
  2. מפעילים את Navigation Connect API ומאמתים את האפליקציה.
  3. מגדירים את OAuth כדי ליצור אסימוני OAuth.
  4. מגדירים את חשבון השירות כדי לאפשר תקשורת בין תשתית הקצה העורפי שלכם לבין מפות 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.