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