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

کیت توسعه نرم‌افزار پیمایش برای iOS ناوبری گام‌به‌گام Google Maps را با سفارشی‌سازی میانای کاربر و پیکربندی مسیر به برنامه‌های iOS اضافه می‌کند. این کیت توسعه نرم‌افزار Maps SDK for iOS را گسترش می‌دهد که لایه نقشه را ارائه می‌دهد و باید در برنامه نیز نصب شود.

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

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

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

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

  • به ناوبری گام‌به‌گام Google Maps در برنامه iOS بومی خودتان نیاز دارید تا کاربران برنامه‌ها را عوض نکنند.
  • باید میانای کاربر ناوبری، سبک‌های نقشه، دوربین، یا چیدمان را سفارشی‌سازی کنید تا با نمانام شما درطول راهنمایی مطابقت داشته باشد.
  • به اولویت‌های مسیریابی، چند نقطه‌مسیر، یا یک کد مسیر از Routes API یا Route Optimization API نیاز دارید.
  • برای واسط کاربر راهنمای سفارشی یا CarPlay، به رویدادهای سفر (مکان، ورود، تغییرات مسیر، زمان تخمینی رسیدن) یا فید داده‌های گام‌به‌گام نیاز دارید.

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

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

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

  • swift_package: https://github.com/googlemaps/ios-navigation-sdk (GoogleNavigation)

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

  • cocoapods: GoogleNavigation. توزیع CocoaPods از نسخه ۱۱.۰.۰ منسوخ شده است و در تاریخ ۲۰۲۵-۰۸-۱۸ وارد حالت نگهداری شده است. درعوض از Swift Package Manager استفاده کنید.

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

  • مشکل: صفحه‌نمایش درطول پیمایش کم‌نور یا خاموش می‌شود زیرا کیت توسعه نرم‌افزار زمان‌سنج بیکاری iOS را غیرفعال نمی‌کند. رفع مشکل: تنظیم UIApplication.shared.isIdleTimerDisabled = true هنگام پیمایش. /maps/documentation/navigation/ios-sdk/route را ببینید.
  • مشکل: نسخه اصلی آتی کیت توسعه نرم‌افزار از ارتفاع‌سنج (CMAltimeter) استفاده خواهد کرد و برنامه‌هایی که NSMotionUsageDescription در Info.plist ندارند هنگام مقداردهی اولیه ازکار خواهند افتاد. افزودن کلید درحال‌حاضر تأثیری بر رفتار فعلی ندارد. اصلاح: NSMotionUsageDescription (Privacy - Motion Usage Description) را به Info.plist اضافه کنید. /maps/documentation/navigation/ios-sdk/route را ببینید.
  • مشکل: کیت توسعه نرم‌افزار Places برای iOS با کیت توسعه نرم‌افزار Navigation (از کیت توسعه نرم‌افزار Places نسخه ۵.۰) همراه نیست، بنابراین کلاس‌های Places وجود ندارند. اصلاح: «کیت توسعه نرم‌افزار مکان‌ها» برای iOS را به‌طور جداگانه و بااستفاده از همان نسخه «کیت توسعه نرم‌افزار ناوبری» نصب کنید. /maps/documentation/navigation/ios-sdk/xcode-setup را ببینید.
  • مشکل: تنظیم مقصدها با کد مسیر با .travelModeUnsupported ناموفق است وقتی travelMode برنامه driving یا twoWheeler نباشد. اصلاح: mapView.travelMode را روی .driving یا .twoWheeler تنظیم کنید. resolvedParameters.travelMode را بررسی کنید تا ببینید مسیر از چه حالتی استفاده می‌کند. /maps/documentation/navigation/ios-sdk/route-customizations را ببینید.

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

  • توزیع CocoaPods: از ۲۰۲۶/۰۸/۰۶ منسوخ شده است. جایگزین: Swift Package Manager. نشانه: حالت تعمیر از ۲۰۲۵-۰۸-۱۸. پس‌از سه‌ماهه دوم ۲۰۲۶، نسخه جدیدی از CocoaPods ارائه نخواهد شد. راهنمای انتقال را ببینید.
  • GMSNavigator setDestinations:callback:، setDestinations:routingOptions:callback:، setDestinations:routeToken:callback: (GMSRouteStatusCallback): منسوخ‌شده از ۲۰۲۶/۱۱/۰۲. جایگزین: setDestinations:completionHandler:، setDestinations:routingOptions:completionHandler:، setDestinationsWithToken:completionHandler: (GMSNavigationRouteCompletionHandler).
  • GMSServices ویژگی نمونه appCheckTokenProvider: منسوخ‌شده از ۲۰۲۶/۰۹/۲۴. جایگزینی: ویژگی کلاس GMSServices.appCheckTokenProvider (+[GMSServices setAppCheckTokenProvider:]). نشانه: در نسخه ۱۱.۱.۰، پیکربندی App Check ازطریق GMSServices.sharedServices() ناموفق بود. راهنمای انتقال را ببینید.
  • GMSNavigator continueToNextDestination: از ۲۰۲۶/۰۴/۰۷ منسوخ شده است. جایگزینی: GMSNavigator continueToNextDestinationWithCompletion:.
  • GMSUISettings showsTrafficLights و showsStopSigns: از رده خارج شده از ۲۰۲۶-۰۸-۰۶. جایگزین: جایگزینی لازم نیست؛ چراغ‌های راهنمایی و تابلوهای ایست به‌طور پیش‌فرض درطول ناوبری نشان داده می‌شوند.
  • نوع نقشه .terrain درطول پیمایش فعال: از کار افتاده از ۲۰۲۶-۰۸-۰۶. جایگزین: .normal (kGMSTypeNormal)، .satellite، یا نوع نقشه .hybrid.
  • پروتکل‌های GMSNavigatorDelegate و GMSRoadSnappedLocationProviderDelegate: از ۲۰۲۱/۰۵/۱۳ از رده خارج شده‌اند. جایگزین: GMSNavigatorListener و GMSRoadSnappedLocationProviderListener (با -addListener: اضافه کنید؛ timeUpdateThreshold و distanceUpdateThreshold را روی GMSNavigator تنظیم کنید). راهنمای انتقال را ببینید.

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

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

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

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