באמצעות 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: הגדרה
- אימות: אסימון אינטרנט מסוג JSON (JWT)
- צריך להפעיל גם את: Fleet Engine Service
- תחילת העבודה: הגדרת Consumer SDK ל-iOS
- חומר עזר: חומר עזר בנושא Consumer SDK ל-iOS
- כללי מדיניות: כללי המדיניות של Consumer SDK ל-iOS
- נתוני גרסה: נתוני הגרסה של Consumer SDK ל-iOS
חבילות רשמיות של Consumer SDK ל-iOS:
- cocoapods:
GoogleRidesharingConsumer - swift_package:
https://github.com/googlemaps/ios-consumer-sdk
Consumer SDK ל-iOS: מוצרים קשורים
- בדרך כלל משתמשים בו עם: Fleet Engine Service, Driver SDK ל-iOS, Driver SDK ל-Android, SDK של מפות ל-iOS
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
במדריכים שמקושרים בהמשך מפורטות כל המשימות, ואפשר גם להשוות בין המוצרים בסייר היכולות.
- הוספת מפה אינטראקטיבית שניתן להתאים אישית, שעוקבת אחרי התקדמות הנסיעה מ-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.