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

کیت توسعه نرم‌افزار مصرف‌کننده برای iOS به برنامه‌های مصرف‌کننده iOS اجازه می‌دهد سفرهای درخواستی را در Fleet Engine دنبال کنند. کلاس‌های آن، مثل GMTCTripModel و GMTCJourneySharingSession، داده‌های سفر را مدل‌سازی می‌کنند و مکان خودرو، مسیر، زمان تخمینی ورود، و مسافت باقی‌مانده را روی نقشه نشان می‌دهند.

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

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

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

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

  • به برنامه iOS نیاز دارید که در آن مصرف‌کنندگان سفر درخواستی یا سفر تحویل را که Fleet Engine ردیابی می‌کند دنبال کنند.
  • باید مکان تقریباً هم‌زمان، مسیر، و ترافیک زنده خودرو را در نقشه در برنامه مصرف‌کننده iOS نشان دهید.
  • باید زمان تخمینی رسیدن برای سوار کردن و پیاده کردن و فاصله باقی‌مانده را برای سفر درخواستی در iOS نشان دهید.
  • درحال‌حاضر از Fleet Engine و Driver SDK برای سفرهای درخواستی استفاده می‌کنید و به بخش مصرف‌کننده هم‌رسانی سفر نیاز دارید.

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

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

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

  • cocoapods: GoogleRidesharingConsumer
  • swift_package: https://github.com/googlemaps/ios-consumer-sdk

کیت توسعه نرم‌افزار مصرف‌کننده برای 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 انجام دهید

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