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