iOS için Sürücü SDK'sı hızlı referansı

iOS için Sürücü SDK'sı, mobil uygulama araç seti ve Fleet Engine'in bir bileşenidir. Talep üzerine yapılan geziler ve planlanmış görevler için sürücü uygulamasının araç konumunu, rotasını, ara noktalarını, kalan mesafesini ve TVS'sini Navigasyon SDK'sından Fleet Engine'e gönderir.

iOS için Sürücü SDK'sı: Temel bilgiler

  • Ürün: iOS için Sürücü SDK'sı
  • Diğer adları: Sürücü SDK'sı, seç-izle geziler için Sürücü SDK'sı, planlanmış görevler için Sürücü 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 Sürücü SDK'sına genel bakış

iOS için Sürücü SDK'sı: Ne zaman kullanılır?

iOS için Sürücü SDK'sını şu durumlarda kullanın:

  • Fleet Engine'e gerçek zamanlı araç konumu güncellemeleri göndermek için bir iOS sürücü uygulamasına ihtiyacınız vardır.
  • Navigation SDK'dan Fleet Engine'e rotayı, ara noktaları, kalan mesafeyi ve TVS'yi bildirmeniz gerekir.
  • Sürücülerinizin, atanan isteğe bağlı gezileri yönetmek ve uygulama değiştirmeden tek bir uygulamada gezinmek için bir uygulamaya ihtiyacı vardır.
  • iOS'te Fleet Engine planlanmış görevleri için bir sürücü uygulaması geliştiriyorsunuz.

iOS için Sürücü SDK'sını şu durumlarda kullanmayın:

  • iOS uygulamanızda Fleet Engine takibi olmadan yalnızca adım adım rota özelliğine ihtiyacınız varsa Bunun yerine iOS için Navigasyon SDK'sını kullanın.
  • Yolcuya veya müşteriye bir tüketici uygulamasında yolculuk ya da teslimat ilerleme durumunu göstermeniz gerekir. Bunun yerine iOS için Consumer SDK'yı kullanın.
  • Konum ve rota dışındaki araç verisi güncellemelerini göndermeniz gerekir. Bu güncellemeler, arka ucunuz üzerinden Fleet Engine'e gönderilir. Bunun yerine Fleet Engine hizmetini kullanın.
  • Sürücü uygulamanız Android'de çalışır. Bunun yerine Android için Sürücü SDK'sını kullanın.

iOS için Sürücü SDK'sı: kurulum

iOS paketleri için resmi Sürücü SDK'sı:

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

iOS için Sürücü SDK'sı: Sık yapılan hatalar

  • Sorun: Başlatma işleminden sonraki ilk araç güncellemesi, updateMask parametresi boş olduğunda "update_mask boş olamaz" hatasıyla başarısız olabilir. Düzeltme: updateMask içinde her zaman en az bir alan adı sağlayın ve bu hatayı GMTDVehicleReporterListener didFailVehicleUpdate içinde düzeltin. /maps/documentation/mobility/driver-sdk/on-demand/ios/troubleshoot adresini ziyaret edin.
  • Sorun: GMSRoadSnappedLocationProvider, cihaz son güncellemeden sonra hareket etmediğinde (ör. sürücü boşta beklerken) konum güncellemeleri göndermeye devam etmez. Düzeltme: Cihaz sabitken yeni bir konum güncellemesi göndermek için GMSRoadSnappedLocationProvider hizmetini durdurup yeniden başlatın (GMTDVehicleReporter dinleyici olarak eklenmişken). /maps/documentation/mobility/driver-sdk/on-demand/ios/vehicle-ready sayfasına bakın.
  • Sorun: setDestinations() yöntemine iletilen koordinatlar gezinin yol noktasıyla eşleşmiyorsa tüketici uygulaması geziyi doğru şekilde oluşturmaz. Düzeltme: setDestinations() öğesine iletilen enlem/boylam değerlerinin Fleet Engine'deki gezi ara noktası koordinatlarıyla eşleştiğinden emin olun. /maps/documentation/mobility/driver-sdk/on-demand/ios/trip-details adresini inceleyin.
  • Sorun: İyimser sürüm operatörü (~>) kullanmak, öngörülemeyen ve tekrarlanamayan derlemelere yol açabilir. Sürüm belirtilmediğinde ise en yeni SDK yüklenir. Bu da zarar veren değişiklikler içerebilir veya minimum iOS sürümünü yükseltebilir. Carthage desteklenmez. Düzeltme: CocoaPods veya Swift Package Manager'da tam bir Driver SDK sürümünü sabitleyin ve yükseltmeden önce sürüm notlarını kontrol edin. /maps/documentation/mobility/driver-sdk/on-demand/ios/versions sayfasına bakın.

iOS için Sürücü SDK'sı: eski ve desteği sonlandırılmış özellikler

  • GMTSVehicleMatch sınıfı: Kullanımdan kaldırıldı. Değişiklik: Driver SDK'da değişiklik yapılması gerekmez (araç eşleştirme işlemi Fleet Engine'da gerçekleştirilir). Belirti: iOS için Sürücü SDK'sı 2.2.0 sürümünde desteği sonlandırıldı ve mevcut Sürücü SDK'sı referansından çıkarıldı. Geçiş rehberini inceleyin.
  • GMTSServiceType ve fetchAuthTokenForServiceType:authorizationContext:completion:: 29.11.2021'den beri desteği sonlandırıldı. Değiştirme: GMTDAuthorization fetchTokenWithContext:completion:, GMTDAuthorizationContext ile değiştirilir (yalnızca araç kimliğiyle ilgili hak talepleri). Geçiş rehberini inceleyin.

iOS için Sürücü 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.