סקירה כללית על Navigation Connect API

מפתחים באזור הכלכלי האירופי (EEA)

‫Navigation Connect API הוא שירות שמקשר בין השימוש של הנהג בניווט במפות Google וב-Waze לבין המערכות הארגוניות שלכם. הוא משתמש באסימוני הרשאה לנסיעה יחד עם קישור עומק באפליקציה, כך שהנהג יכול להקיש על קישור או על לחצן כדי להתחיל בניווט באפליקציה למשתמשים לפי בחירתו. במהלך הניווט של הנהג בנסיעה, אתם יכולים לקבל נתוני מיקום בזמן אמת, כמו מיקומים בזמן אמת, זמני הגעה משוערים מדויקים מאוד וסטטוסים של מחזור החיים של הנסיעה.

‫Navigation Connect API הוא חלופה קלה ל-Navigation SDK. הוא משתמש באפליקציות העצמאיות של Google Maps ו-Waze לניתוב, במקום לדרוש מכם ליצור ולהטמיע ממשק ניווט מותאם אישית באפליקציה. הוא מקשר בצורה מאובטחת את סשן הנהג לבק-אנד שלכם. כשנהג מתחיל נסיעה, הוא רואה את ממשק הניווט המוכר שלו עם שני תוספים: בקשה להסכמה לשיתוף נתוני הנסיעה (נדרשת כל 12 חודשים) ולחצן חזרה ממותג כדי לחזור לאפליקציה שלכם.

למה כדאי להשתמש ב-Navigation Connect API

בעזרת Navigation Connect API, אתם יכולים לשלב עדכונים בזמן אמת על מיקום הנסיעה ועל זמן ההגעה המשוער ממפות Google או מ-Waze ישירות בתהליכי ה-Backend שלכם. כך תוכלו לקבל החלטות עסקיות חשובות ולשתף עדכונים מדויקים עם הלקוחות שלכם, בזמן שהנהגים משתמשים באפליקציית הניווט המועדפת עליהם, מפות Google או Waze.

דוגמאות לתרחישי שימוש:

  • שיפור השקיפות בנסיעות שיתופיות: חשוב לספק ללקוחות ולנוסעים של שירותי נסיעות שיתופיות עדכונים מדויקים בזמן אמת לגבי מיקום הנהג וזמני ההגעה המשוערים.
  • לשפר את מעקב המשלוחים: לספק ללקוחות מידע מדויק על זמני המשלוח של מוצרים או מזון על סמך נתוני תנועה בזמן אמת ונתוני תכנון מסלול.
  • שיפור הניהול של צי הרכבים והשיגור: קבלת החלטות מושכלות לגבי שיגור של צי רכבים או כוח עבודה נייד שמספק שירותים על פי דרישה (כמו סיוע במקרה של תקלה, תחזוקה או תחבורה) באמצעות מעקב בזמן אמת אחרי מיקומי הנהגים.

מה אפשר לעשות עם Navigation Connect API

