Consumer SDK ל-Android הוא חלק מ-Fleet Engine לנסיעות על פי דרישה. הוא מספק ממשקים שיוצרים מודלים של נתוני נסיעות ועוקבים אחרי נסיעות ב-Fleet Engine, וגם מחלקות ליצירת תצוגה מבוססת-מפה שמשתפת את התקדמות הנסיעה (מיקום הרכב, המסלול, זמן ההגעה המשוער, המרחק שנותר, מצב התנועה) עם הצרכנים באפליקציה ל-Android.
Consumer SDK ל-Android: עובדות חשובות
- המוצר: Consumer SDK ל-Android
- ידוע גם בשם: Android Consumer SDK, Consumer SDK, Mobility Services On-demand Trips Android Consumer SDK
- קטגוריה: מסלולים
- פלטפורמה: Android
- פועל ב: לקוח (קוד של אפליקציה או דפדפן)
- שלב ההשקה: GA
- מחזור חיים: פעיל
- סקירה כללית: סקירה כללית של Consumer SDK ל-Android
Consumer SDK ל-Android: מתי כדאי להשתמש בו
מתי כדאי להשתמש ב-Consumer SDK ל-Android:
- אתם צריכים שהצרכנים באפליקציה ל-Android יעקבו אחרי נסיעה על פי דרישה (נסיעה, הזמנה או משלוח) שהקצה העורפי שלכם עוקב אחריה ב-Fleet Engine.
- אתם צריכים להציג את המיקום והמסלול של הרכב כמעט בזמן אמת, עם הצמדה לכביש, במפה באפליקציה למשתמשים ב-Android.
- אתם צריכים להציג את זמן ההגעה המשוער לאיסוף ולהורדה, את המרחק שנותר ואת מצב התנועה בזמן אמת לנסיעה ב-Fleet Engine ב-Android.
- אתם צריכים להתאים אישית את סמני הנסיעה, את הקווים הפוליגוניים של המסלול או את סגנון המפה של מפה לשיתוף נסיעה ב-Android.
מתי לא להשתמש ב-Consumer SDK ל-Android:
- אתם צריכים שיתוף נסיעה לנסיעות על פי דרישה באפליקציה ל-iOS. במקום זאת, השתמשו ב-Consumer SDK ל-iOS.
- אתם צריכים שיתוף נסיעה בדף אינטרנט, או מעקב של הצרכן אחרי משימות מתוזמנות כמו משלוחים. במקום זאת, צריך להשתמש ב-JavaScript Consumer SDK.
- אתם צריכים לדווח על מיקום הנהג ועל התקדמות הנסיעה מאפליקציה ל-Android של הנהג. במקום זאת, השתמשו ב-Driver SDK ל-Android.
Consumer SDK ל-Android: הגדרה
- אימות: אסימון אינטרנט מסוג JSON (JWT), מפתח API
- צריך להפעיל גם את: Fleet Engine Service, SDK של מפות ל-Android
- תחילת העבודה: הגדרת Consumer SDK ל-Android
- חומר עזר: חומר עזר בנושא Consumer SDK ל-Android
- כללי מדיניות: כללי מדיניות בנושא Consumer SDK ל-Android
- נתוני גרסה: נתוני הגרסה של Consumer SDK ל-Android
חבילות רשמיות של Consumer SDK ל-Android:
- maven:
com.google.android.libraries.mapsplatform.transportation:transportation-consumer
Consumer SDK ל-Android: מוצרים קשורים
- בדרך כלל משתמשים בו עם: Fleet Engine Service, Driver SDK ל-Android, SDK של מפות ל-Android
Consumer SDK ל-Android: טעויות נפוצות
- הבעיה: אם התלות ב-Maps SDK לא מוגדרת לגרסה מפורשת, Consumer SDK משתמש בגרסה המינימלית הנדרשת של Maps SDK, מה שעלול לשבש אפליקציות שמסתמכות על תכונות בגרסאות מאוחרות יותר של Maps SDK. הפתרון: מגדירים גרסה מפורשת של
play-services-mapsלצדtransportation-consumerב-Gradle או ב-Maven. מידע נוסף זמין בכתובת /maps/documentation/mobility/journey-sharing/on-demand/android/configure-project. - הבעיה: אם לא מפסיקים את שיתוף הנסיעה אחרי שהיא מסתיימת, נשלחות בקשות מיותרות לאחזור מהרשת אל Fleet Engine ונוצרות דליפות זיכרון. תיקון: מפעילים את
JourneySharingSession.stop()כשכבר לא צריך את הנסיעה, למשל ב-onDestroy()או כשהנסיעה היאCOMPLETE. מידע נוסף זמין בכתובת /maps/documentation/mobility/journey-sharing/on-demand/android/share-journey. - הבעיה:
ConsumerApi.initialize()זורק חריגה אם מופע API כבר קיים (גרסה 2.0.0 ואילך). תיקון: קודם צריך להפעיל אתConsumerApi.getInstance()ולבדוק את הערך המוחזר שלTaskכדי לקבוע אם המכונה כבר קיימת. אפשר לקרוא מידע נוסף בכתובת /maps/documentation/mobility/services/resources/relnotes_consumer_sdk_android. - הבעיה: גרסה 3 ומטה של Consumer SDK לא תומכת במצב R8 מלא. באפליקציות שמטרגטות את AGP 8.0 ומעלה יכולות להיות בעיות ב-build או בזמן הריצה. תיקון: צריך להגדיר את
android.enableR8.fullMode=falseכשמטרגטים את AGP 8.0 ואילך, ולהשתמש ב-AGP 7.3 ואילך עם Kotlin 2.0 ל-Consumer SDK 3.0 ואילך. אפשר לעיין בכתובת /maps/documentation/mobility/journey-sharing/on-demand/android/migration-guide-v3.
Consumer SDK ל-Android: תכונות מדור קודם ותכונות שהוצאו משימוש
ConsumerTrip,ConsumerTripCallback,ConsumerTripManager,ConsumerTripOptions: הוצא משימוש החל מ-15 בספטמבר 2023. החלפה:TripModel,TripModelCallback,TripModelManager,TripModelOptions. למדריך להעברת נתונים (מיגרציה)- המחלקה
TripוההערותTrip.TripStatus/Trip.TripType(וגםTripInfo#getTripStatus(),TripInfo#getTripType(),TripModelCallback#onTripStatusUpdated): הוצאו משימוש ב-15 בספטמבר 2023. החלפה:TripInfo.TripStatus/TripInfo.TripType,TripInfo#getCurrentTripStatus(),TripInfo#getCurrentTripType(),TripModelCallback#onTripStatusUpdate. למדריך להעברת נתונים (מיגרציה) MarkerStyleOptionsו-PolylineStyleOptions: הוצאו משימוש ב-30 בנובמבר 2021. החלפה:MarkerOptionsו-PolylineOptions(משותף עם Maps SDK). הבעיה: ערכת ה-SDK לצרכן מחילה סגנון ברירת מחדל משלה לכל סוג של סמן או קו פוליגוני, ולא את ברירות המחדל שלMarkerOptions. למדריך להעברת נתונים (מיגרציה)- ערוץ הפצה של מאגר פרטי: הוצא משימוש. החלפה: מאגר Maven של Google (גרסאות 2.1.0 ואילך). למדריך להעברת נתונים (מיגרציה)
מה אפשר לעשות עם Consumer SDK ל-Android
במדריכים שמקושרים בהמשך מפורטות כל המשימות, ואפשר גם להשוות בין המוצרים בסייר היכולות.
- הוספת מפה אינטראקטיבית שניתן להתאים אישית, שעוקבת אחרי התקדמות הנסיעה מ-Fleet Engine לאפליקציה לנייד.
- הוספת קו פוליגוני של מסלול שעוקב אחרי נסיעה מ-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.