מדריך מקוצר ל-Driver SDK ל-iOS

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

חבילות רשמיות של Driver SDK ל-iOS:

  • cocoapods: GoogleRidesharingDriver
  • swift_package: https://github.com/googlemaps/ios-driver-sdk

‫Driver SDK ל-iOS: טעויות נפוצות

  • הבעיה: העדכון הראשון של הרכב אחרי ההפעלה עלול להיכשל עם השגיאה update_mask cannot be empty כשהפרמטר updateMask ריק. הפתרון: תמיד צריך לציין לפחות שם שדה אחד ב-updateMask, ולטפל בשגיאה הזו ב-GMTDVehicleReporterListener didFailVehicleUpdate. אפשר לעיין בכתובת /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. החלפה: GMTDAuthorization fetchTokenWithContext:completion: ב-GMTDAuthorizationContext (תלונות על מזהה רכב בלבד). למדריך להעברת נתונים (מיגרציה)

מה אפשר לעשות עם Driver SDK ל-iOS

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