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
- Kimlik doğrulama: API anahtarı, JSON Web Jetonu (JWT)
- Ayrıca şunu da etkinleştirin: iOS için Haritalar SDK'sı
- Başlayın: iOS için Sürücü SDK'sını ayarlama
- Referans: iOS için Sürücü SDK'sı referansı
- Politikalar: iOS için Sürücü SDK'sı politikaları
- Sürüm notları: iOS için Sürücü SDK'sı sürüm notları
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ı: İlgili ürünler
- Genellikle birlikte kullanıldığı ürünler: iOS için Navigation SDK, Fleet Engine hizmeti, iOS için Consumer SDK
iOS için Sürücü SDK'sı: Sık yapılan hatalar
- Sorun: Başlatma işleminden sonraki ilk araç güncellemesi,
updateMaskparametresi boş olduğunda "update_mask boş olamaz" hatasıyla başarısız olabilir. Düzeltme:updateMaskiçinde her zaman en az bir alan adı sağlayın ve bu hatayıGMTDVehicleReporterListenerdidFailVehicleUpdateiç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çinGMSRoadSnappedLocationProviderhizmetini durdurup yeniden başlatın (GMTDVehicleReporterdinleyici 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
GMTSVehicleMatchsı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.GMTSServiceTypevefetchAuthTokenForServiceType:authorizationContext:completion:: 29.11.2021'den beri desteği sonlandırıldı. Değiştirme:GMTDAuthorizationfetchTokenWithContext:completion:,GMTDAuthorizationContextile 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.
- Bir aracın anlık konumunu Fleet Engine hizmetine bildirme
- Navigation SDK'dan Fleet Engine hizmetine bir aracın gezi noktalarının enlem/boylam koordinatlarını bildirin.
- Bir aracın bir sonraki ara noktaya kalan mesafesini Fleet Engine hizmetine bildirin.
- Bir aracın bir sonraki ara noktaya tahmini varış zamanını Fleet Engine hizmetine bildirin.
- Navigation SDK tarafından bir araç için sağlanan rotayı Fleet Engine hizmetine bildirme