iOS için Tüketici SDK'sı hızlı referansı

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

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ı: Sık yapılan hatalar

  • Sorun: JWT, gezi kimliği olmadan imzalandığında veya süresi dolduğunda gezi izleme 401 UNAUTHENTICATED hatası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 400 INVALID_ARGUMENT hatasıyla başarısız oluyor. Düzeltme: Google Cloud proje kimliğini provider_id olarak kullanın ve SDK'yı ilk kullanıma hazırlarken aynı proje kimliğini providerID olarak 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 unregisterSubscriber yö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.bundle ve GoogleRidesharingConsumer.bundle ekleyin, listelenen çerçeveleri bağlayın ve hata ayıklama ile yayınlama için Diğer Bağlayıcı İşaretleri'ne -ObjC ekleyin. /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:, GMTSVehicleLocationOptions ile 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.