בעזרת Navigation Connect API אפשר לקבל עדכונים בזמן אמת על המיקום ועל זמן ההגעה המשוער (ETA) ממפות Google או מ-Waze ישירות בקצה העורפי.

  • מעקב אחרי נסיעות בלי להפריע: מעקב אחרי נסיעות בלי לשנות את הבחירה של הנהג להשתמש במפות Google או ב-Waze, או לשנות את חוויית המשתמש שלו.
  • גישה לנתוני מיקום בזמן אמת: קבלת מיקומי הנהגים בזמן אמת, המרחק שנותר ומשך הזמן שחלף באופן רציף במהלך הנסיעה.
  • מעקב אחרי מחזור החיים של הנסיעה: אפשר להגדיר את תדירות העדכון של נתוני הנסיעה כדי לעקוב אחרי הסטטוס המדויק של הנסיעה ולדעת מיד אם הנהג בדרך, הגיע או השהה את הנסיעה.
  • צפייה בזמני הגעה משוערים ושיתוף שלהם: אפשר לאחזר עדכונים מדויקים מאוד של זמני הגעה משוערים שמבוססים על אלגוריתמים של Google לניתוב בזמן אמת.
  • מעקב אחרי המסלול שנותר והתנועה (Waze בלבד): קבלת קו פוליגון של המסלול הפעיל ותנאי התנועה בזמן אמת מהמיקום הנוכחי של הנהג ועד ליעד הסופי, בדיוק כמו שמוצג ב-Waze.
    • חיתוך דינמי: כשהרכב בתנועה, Navigation Connect חותך באופן אוטומטי את קו הפוליגון של המסלול הפעיל כדי לוודא שתקבלו רק את החלק שנותר מהנסיעה.
    • תדירות העדכון: המסלול ומצב התנועה מתעדכנים באופן אוטומטי כשמחשבים מחדש את המסלול, כשמתבצע ניתוב מחדש פרואקטיבי בצד הלקוח או כשמתרחשים שינויים במצב התנועה.
  • הטמעת נתונים בצורה גמישה: צריכת נתוני נסיעות בזמן אמת באמצעות קריאות ישירות ל-API בארכיטקטורת REST, או סטרימינג של עדכונים בצורה יעילה באמצעות מינויים ל-Google Cloud Pub/Sub.

איך Navigation Connect API פועל

ממשק ה-API של Navigation Connect מקבל CreateTrip בקשה שמכילה את מזהי האפליקציה לנייד ואת הגדרות הסשן. השירות יוצר מופע ייחודי של נסיעה ומחזיר אסימון נסיעה. האסימון הזה מצורף לקישור עמוק של מפות Google או Waze. אחרי שהנהג מפעיל את הניווט ומאשר את ההסכמה, השירות מעבד נתוני ניווט בזמן אמת ומחזיר עדכוני טלמטריה, כולל מיקום, זמן הגעה משוער ומרחק שנותר.

משאבים

בטבלה הבאה מפורטים המשאבים שזמינים דרך Navigation Connect API והנתונים שמוחזרים. לפרטים ספציפיים, אפשר לעיין בהפניית API של Navigation Connect.

מקורות נתונים הנתונים שהוחזרו

מזהי אפליקציות לנייד ואימות בפורמט JSON.

איך יוצרים נסיעה

טוקן ייחודי של הנסיעה שמשמש לאתחול החיבור במפות Google או ב-Waze.

איך מפעילים את מפות Google או את Waze

מזהה הנסיעה הייחודי ושיטת שליפה או דחיפה בפורמט JSON.

איך מאחזרים נתוני נסיעות

טלמטריה של נסיעות בזמן אמת, כולל:

  • הסטטוס והמטא-נתונים של הנסיעה
  • המיקום הנוכחי (קו רוחב/אורך)
  • זמן הגעה משוער (ETA)
  • המרחק והזמן שנותרו

איך מטפלים בנתוני נסיעות

איך משתמשים ב-Navigation Connect API

1 הגדרה מתחילים עם הגדרת פרויקט ב-Google Cloud ופועלים לפי ההוראות שבהמשך.
2 יצירת נסיעה שולחים קריאה ל-Navigation Connect API כדי ליצור נסיעה עם מזהה ייחודי, ושומרים את האסימון.
3 הפעלת מפות Google או Waze מעבירים את אסימון הנסיעה ופותחים את מפות Google או את Waze כדי להפעיל את שיתוף נתוני הנסיעה.
4 אחזור נתוני נסיעות שולחים קריאה ל-Navigation Connect API כדי לאחזר נתוני נסיעה. אופציונלי: אפשר להירשם לעדכונים באמצעות Google Cloud Pub/Sub.
5 איך מטפלים בנתוני הנסיעה הדרכה על ניהול סטטוס הנסיעה ונתוני הנסיעה