iOS için Tüketici SDK'sı, iOS tüketici uygulamalarının Fleet Engine'deki seç-izle gezileri takip etmesine olanak tanır. GMTCTripModel ve GMTCJourneySharingSession gibi sınıfları, gezi verilerini modeller ve aracın konumunu, rotasını, TVS'sini ve kalan mesafeyi haritada gösterir.
iOS için Tüketici SDK'sı: Önemli bilgiler
- Ürün: iOS için Tüketici SDK'sı
- Diğer adları: iOS Tüketici SDK'sı
- Kategori: Rotalar
- Platform: iOS
- Çalıştığı yer: İstemci (uygulama veya tarayıcı kodu)
- Lansman aşaması: GA
- Yaşam döngüsü: Etkin
- Genel bakış: iOS için Tüketici SDK'sına genel bakış
iOS için Tüketici SDK'sı: Ne zaman kullanılır?
iOS için Tüketici SDK'sını şu durumlarda kullanın:
- Tüketicilerin, Fleet Engine'ın takip ettiği seç-izle bir yolculuğu veya teslimat gezisini takip ettiği bir iOS uygulamasına ihtiyacınız vardır.
- Bir iOS tüketici uygulamasında bir aracın neredeyse gerçek zamanlı konumunu, rotasını ve canlı trafiğini haritada göstermeniz gerekiyor.
- iOS'te talep üzerine gezi için teslim alma ve bırakma TVS'sini ve kalan mesafeyi göstermeniz gerekir.
- Talep üzerine geziler için Fleet Engine ve Driver SDK'yı kullanıyorsunuz ve yolculuk paylaşımının tüketici tarafına ihtiyacınız var.
iOS için Tüketici SDK'sını aşağıdaki durumlarda kullanmayın:
- Tüketicilerin, planlanmış görevleri veya gönderileri takip etmesi gerekir. Planlanmış görevler tüketici deneyimi, JavaScript için belgelenmiştir. Bunun yerine JavaScript Tüketici SDK'sını kullanın.
- Android tüketici uygulamasında isteğe bağlı gezi ilerleme durumunu paylaşmanız gerekiyorsa Android için Tüketici SDK'sı'nı kullanın.
- Talep üzerine gezi ilerleme durumunu bir web uygulamasında paylaşmanız gerekiyorsa JavaScript Consumer SDK'yı kullanın.
- Sürücünün konumunu ve seyahat durumunu sürücünün iOS uygulamasından Fleet Engine'e göndermeniz gerekir. Bunun yerine iOS için Sürücü SDK'sı'nı kullanın.
iOS için Tüketici SDK'sı: kurulum
- Kimlik doğrulama: JSON Web Jetonu (JWT)
- Şunu da etkinleştirin: Fleet Engine Hizmeti
- Başlayın: iOS için Tüketici SDK'sını ayarlama
- Referans: iOS için Tüketici SDK'sı referansı
- Politikalar: iOS için Tüketici SDK'sı politikaları
- Sürüm notları: iOS için Tüketici SDK'sı sürüm notları
iOS paketleri için resmi Tüketici SDK'sı:
- cocoapods:
GoogleRidesharingConsumer - swift_package:
https://github.com/googlemaps/ios-consumer-sdk
iOS için Tüketici SDK'sı: İlgili ürünler
- Genellikle birlikte kullanıldığı ürünler: Fleet Engine hizmeti, iOS için Sürücü SDK'sı, Android için Sürücü SDK'sı, iOS için Haritalar SDK'sı
iOS için Tüketici SDK'sı: Sık yapılan hatalar
- Sorun: JWT, gezi kimliği olmadan imzalandığında veya süresi dolduğunda gezi izleme 401
UNAUTHENTICATEDhatasıyla başarısız oluyor. Düzeltme: Jeton sağlayıcınızın (GMTCAuthorization), yetkilendirme bağlamında gezi kimliği için verilen bir JWT döndürmesini, bunu gezi başına önbelleğe almasını ve süresi dolduğunda yenilemesini sağlayın. /maps/documentation/mobility/journey-sharing/on-demand/ios/auth-sdk adresini inceleyin. - Sorun: Gezi adı
providers/{provider_id}/trips/{trip_id}biçimini kullanmadığında gezi izleme 400INVALID_ARGUMENThatasıyla başarısız oluyor. Düzeltme: Google Cloud proje kimliğiniprovider_idolarak kullanın ve SDK'yı ilk kullanıma hazırlarken aynı proje kimliğiniproviderIDolarak iletin. /maps/documentation/mobility/journey-sharing/on-demand/ios/init-sdk adresini ziyaret edin. - Sorun: Uygulama, bir gezi tamamlandıktan veya iptal edildikten sonra güncellemeleri dinlemeye devam ediyor. Düzeltme: Gezi tamamlandığında veya iptal edildiğinde gezi modelinde
unregisterSubscriberyöntemini çağırın. /maps/documentation/mobility/journey-sharing/on-demand/ios/share-journey adresini ziyaret edin. - Sorun: Manuel XCFramework yüklemelerinde, Xcode'a eklemediğiniz sürece gerekli kaynak paketleri ve derleme ayarları atlanır. Çözüm: Mümkün olduğunda CocoaPods kullanın. Manuel yüklemeler için projeye
gRPCCertificates.bundleveGoogleRidesharingConsumer.bundleekleyin, listelenen çerçeveleri bağlayın ve hata ayıklama ile yayınlama için Diğer Bağlayıcı İşaretleri'ne-ObjCekleyin. /maps/documentation/mobility/journey-sharing/on-demand/ios/setup adresini ziyaret edin.
iOS için Tüketici SDK'sı: eski ve desteği sonlandırılmış özellikler
GMTSVehicleLocation-initWithLatLng:latLngAccuracy:heading:headingAccuracy:speed:speedAccuracy:updateTime:isSnappableToRoute:başlatıcı: 01.06.2025'ten itibaren desteği sonlandırıldı. Değiştirme:GMTSVehicleLocation-initWithOptions:,GMTSVehicleLocationOptionsile değiştirildi.[GMTCMapView initWithCoder]: 01.12.2023 tarihinden itibaren desteği sonlandırılmıştır. Değiştirme:GMTCMapView-initWithOptions:.
iOS için Tüketici SDK'sı ile yapabilecekleriniz
Her görev için aşağıda bağlantısı verilen kılavuzlara bakın veya Özellikler Gezgini'nde ürünleri karşılaştırın.
- Fleet Engine'den mobil uygulamaya bir seyahatin ilerleme durumunu izleyen özelleştirilebilir, etkileşimli bir harita ekleyin.
- Fleet Engine'den bir web sayfasındaki veya mobil uygulamadaki haritaya bir geziyi izleyen rota çoklu çizgisi ekleyin.
- Fleet Engine gezisi için bir web sayfasındaki veya mobil uygulamadaki haritada rota boyunca gezi ilerleme durumunu güncelleme
- Fleet Engine'den bir gezinin ilerleme durumunu izleyen bir haritadaki yolların, çoklu çizgilerin ve poligonların stilini değiştirme
- Fleet Engine'dan bir gezinin ilerleme durumunu izleyen bir haritada harita özelliklerini gösterme veya gizleme
- Fleet Engine'dan bir gezinin ilerleme durumunu izleyen haritadaki simgelerin ve metin etiketlerinin stilini değiştirme
- Fleet Engine'dan bir gezinin ilerleme durumunu izleyen bir haritada farklı yakınlaştırma seviyelerine farklı harita stilleri uygulayın.
- Fleet Engine'den bir gezinin ilerleme durumunu izleyen haritadaki yerlerin yoğunluğunu değiştirme Deneysel Not: Tüketici SDK'sındaki bulut tabanlı harita stilleri desteği GA'dır. ÖY yoğunluk kontrolü ise deneysel bir bulut tabanlı harita stilleri özelliğidir (yalnızca açık renkli harita stillerinde desteklenir).
- Fleet Engine'dan bir gezinin ilerleme durumunu izleyen haritadaki binaların stilini değiştirme Deneysel Not: Tüketici SDK'sındaki bulut tabanlı harita stilleri desteği genel kullanıma sunulmuştur. 3D ve bina taban alanı stil özelleştirmesi ise deneysel bir bulut tabanlı harita stilleri özelliğidir (yalnızca açık renkli harita stillerinde desteklenir).
- Fleet Engine'den bir gezinin ilerleme durumunu izleyen bir haritadaki önemli noktaların stilini değiştirme Deneysel Not: Tüketici SDK'sındaki bulut tabanlı harita stilleri desteği genel kullanıma sunulmuştur. Önemli nokta simgesi özelleştirme ise deneysel bir bulut tabanlı harita stilleri özelliğidir (yalnızca açık renkli harita stillerinde desteklenir).
- Fleet Engine'den bir seyahatin ilerleme durumunu izleyen bir haritadaki işaretçiyi özelleştirme
- Fleet Engine'dan bir gezinin ilerleme durumunu izleyen bir haritada rota çoklu çizgisini özelleştirme