Driver SDK ל-iOS הוא ערכת כלים לאפליקציות לנייד ורכיב של Fleet Engine. הוא שולח את מיקום הרכב, המסלול, נקודות הציון, המרחק שנותר וזמן ההגעה המשוער של אפליקציית הנהג מ-Navigation SDK אל Fleet Engine, לנסיעות על פי דרישה ולמשימות מתוזמנות.
Driver SDK ל-iOS: עובדות חשובות
- המוצר: Driver SDK ל-iOS
- ידוע גם בתור: Driver SDK, Driver SDK for on-demand trips, Driver SDK for scheduled tasks
- קטגוריה: מסלולים
- פלטפורמה: iOS
- פועל ב: לקוח (קוד של אפליקציה או דפדפן)
- שלב ההשקה: GA
- מחזור חיים: פעיל
- סקירה כללית: סקירה כללית של Driver SDK ל-iOS
Driver SDK ל-iOS: מתי כדאי להשתמש בו
מתי משתמשים ב-Driver SDK ל-iOS:
- כדי לשלוח עדכונים בזמן אמת על מיקום הרכב ל-Fleet Engine, צריך אפליקציית נהג ל-iOS.
- צריך לדווח ל-Fleet Engine על המסלול, נקודות הציון, המרחק שנותר וזמן ההגעה המשוער מ-Navigation SDK.
- אתם צריכים שהנהגים ינהלו את הנסיעות שהוקצו להם על פי דרישה וינווטו באפליקציה אחת בלי לעבור בין אפליקציות.
- אתם מפתחים אפליקציה לנהגים למשימות מתוזמנות ב-Fleet Engine ב-iOS.
מתי לא כדאי להשתמש ב-Driver SDK ל-iOS:
- אתם צריכים רק מסלול מפורט באפליקציה ל-iOS, בלי מעקב של Fleet Engine. במקום זאת, צריך להשתמש ב-Navigation SDK ל-iOS.
- אתם צריכים להציג את התקדמות הנסיעה או המשלוח לנוסע או ללקוח באפליקציה למשתמשים. במקום זאת, השתמשו ב-Consumer SDK ל-iOS.
- אתם צריכים לשלוח עדכונים של נתוני הרכב, מלבד המיקום והמסלול. העדכונים האלה עוברים דרך ה-backend שלכם אל Fleet Engine. במקום זאת, צריך להשתמש ב-Fleet Engine Service.
- אפליקציית הנהג פועלת ב-Android. במקום זאת, צריך להשתמש ב-Driver SDK ל-Android.
Driver SDK ל-iOS: הגדרה
- אימות: מפתח API, JSON Web Token (JWT)
- צריך להפעיל גם את: SDK של מפות ל-iOS
- תחילת העבודה: הגדרת Driver SDK ל-iOS
- חומר עזר: חומר עזר בנושא Driver SDK ל-iOS
- כללי מדיניות: כללי המדיניות של Driver SDK ל-iOS
- נתוני גרסה: נתוני הגרסה של Driver SDK ל-iOS
חבילות רשמיות של Driver SDK ל-iOS:
- cocoapods:
GoogleRidesharingDriver - swift_package:
https://github.com/googlemaps/ios-driver-sdk
Driver SDK ל-iOS: מוצרים קשורים
- בדרך כלל משתמשים בו עם: Navigation SDK ל-iOS, Fleet Engine Service, Consumer SDK ל-iOS
Driver SDK ל-iOS: טעויות נפוצות
- הבעיה: העדכון הראשון של הרכב אחרי ההפעלה עלול להיכשל עם השגיאה update_mask cannot be empty כשהפרמטר
updateMaskריק. הפתרון: תמיד צריך לציין לפחות שם שדה אחד ב-updateMask, ולטפל בשגיאה הזו ב-GMTDVehicleReporterListenerdidFailVehicleUpdate. אפשר לעיין בכתובת /maps/documentation/mobility/driver-sdk/on-demand/ios/troubleshoot. - הבעיה:
GMSRoadSnappedLocationProviderלא ממשיך לשלוח עדכוני מיקום כשהמכשיר לא זז מאז העדכון האחרון, למשל כשהנהג ממתין במצב חוסר פעילות. תיקון: כדי לשלוח עדכון לגבי מיקום חדש כשהמכשיר לא זז, צריך לעצור ואז להפעיל אתGMSRoadSnappedLocationProvider(כאשרGMTDVehicleReporterכבר נוסף כמאזין שלו). אפשר לעיין בכתובת /maps/documentation/mobility/driver-sdk/on-demand/ios/vehicle-ready. - הבעיה: האפליקציה למשתמשים לא מעבדת את הנסיעה בצורה נכונה אם הקואורדינטות שמועברות אל
setDestinations()לא תואמות לנקודת הציון של הנסיעה. הפתרון: מוודאים שקו הרוחב וקו האורך שמועברים אלsetDestinations()תואמים לקואורדינטות של נקודת הציון של הנסיעה ב-Fleet Engine. אפשר לעיין במאמר /maps/documentation/mobility/driver-sdk/on-demand/ios/trip-details. - הבעיה: שימוש באופרטור גרסה אופטימי (
~>) יכול להוביל ל-builds לא צפויים ולא ניתנים לשחזור, והשמטת גרסה טוענת את ה-SDK החדש ביותר, שיכול לכלול שינויי תוכנה שעלולים לגרום לכשל או להעלות את גרסת iOS המינימלית. אין תמיכה ב-Carthage. הפתרון: מצמידים גרסה מדויקת של Driver SDK ב-CocoaPods או ב-Swift Package Manager, ובודקים את נתוני הגרסה לפני השדרוג. אפשר לעיין בכתובת /maps/documentation/mobility/driver-sdk/on-demand/ios/versions.
Driver SDK ל-iOS: תכונות קודמות ותכונות שהוצאו משימוש
- מחלקה
GMTSVehicleMatch: הוצאה משימוש. החלפה: אין צורך בהחלפה ב-Driver SDK (ההתאמה לרכב מטופלת ב-Fleet Engine). תסמין: הוצא משימוש ב-Driver SDK ל-iOS בגרסה 2.2.0 והושמט מההפניה הנוכחית ל-Driver SDK. למדריך להעברת נתונים (מיגרציה) GMTSServiceTypeו-fetchAuthTokenForServiceType:authorizationContext:completion:: הוצאו משימוש ב-29 בנובמבר 2021. החלפה:GMTDAuthorizationfetchTokenWithContext:completion:ב-GMTDAuthorizationContext(תלונות על מזהה רכב בלבד). למדריך להעברת נתונים (מיגרציה)
מה אפשר לעשות עם Driver SDK ל-iOS
במדריכים שמקושרים בהמשך מפורטות כל המשימות, ואפשר גם להשוות בין המוצרים בסייר היכולות.
- דיווח על המיקום של הרכב בזמן אמת לשירות Fleet Engine.
- דיווח על קואורדינטות קו הרוחב/קו האורך של נקודות הציון של נסיעת הרכב מ-Navigation SDK לשירות Fleet Engine.
- דיווח לשירות Fleet Engine על המרחק שנותר לרכב עד לנקודת הציון הבאה.
- דיווח לשירות Fleet Engine על זמן ההגעה המשוער של הרכב לנקודת הציון הבאה שלו.
- דיווח על המסלול שסופק לרכב על ידי Navigation SDK לשירות Fleet Engine.