במאמר הזה מוסבר איך להגדיר את 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, המערכת מבקשת מהנהג לשתף את נתוני הנסיעה שלו.
- אם הנהג מקיש על אישור, מתחיל שיתוף של נתוני המיקום בזמן אמת וזמן ההגעה המשוער עם ה-Backend שלכם באמצעות Navigation Connect.
- אם הנהג מקיש על Don't allow (לא מאשר) או מבטל את ההסכמה בשלב מאוחר יותר, אפליקציית מפות Google או Waze מספקת הוראות הגעה מפורטות, אבל Navigation Connect לא שולחת נתונים. הקצה העורפי מקבל סטטוס
CLIENT_ERRORבמטען הייעודי (payload) של נתוני הנסיעה.
הנהגים צריכים לאשר מחדש את ההסכמה הזו כל 12 חודשים.
המאמרים הבאים
השלב הראשון בהגדרת Navigation Connect API הוא ליצור ולהגדיר פרויקט ב-Google Cloud.