מדריך מקוצר ל-JavaScript Consumer SDK

באמצעות ה-SDK לצרכן ב-JavaScript, אפליקציה למשתמשים שמבוססת על האינטרנט יכולה להציג במפה את המיקום של כלי הרכב ומיקומים אחרים שהתעניינו בהם, שנמצאים במעקב ב-Fleet Engine. כך המשתמשים יכולים לעקוב אחרי ההתקדמות של נסיעה לפי דרישה או של משלוח מתוזמן. היא נטענת כספריית journeySharing של Maps JavaScript API.

‫SDK לצרכן ב-JavaScript: עובדות חשובות

  • מוצר: JavaScript Consumer SDK
  • נקרא גם: Consumer SDK for JavaScript, ‏ Mobility services on-demand trips JavaScript, ‏ JavaScript SDK
  • קטגוריה: מסלולים
  • פלטפורמה: JavaScript (דפדפן)
  • פועל ב: לקוח (קוד של אפליקציה או דפדפן)
  • שלב ההשקה: GA
  • מחזור חיים: פעיל
  • סקירה כללית: סקירה כללית של Consumer SDK ל-JavaScript

JavaScript Consumer SDK: מתי כדאי להשתמש בו

מתי כדאי להשתמש ב-JavaScript Consumer SDK:

  • אתם צריכים להציג לצרכנים את המיקום בזמן אמת של הרכב ואת המסלול של נסיעה על פי דרישה ש-Fleet Engine עוקב אחריה, בדף אינטרנט או באפליקציית אינטרנט.
  • אתם צריכים לאפשר לצרכנים לעקוב בדפדפן אחרי התקדמות האיסוף או המסירה של משלוח מתוזמן, שמתבצע אחריו מעקב ב-Fleet Engine.
  • אתם צריכים להציג את זמן ההגעה המשוער, המרחק שנותר והתנועה בזמן אמת במסלול של נסיעה בתצוגת מפה מבוססת-אינטרנט.
  • אתם צריכים להתאים אישית את סמני הנסיעה, את הקווים הפוליגוניים של המסלול או את סגנון המפה בתצוגת מעקב של צרכן באינטרנט.

מתי לא כדאי להשתמש ב-SDK של הצרכן ב-JavaScript:

  • אתם צריכים חוויית משתמש של מעקב אחרי נסיעה בתוך אפליקציית Android מקורית. במקום זאת, השתמשו ב-Consumer SDK ל-Android.
  • אתם צריכים חוויית משתמש של מעקב אחרי נסיעות באפליקציה ל-iOS. במקום זאת, השתמשו ב-Consumer SDK ל-iOS.
  • אתם צריכים לדווח ל-Fleet Engine על מיקום הנהג ועל התקדמות הנסיעה מאפליקציית הנהג ל-Android. במקום זאת, צריך להשתמש ב-Driver SDK ל-Android.
  • אתם צריכים לדווח ל-Fleet Engine על מיקום הנהג ועל התקדמות הנסיעה מאפליקציית הנהג ל-iOS. במקום זאת, צריך להשתמש ב-Driver SDK ל-iOS.
  • אתם צריכים מפה כללית לאינטרנט שלא עוקבת אחרי נסיעות או משימות ב-Fleet Engine. במקום זאת, צריך להשתמש ב-Maps JavaScript API.

‫JavaScript Consumer SDK: הגדרה

‫JavaScript Consumer SDK: טעויות נפוצות

  • הבעיה: אם לא מגדירים למפה של JourneySharingMapView אזור תצוגה ראשוני (מרכז ומרחק תצוגה), יכול להיות שהאירוע 'ready' של המפה לא יופעל. תיקון: צריך להפעיל את mapView.map.setCenter(...) ואת mapView.map.setZoom(...) אחרי שיוצרים את תצוגת המפה. אפשר לקרוא מידע נוסף בכתובת /maps/documentation/mobility/journey-sharing/on-demand/javascript/share-journey.
  • הבעיה: שגיאות מבקשות אסינכרוניות של פרטי נסיעה לא מופעלות. הם מגיעים רק כאירועים מסוג 'error' בספק המיקום, ולכן הם לא מזוהים אלא אם מוסיפים פונקציית listener. תיקון: מוסיפים את locationProvider.addListener('error', ...) ועוטפים את הקריאות לספרייה בבלוקים של try...catch. אפשר לקרוא מידע נוסף בכתובת /maps/documentation/mobility/journey-sharing/on-demand/javascript/share-journey.
  • הבעיה: המחלקות של google.maps.journeySharing לא זמינות אלא אם טוענים את הספרייה של journeySharing. תיקון: מוסיפים את libraries=journeySharing לכתובת ה-URL של הסקריפט של Maps JavaScript API, או טוענים את המחלקות באמצעות await google.maps.importLibrary("journeySharing"). אפשר לקרוא מידע נוסף בכתובת /maps/documentation/mobility/journey-sharing/on-demand/javascript/share-journey.
  • הבעיה: קריאות ל-Fleet Engine מהדפדפן (סביבה עם רמת אמינות נמוכה) דורשות אסימוני JWT שמונפקים על ידי שרת הבק-אנד. מפתח API לבדו לא מאפשר גישה לנתוני הנסיעה. הפתרון: מנפיקים אסימוני JWT מהקצה העורפי ומספקים authTokenFetcher שמחזיר את האסימון ואת expiresInSeconds. מידע נוסף זמין בכתובת /maps/documentation/mobility/journey-sharing/on-demand/javascript/setup.

‫JavaScript Consumer SDK: תכונות מדור קודם ותכונות שהוצאו משימוש

  • אפשרויות הגדרה של סמנים וקווים פוליגוניים ב-JourneySharingMapView וב-JourneySharingMapViewOptions (vehicleMarkerSetup,‏ originMarkerSetup,‏ destinationMarkerSetup,‏ waypointMarkerSetup,‏ anticipatedRoutePolylineSetup,‏ takenRoutePolylineSetup ואחרים): הוצאו משימוש. החלפה: האפשרויות MarkerCustomizationFunction ו-PolylineCustomizationFunction בספק המיקום (לדוגמה, vehicleMarkerCustomization). תסמין: מתוכנן להסרה בגרסה עתידית. למדריך להעברת נתונים (מיגרציה)
  • JourneySharingMapView.locationProvider ו-JourneySharingMapViewOptions.locationProvider: הוצאו משימוש. החלפה: JourneySharingMapView.locationProviders ו-JourneySharingMapViewOptions.locationProviders.
  • מאפייני רשימה של סמנים וקווים פוליגוניים ב-JourneySharingMapView (vehicleMarkers,‏ originMarkers,‏ destinationMarkers,‏ waypointMarkers,‏ anticipatedRoutePolylines,‏ takenRoutePolylines ומאפייני סמנים של משימות): הוצאו משימוש. החלפה: קריאות חוזרות (callbacks) של MarkerCustomizationFunction ו-PolylineCustomizationFunction בספק המיקום. למדריך להעברת נתונים (מיגרציה)

מה אפשר לעשות עם Consumer SDK ל-JavaScript

במדריכים שמקושרים בהמשך מפורטות כל המשימות, ואפשר גם להשוות בין המוצרים בסייר היכולות.