مرجع سریع کیت توسعه نرم‌افزار راننده برای iOS

کیت توسعه نرم‌افزار Driver برای iOS یک جعبه‌ابزار برنامه تلفن همراه و مؤلفه‌ای از Fleet Engine است. این سرویس مکان خودرو، مسیر، نقطه‌مسیرها، مسافت باقی‌مانده، و زمان تخمینی رسیدن برنامه راننده را از Navigation SDK به Fleet Engine ارسال می‌کند تا برای سفرهای درخواستی و کارهای زمان‌بندی‌شده استفاده شود.

کیت توسعه نرم‌افزار راننده برای iOS: حقایق کلیدی

  • محصول: کیت توسعه نرم‌افزار راننده برای iOS
  • با این نام‌ها نیز شناخته می‌شود: کیت توسعه نرم‌افزار راننده، کیت توسعه نرم‌افزار راننده برای سفرهای درخواستی، کیت توسعه نرم‌افزار راننده برای کارهای زمان‌بندی‌شده
  • دسته: مسیرها
  • پلاتفرم: iOS
  • اجرا در: کارخواه (کد برنامه یا مرورگر)
  • مرحله راه‌اندازی: GA
  • چرخه حیات: فعال
  • نمای کلی: نمای کلی کیت توسعه نرم‌افزار راننده برای iOS

کیت توسعه نرم‌افزار راننده برای iOS: زمان استفاده از آن

در شرایط زیر از Driver SDK for iOS استفاده کنید:

  • برای ارسال به‌روزرسانی‌های هم‌زمان مکان خودرو به Fleet Engine، به برنامه راننده iOS نیاز دارید.
  • باید مسیر، نقطه‌مسیرها، مسافت باقی‌مانده، و زمان تخمینی رسیدن را از Navigation SDK به Fleet Engine گزارش کنید.
  • به رانندگانی نیاز دارید که سفرهای درخواستی واگذارشده را مدیریت کنند و در یک برنامه بدون جابه‌جایی بین برنامه‌ها پیمایش کنند.
  • شما درحال ساختن برنامه راننده برای تکالیف زمان‌بندی‌شده Fleet Engine در iOS هستید.

در موارد زیر از «کیت توسعه نرم‌افزار راننده» برای iOS استفاده نکنید:

کیت توسعه نرم‌افزار راننده برای iOS: راه‌اندازی

بسته‌های رسمی کیت توسعه نرم‌افزار Driver برای iOS:

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

کیت توسعه نرم‌افزار راننده برای iOS: اشتباهات رایج

  • مشکل: اولین به‌روزرسانی خودرو پس‌از راه‌اندازی ممکن است با خطای «update_mask نمی‌تواند خالی باشد» مواجه شود، وقتی پارامتر updateMask خالی باشد. اصلاح: همیشه حداقل یک نام فیلد در updateMask ارائه دهید و این خطا را در GMTDVehicleReporterListener didFailVehicleUpdate مدیریت کنید. /maps/documentation/mobility/driver-sdk/on-demand/ios/troubleshoot را ببینید.
  • مشکل: وقتی دستگاه از آخرین به‌روزرسانی جابه‌جا نشده باشد، برای مثال وقتی راننده در حالت آماده‌به‌کار منتظر است، GMSRoadSnappedLocationProvider ارسال به‌روزرسانی‌های مکان را ادامه نمی‌دهد. اصلاح: برای ارسال به‌روزرسانی مکان جدید درحالی‌که دستگاه ثابت است، GMSRoadSnappedLocationProvider را متوقف و سپس شروع کنید (درحالی‌که GMTDVehicleReporter قبلاً به‌عنوان شنونده آن اضافه شده است). /maps/documentation/mobility/driver-sdk/on-demand/ios/vehicle-ready را ببینید.
  • مشکل: اگر مختصات ارسال‌شده به setDestinations() با نقطه‌مسیر سفر مطابقت نداشته باشد، برنامه مصرف‌کننده سفر را به‌درستی ارائه نمی‌کند. راه‌حل: مطمئن شوید عرض/طول جغرافیایی ارسال‌شده به setDestinations() با مختصات نقطه‌مسیر سفر در Fleet Engine مطابقت داشته باشد. /maps/documentation/mobility/driver-sdk/on-demand/ios/trip-details را ببینید.
  • مشکل: استفاده از عملگر نسخه خوش‌بینانه (~>) می‌تواند به ساخت‌های غیرقابل‌پیش‌بینی و غیرقابل‌تکرار منجر شود و حذف نسخه باعث بار شدن جدیدترین کیت توسعه نرم‌افزار می‌شود که می‌تواند شامل تغییرات مخرب باشد یا حداقل نسخه iOS را افزایش دهد. Carthage پشتیبانی نمی‌شود. راه‌حل: نسخه دقیق Driver SDK را در CocoaPods یا Swift Package Manager سنجاق کنید و قبل‌از ارتقا دادن، یادداشت‌های انتشار را بررسی کنید. /maps/documentation/mobility/driver-sdk/on-demand/ios/versions را ببینید.

کیت توسعه نرم‌افزار راننده برای iOS: ویژگی‌های قدیمی و منسوخ‌شده

  • کلاس GMTSVehicleMatch: منسوخ‌شده. جایگزین: در Driver SDK به جایگزین نیاز نیست (تطبیق خودرو در Fleet Engine انجام می‌شود). نشانه: در «کیت توسعه نرم‌افزار راننده» برای iOS نسخه ۲.۲.۰ منسوخ شده است و از مرجع فعلی «کیت توسعه نرم‌افزار راننده» حذف شده است. راهنمای انتقال را ببینید.
  • GMTSServiceType و fetchAuthTokenForServiceType:authorizationContext:completion:: از ۲۰۲۱/۱۱/۲۹ منسوخ شده است. جایگزینی: GMTDAuthorization fetchTokenWithContext:completion: با GMTDAuthorizationContext (فقط ادعاهای مربوط به شناسه خودرو). راهنمای انتقال را ببینید.

کارهایی که می‌توانید با Driver SDK ویژه iOS انجام دهید

برای هر تکلیف، راهنماهای پیوندشده در زیر را ببینید یا محصولات را در کاوشگر قابلیت‌ها با یکدیگر مقایسه کنید.