کیت توسعه نرمافزار مصرفکننده برای iOS به برنامههای مصرفکننده iOS اجازه میدهد سفرهای درخواستی را در Fleet Engine دنبال کنند. کلاسهای آن، مثل GMTCTripModel و GMTCJourneySharingSession، دادههای سفر را مدلسازی میکنند و مکان خودرو، مسیر، زمان تخمینی ورود، و مسافت باقیمانده را روی نقشه نشان میدهند.
کیت توسعه نرمافزار مصرفکننده برای iOS: حقایق کلیدی
- محصول: کیت توسعه نرمافزار مصرفکننده برای iOS
- همچنین با این نام شناخته میشود: کیت توسعه نرمافزار مصرفکننده iOS
- دسته: مسیرها
- پلاتفرم: iOS
- اجرا در: کارخواه (کد برنامه یا مرورگر)
- مرحله راهاندازی: GA
- چرخه حیات: فعال
- نمای کلی: نمای کلی کیت توسعه نرمافزار مصرفکننده برای iOS
کیت توسعه نرمافزار مصرفکننده برای iOS: زمان استفاده از آن
در موارد زیر از «کیت توسعه نرمافزار مصرفکننده» برای iOS استفاده کنید:
- به برنامه iOS نیاز دارید که در آن مصرفکنندگان سفر درخواستی یا سفر تحویل را که Fleet Engine ردیابی میکند دنبال کنند.
- باید مکان تقریباً همزمان، مسیر، و ترافیک زنده خودرو را در نقشه در برنامه مصرفکننده iOS نشان دهید.
- باید زمان تخمینی رسیدن برای سوار کردن و پیاده کردن و فاصله باقیمانده را برای سفر درخواستی در iOS نشان دهید.
- درحالحاضر از Fleet Engine و Driver SDK برای سفرهای درخواستی استفاده میکنید و به بخش مصرفکننده همرسانی سفر نیاز دارید.
در موارد زیر از «کیت توسعه نرمافزار مصرفکننده» برای iOS استفاده نکنید:
- باید مصرفکنندگان را ملزم کنید تا کارهای زمانبندیشده یا محمولهها را دنبال کنند؛ تجربه مصرفکننده کارهای زمانبندیشده برای جاوا اسکریپت مستند شده است. درعوض از کیت توسعه نرمافزار مصرفکننده جاوا اسکریپت استفاده کنید.
- باید پیشرفت سفر درخواستی را در برنامه مصرفکننده Android همرسانی کنید. درعوض، از کیت توسعه نرمافزار مصرفکننده برای Android استفاده کنید.
- باید پیشرفت سفر درخواستی را در برنامه وب همرسانی کنید. درعوض از کیت توسعه نرمافزار مصرفکننده جاوا اسکریپت استفاده کنید.
- باید مکان راننده و وضعیت سفر را از برنامه iOS راننده به Fleet Engine ارسال کنید. درعوض از کیت توسعه نرمافزار Driver برای iOS استفاده کنید.
کیت توسعه نرمافزار مصرفکننده برای iOS: راهاندازی
- اصالتسنجی: JSON Web Token (JWT)
- این مورد را هم فعال کنید: سرویس Fleet Engine
- شروع به کار: راهاندازی کیت توسعه نرمافزار مصرفکننده برای iOS
- مرجع: مرجع کیت توسعه نرمافزار مصرفکننده برای iOS
- خطمشیها: خطمشیهای کیت توسعه نرمافزار مصرفکننده برای iOS
- یادداشتهای انتشار: یادداشتهای انتشار کیت توسعه نرمافزار مصرفکننده برای iOS
بستههای رسمی کیت توسعه نرمافزار مصرفکننده برای iOS:
- cocoapods:
GoogleRidesharingConsumer - swift_package:
https://github.com/googlemaps/ios-consumer-sdk
کیت توسعه نرمافزار مصرفکننده برای iOS: محصولات مرتبط
- اغلب با این موارد استفاده میشود: سرویس Fleet Engine، کیت توسعه نرمافزار Driver برای iOS، کیت توسعه نرمافزار Driver برای Android، کیت توسعه نرمافزار Maps برای iOS
کیت توسعه نرمافزار مصرفکننده برای iOS: اشتباهات رایج
- مشکل: اگر JWT بدون شناسه سفر امضا شده باشد یا منقضی شده باشد، پایش سفر با خطای 401
UNAUTHENTICATEDناموفق میشود. راهحل: از ارائهدهنده کدتان (GMTCAuthorization) بخواهید یک JWT صادرشده برای شناسه سفر در بافت مجوز برگرداند، آن را برای هر سفر ذخیره کند، و وقتی منقضی شد آن را بازآوری کند. /maps/documentation/mobility/journey-sharing/on-demand/ios/auth-sdk را ببینید. - مشکل: اگر نام سفر از قالب
providers/{provider_id}/trips/{trip_id}استفاده نکند، پایش سفر با خطای ۴۰۰INVALID_ARGUMENTناموفق میشود. رفع مشکل: از شناسه پروژه Google Cloud بهعنوانprovider_idاستفاده کنید و همان شناسه پروژه را بهعنوانproviderIDهنگام مقداردهی اولیه کیت توسعه نرمافزار ارسال کنید. /maps/documentation/mobility/journey-sharing/on-demand/ios/init-sdk را ببینید. - مشکل: برنامه پساز تکمیل یا لغو سفر همچنان منتظر بهروزرسانیها میماند. اصلاح: وقتی سفر تکمیل یا لغو شد،
unregisterSubscriberرا در مدل سفر فراخوانی کنید. /maps/documentation/mobility/journey-sharing/on-demand/ios/share-journey را ببینید. - مشکل: نصبهای دستی XCFramework بستههای منابع و تنظیمات ساخت موردنیاز را حذف میکنند، مگراینکه آنها را در Xcode اضافه کنید. راهحل: هرجا میتوانید از CocoaPods استفاده کنید. برای نصبهای دستی،
gRPCCertificates.bundleوGoogleRidesharingConsumer.bundleرا به پروژه اضافه کنید، چارچوبهای فهرستشده را پیوند دهید، و-ObjCرا به «سایر پرچمهای پیونددهنده» برای اشکالزدایی و انتشار اضافه کنید. /maps/documentation/mobility/journey-sharing/on-demand/ios/setup را ببینید.
کیت توسعه نرمافزار مصرفکننده برای iOS: ویژگیهای قدیمی و منسوخشده
GMTSVehicleLocation-initWithLatLng:latLngAccuracy:heading:headingAccuracy:speed:speedAccuracy:updateTime:isSnappableToRoute:مقداردهی اولیه: منسوخشده از ۲۰۲۵-۰۶-۰۱. جایگزینی:GMTSVehicleLocation-initWithOptions:باGMTSVehicleLocationOptions.[GMTCMapView initWithCoder]: منسوخشده از ۲۰۲۳/۱۲/۰۱. جایگزینی:GMTCMapView-initWithOptions:.
کارهایی که میتوانید با کیت توسعه نرمافزار مصرفکننده برای iOS انجام دهید
برای هر تکلیف، راهنماهای پیوندشده در زیر را ببینید یا محصولات را در کاوشگر قابلیتها با یکدیگر مقایسه کنید.
- نقشه تعاملی و قابلسفارشیسازی اضافه کنید که پیشرفت سفر را از Fleet Engine به برنامه تلفن همراه ردیابی میکند.
- چندخطی مسیری را که سفر را از Fleet Engine به نقشهای در صفحه وب یا برنامه تلفن همراه ردیابی میکند اضافه کنید.
- پیشرفت سفر را درطول مسیر در نقشهای در صفحه وب یا برنامه تلفن همراه برای سفر Fleet Engine بهروز کنید.
- سبک جادهها، چندخطیها، و چندضلعیها را در نقشهای که پیشرفت سفر را از Fleet Engine ردیابی میکند تغییر دهید.
- نمایش یا پنهان کردن ویژگیهای نقشه در نقشهای که پیشرفت سفر را از Fleet Engine ردیابی میکند.
- تغییر سبک نمادها و برچسبهای نوشتاری در نقشهای که پیشرفت سفر را از Fleet Engine ردیابی میکند.
- اعمال سبکهای مختلف نقشه در سطوح بزرگنمایی مختلف روی نقشهای که پیشرفت سفر را از Fleet Engine ردیابی میکند.
- تغییر دادن تراکم مکانها در نقشهای که پیشرفت سفر را از Fleet Engine ردیابی میکند. آزمایشی توجه: پشتیبانی از «سبکپردازی نقشه بااستفاده از فضای ابری» در Consumer SDK بهصورت GA است، درحالیکه کنترل تراکم نقطه موردعلاقه یک ویژگی آزمایشی «سبکپردازی نقشه بااستفاده از فضای ابری» است (فقط در سبکهای نقشه روشن پشتیبانی میشود).
- تغییر سبک ساختمانها در نقشهای که پیشرفت سفر را از Fleet Engine ردیابی میکند. آزمایشی توجه: پشتیبانی از «سبکپردازی نقشه بااستفاده از فضای ابری» در «کیت توسعه نرمافزار مصرفکننده» بهصورت GA است، درحالیکه سفارشیسازی سبک ساختمان سهبعدی و ردپا یک ویژگی آزمایشی «سبکپردازی نقشه بااستفاده از فضای ابری» است (فقط در سبکهای نقشه روشن پشتیبانی میشود).
- تغییر سبک نشانهای روی نقشه که پیشرفت سفر را از Fleet Engine ردیابی میکند. آزمایشی توجه: پشتیبانی از «سبکپردازی نقشه بااستفاده از فضای ابری» در «کیت توسعه نرمافزار مصرفکننده» بهصورت GA است، درحالیکه سفارشیسازی نماد نشان اختصاصی یک ویژگی آزمایشی «سبکپردازی نقشه بااستفاده از فضای ابری» است (فقط در سبکهای نقشه روشن پشتیبانی میشود).
- سفارشیسازی نشانگر روی نقشه که پیشرفت سفر را از Fleet Engine ردیابی میکند.
- سفارشیسازی چندخطی مسیر روی نقشهای که پیشرفت سفر را از Fleet Engine ردیابی میکند.