کیت توسعه نرمافزار 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 خود نیاز دارید، بدون ردیابی Fleet Engine. درعوض از کیت توسعه نرمافزار ناوبری برای iOS استفاده کنید.
- باید پیشرفت سفر یا ارسال را به مسافر یا مشتری در برنامه مصرفکننده نشان دهید. بهجای آن از کیت توسعه نرمافزار مصرفکننده برای iOS استفاده کنید.
- باید بهروزرسانیهای دادههای خودرو را بهغیراز مکان و مسیر ارسال کنید؛ این بهروزرسانیها ازطریق پسای شما به Fleet Engine میروند. درعوض از سرویس Fleet Engine استفاده کنید.
- برنامه راننده شما در Android اجرا میشود. درعوض از کیت توسعه نرمافزار Driver برای Android استفاده کنید.
کیت توسعه نرمافزار راننده برای iOS: راهاندازی
- اصالتسنجی: کلید میانای برنامهسازی کاربردی، JSON Web Token (JWT)
- همچنین فعال کنید: کیت توسعه نرمافزار Google Maps برای iOS
- شروع به کار: راهاندازی Driver SDK برای iOS
- مرجع: مرجع کیت توسعه نرمافزار راننده برای iOS
- خطمشیها: خطمشیهای کیت توسعه نرمافزار راننده برای iOS
- یادداشتهای انتشار: یادداشتهای انتشار کیت توسعه نرمافزار راننده برای iOS
بستههای رسمی کیت توسعه نرمافزار Driver برای iOS:
- cocoapods:
GoogleRidesharingDriver - swift_package:
https://github.com/googlemaps/ios-driver-sdk
کیت توسعه نرمافزار راننده برای iOS: محصولات مرتبط
- اغلب با این موارد استفاده میشود: کیت توسعه نرمافزار پیمایش برای iOS، سرویس Fleet Engine، کیت توسعه نرمافزار مصرفکننده برای iOS
کیت توسعه نرمافزار راننده برای iOS: اشتباهات رایج
- مشکل: اولین بهروزرسانی خودرو پساز راهاندازی ممکن است با خطای «update_mask نمیتواند خالی باشد» مواجه شود، وقتی پارامتر
updateMaskخالی باشد. اصلاح: همیشه حداقل یک نام فیلد درupdateMaskارائه دهید و این خطا را درGMTDVehicleReporterListenerdidFailVehicleUpdateمدیریت کنید. /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:: از ۲۰۲۱/۱۱/۲۹ منسوخ شده است. جایگزینی:GMTDAuthorizationfetchTokenWithContext:completion:باGMTDAuthorizationContext(فقط ادعاهای مربوط به شناسه خودرو). راهنمای انتقال را ببینید.
کارهایی که میتوانید با Driver SDK ویژه iOS انجام دهید
برای هر تکلیف، راهنماهای پیوندشده در زیر را ببینید یا محصولات را در کاوشگر قابلیتها با یکدیگر مقایسه کنید.
- موقعیت همزمان خودرو را به سرویس Fleet Engine گزارش کنید.
- مختصات طول/عرض جغرافیایی نقاطمسیر سفر خودرو را از Navigation SDK به سرویس Fleet Engine گزارش کنید.
- فاصله باقیمانده خودرو تا نقطهمسیر بعدی را به سرویس Fleet Engine گزارش کنید.
- زمان برآوردی ورود خودرو به نقطهمسیر بعدی را به سرویس Fleet Engine گزارش کنید.
- مسیر ارائهشده برای خودرو توسط Navigation SDK را به سرویس Fleet Engine گزارش دهید.