סקירה כללית על 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 מאפשר לכם לקבל עדכונים על המיקום בזמן אמת וזמן ההגעה המשוער ממפות Google או מ-Waze ישירות בקצה העורפי שלכם.

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

איך Navigation Connect API פועל

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

משאבים

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

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

מזהים של אפליקציות לנייד ואימות בפורמט 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 טיפול בנתוני הנסיעה הסבר על הטיפול בסטטוס הנסיעה ובנתוני הנסיעה האחרים