באמצעות ה-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: הגדרה
- אימות: מפתח API, JSON Web Token (JWT)
- צריך להפעיל גם את: Maps JavaScript API, Fleet Engine Service
- שיוך השימוש: מזהה עסקה אופציונלי (בטא) של Mobility: מגדירים את
google.maps.Settings.getInstance().experienceIdsלמערך של מזהי עסקאות של Mobility (או מזהים קשורים) לפני שיוצריםJourneySharingMapView. experienceIdsזמין רק בערוץv=betaשל Maps JavaScript API. - תחילת העבודה: הגדרת Consumer SDK ל-JavaScript
- חומר עזר: חומר עזר בנושא Consumer SDK ל-JavaScript
- נתוני גרסה: נתוני הגרסה של Consumer SDK ל-JavaScript
JavaScript Consumer SDK: מוצרים קשורים
- בדרך כלל משתמשים בו עם: Fleet Engine Service, Maps JavaScript API, Driver SDK ל-Android, Driver SDK ל-iOS
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
במדריכים שמקושרים בהמשך מפורטות כל המשימות, ואפשר גם להשוות בין המוצרים בסייר היכולות.
- הוספת קו פוליגוני של מסלול שעוקב אחרי נסיעה מ-Fleet Engine למפה בדף אינטרנט או באפליקציה לנייד.
- עדכון ההתקדמות של נסיעה לאורך מסלול במפה בדף אינטרנט או באפליקציה לנייד, לנסיעה ב-Fleet Engine.
- שינוי הסגנון של כבישים, קווים פוליגוניים ופוליגונים במפה שעוקבת אחרי התקדמות הנסיעה מ-Fleet Engine.
- הצגה או הסתרה של תכונות במפה שעוקבת אחרי התקדמות הנסיעה מ-Fleet Engine.
- שינוי הסגנון של הסמלים ותוויות הטקסט במפה שעוקבת אחרי התקדמות הנסיעה מ-Fleet Engine.
- החלת סגנונות מפה שונים על רמות זום שונות במפה שעוקבת אחרי התקדמות הנסיעה מ-Fleet Engine.
- שינוי צפיפות המקומות במפה שעוקבת אחרי התקדמות הנסיעה מ-Fleet Engine. ניסיוני הערה: התמיכה בעיצוב מפות מבוסס-ענן ב-Consumer SDK היא גרסת GA, ואילו השליטה בצפיפות של נקודות העניין היא תכונה ניסיונית של עיצוב מפות מבוסס-ענן (נתמכת רק בסגנונות מפה בהירים).
- שינוי הסגנון של מבנים במפה שעוקבת אחרי התקדמות הנסיעה מ-Fleet Engine. ניסיוני הערה: התמיכה בעיצוב מפות מבוסס-ענן ב-Consumer SDK זמינה לכולם, אבל ההתאמה האישית של סגנון המבנים בתלת-ממד ושל שטח הרצפה היא תכונה ניסיונית של עיצוב מפות מבוסס-ענן (נתמכת רק בסגנונות של מפות בהירות).
- שינוי הסגנון של ציוני דרך במפה שעוקבת אחרי התקדמות הנסיעה מ-Fleet Engine. ניסיוני הערה: התמיכה בעיצוב מפות מבוסס-ענן ב-Consumer SDK היא גרסה זמינה לכלל המשתמשים (GA), והתאמה אישית של סמלי ציוני דרך היא תכונה ניסיונית של עיצוב מפות מבוסס-ענן (נתמכת רק בסגנונות מפה בהירים).
- התאמה אישית של סמן במפה שעוקב אחרי התקדמות הנסיעה מ-Fleet Engine.
- התאמה אישית של הקו הפוליגוני של המסלול במפה שעוקבת אחרי התקדמות הנסיעה מ-Fleet Engine.