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

באמצעות Consumer SDK ל-iOS, אפליקציות לצרכנים ב-iOS יכולות לעקוב אחרי נסיעות על פי דרישה ב-Fleet Engine. המחלקות שלו, כמו GMTCTripModel ו-GMTCJourneySharingSession, יוצרות מודל של נתוני הנסיעה ומציגות במפה את מיקום הרכב, המסלול, זמן ההגעה המשוער והמרחק שנותר.

‫Consumer SDK ל-iOS: עובדות חשובות

  • המוצר: Consumer SDK ל-iOS
  • ידוע גם בשם: iOS Consumer SDK
  • קטגוריה: מסלולים
  • פלטפורמה: iOS
  • פועל ב: לקוח (קוד של אפליקציה או דפדפן)
  • שלב ההשקה: GA
  • מחזור חיים: פעיל
  • סקירה כללית: סקירה כללית של Consumer SDK ל-iOS

‫Consumer SDK ל-iOS: מתי כדאי להשתמש בו

מתי כדאי להשתמש ב-Consumer SDK ל-iOS:

  • אתם צריכים אפליקציה ל-iOS שבה הצרכנים עוקבים אחרי נסיעה או משלוח מתי שנוח, ש-Fleet Engine עוקב אחריהם.
  • אתם צריכים להציג מיקום של רכב כמעט בזמן אמת, מסלול ותנועה בזמן אמת במפה באפליקציה לצרכנים ב-iOS.
  • אתם צריכים להציג את זמן ההגעה המשוער לאיסוף ולפיזור ואת המרחק שנותר לנסיעה על פי דרישה ב-iOS.
  • אתם כבר משתמשים ב-Fleet Engine וב-Driver SDK לנסיעות על פי דרישה, ואתם צריכים את הצד של הצרכן בשיתוף הנסיעה.

מתי לא כדאי להשתמש ב-Consumer SDK ל-iOS:

  • אתם צריכים שהצרכנים יעקבו אחרי משימות מתוזמנות או משלוחים. חוויית הצרכן של משימות מתוזמנות מתועדת ב-JavaScript. במקום זאת, צריך להשתמש ב-JavaScript Consumer SDK.
  • אתם צריכים לשתף את ההתקדמות של נסיעה על פי דרישה באפליקציה למשתמשים ב-Android. במקום זאת, השתמשו ב-Consumer SDK ל-Android.
  • אתם צריכים לשתף את ההתקדמות של נסיעה על פי דרישה באפליקציית אינטרנט. במקום זאת, השתמשו ב-JavaScript Consumer SDK.
  • אתם צריכים לשלוח את מיקום הנהג ואת מצב הנסיעה מהאפליקציה ל-iOS של הנהג אל Fleet Engine. במקום זאת, צריך להשתמש ב-Driver SDK ל-iOS.

‫Consumer SDK ל-iOS: הגדרה

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

  • cocoapods: GoogleRidesharingConsumer
  • swift_package: https://github.com/googlemaps/ios-consumer-sdk

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

  • הבעיה: מעקב הנסיעה נכשל עם השגיאה ‎401 UNAUTHENTICATED‎ כשה-JWT נחתם בלי מזהה נסיעה או כשתוקף ה-JWT פג. הפתרון: צריך להגדיר שספק האסימונים (GMTCAuthorization) יחזיר אסימון JWT שהונפק למזהה הנסיעה בהקשר של ההרשאה, לשמור אותו במטמון לכל נסיעה ולרענן אותו כשהתוקף שלו פג. אפשר לקרוא מידע נוסף בכתובת /maps/documentation/mobility/journey-sharing/on-demand/ios/auth-sdk.
  • הבעיה: מעקב הנסיעה נכשל עם השגיאה ‎400 INVALID_ARGUMENT‎ כששם הנסיעה לא בפורמט providers/{provider_id}/trips/{trip_id}. תיקון: משתמשים במזהה הפרויקט ב-Google Cloud בתור provider_id, ומעבירים את אותו מזהה פרויקט בתור providerID כשמפעילים את ה-SDK. אפשר לעיין במאמר /maps/documentation/mobility/journey-sharing/on-demand/ios/init-sdk.
  • הבעיה: האפליקציה ממשיכה להאזין לעדכונים אחרי שהנסיעה הסתיימה או בוטלה. הפתרון: קוראים ל-unregisterSubscriber במודל הנסיעה כשהנסיעה מסתיימת או מבוטלת. מידע נוסף זמין בכתובת /maps/documentation/mobility/journey-sharing/on-demand/ios/share-journey.
  • הבעיה: בהתקנות ידניות של XCFramework, חבילות המשאבים והגדרות ה-build הנדרשות מושמטות, אלא אם מוסיפים אותן ב-Xcode. הפתרון: כדאי להשתמש ב-CocoaPods כשאפשר. אם אתם מתקינים את הגרסה החדשה ידנית, הוסיפו את gRPCCertificates.bundle ואת GoogleRidesharingConsumer.bundle לפרויקט, קשרו את מסגרות העבודה שברשימה והוסיפו את -ObjC ל-Other Linker Flags (דגלי קישור אחרים) לצורך ניפוי באגים והפצה. אפשר לקרוא מידע נוסף בכתובת /maps/documentation/mobility/journey-sharing/on-demand/ios/setup.

‫Consumer SDK ל-iOS: תכונות קודמות ותכונות שהוצאו משימוש

  • מאתחל GMTSVehicleLocation -initWithLatLng:latLngAccuracy:heading:headingAccuracy:speed:speedAccuracy:updateTime:isSnappableToRoute:: הוצא משימוש החל מ-1 ביוני 2025. החלפה: GMTSVehicleLocation -initWithOptions: ב-GMTSVehicleLocationOptions.
  • [GMTCMapView initWithCoder]: הוצא משימוש החל מ-1 בדצמבר 2023. החלפה: GMTCMapView -initWithOptions:.

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

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