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

‫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: הגדרה

חבילות רשמיות של Consumer SDK ל-Android:

  • maven: com.google.android.libraries.mapsplatform.transportation:transportation-consumer

‫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

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