کیت توسعه نرمافزار پیمایش برای 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 استفاده نکنید:
- درحال ساختن برنامه Android هستید. بهجای آن از کیت توسعه نرمافزار ناوبری برای Android استفاده کنید.
- درحال ساختن برنامه Flutter یا React Native هستید. بهجای آن از Google Navigation برای Flutter و React Native استفاده کنید.
- فقط به مسیرها، زمان تخمینی ورود، یا فاصلهها در سرور نیاز دارید و به راهنمایی درونبرنامه نیاز ندارید. درعوض از Routes API استفاده کنید.
کیت توسعه نرمافزار پیمایش برای iOS: راهاندازی
- سرویس برای فعال کردن:
navigationsdk.googleapis.com - اصالتسنجی: کلید میانای برنامهسازی کاربردی
- همچنین فعال کنید: کیت توسعه نرمافزار Google Maps برای iOS
- انتساب استفاده:
GMSServices.addInternalUsageAttributionID(_:)(+[GMSServices addInternalUsageAttributionID:]) را فراخوانی کنید تا شناسه انتساب استفاده به مقداردهی اولیه اضافه شود. برای انصراف دادن، تماس را حذف کنید یا رشته خالی ارسال کنید. - شروع به کار: راهاندازی کیت توسعه نرمافزار پیمایش برای iOS
- مرجع: مرجع کیت توسعه نرمافزار پیمایش برای iOS
- قیمتگذاری: استفاده و صورتحساب کیت توسعه نرمافزار پیمایش برای iOS
- خطمشیها: خطمشیهای کیت توسعه نرمافزار ناوبری برای iOS
- یادداشتهای انتشار: یادداشتهای انتشار کیت توسعه نرمافزار ناوبری برای iOS
بستههای رسمی کیت توسعه نرمافزار ناوبری برای iOS:
- swift_package:
https://github.com/googlemaps/ios-navigation-sdk (GoogleNavigation)
بستههایی که نباید با «کیت توسعه نرمافزار ناوبری» برای iOS استفاده شوند:
- cocoapods:
GoogleNavigation. توزیع CocoaPods از نسخه ۱۱.۰.۰ منسوخ شده است و در تاریخ ۲۰۲۵-۰۸-۱۸ وارد حالت نگهداری شده است. درعوض از Swift Package Manager استفاده کنید.
کیت توسعه نرمافزار پیمایش برای iOS: محصولات مرتبط
- اغلب با این موارد استفاده میشود: کیت توسعه نرمافزار Maps برای iOS، Routes API، Route Optimization API، کیت توسعه نرمافزار Places برای iOS
کیت توسعه نرمافزار پیمایش برای 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 ارائه نخواهد شد. راهنمای انتقال را ببینید.
GMSNavigatorsetDestinations: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()ناموفق بود. راهنمای انتقال را ببینید.GMSNavigatorcontinueToNextDestination: از ۲۰۲۶/۰۴/۰۷ منسوخ شده است. جایگزینی:GMSNavigatorcontinueToNextDestinationWithCompletion:.GMSUISettingsshowsTrafficLightsوshowsStopSigns: از رده خارج شده از ۲۰۲۶-۰۸-۰۶. جایگزین: جایگزینی لازم نیست؛ چراغهای راهنمایی و تابلوهای ایست بهطور پیشفرض درطول ناوبری نشان داده میشوند.- نوع نقشه
.terrainدرطول پیمایش فعال: از کار افتاده از ۲۰۲۶-۰۸-۰۶. جایگزین:.normal(kGMSTypeNormal)،.satellite، یا نوع نقشه.hybrid. - پروتکلهای
GMSNavigatorDelegateوGMSRoadSnappedLocationProviderDelegate: از ۲۰۲۱/۰۵/۱۳ از رده خارج شدهاند. جایگزین:GMSNavigatorListenerوGMSRoadSnappedLocationProviderListener(با-addListener:اضافه کنید؛timeUpdateThresholdوdistanceUpdateThresholdرا رویGMSNavigatorتنظیم کنید). راهنمای انتقال را ببینید.
کارهایی که میتوانید با «کیت توسعه نرمافزار پیمایش» برای iOS انجام دهید
برای هر تکلیف، راهنماهای پیوندشده در زیر را ببینید یا محصولات را در کاوشگر قابلیتها با یکدیگر مقایسه کنید.
کیت توسعه نرمافزار پیمایش برای iOS: سبکبندی Maps
کیت توسعه نرمافزار پیمایش برای iOS: پیمایش
- ناوبری گامبهگام تعاملی را به برنامه تلفن همراه اضافه کنید.
- مقصد را برای ناوبری گامبهگام تنظیم کنید.
- برای ناوبری گامبهگام، ناوبری را شروع کنید.
- حالت سفر (رانندگی، پیادهروی، موتورسیکلت، تاکسی) را برای درخواست مسیر مشخص کنید.
- اولویتهای مسیریابی را برای ناوبری گامبهگام اصلاح کنید.
- سمت جاده و دیگر اولویتهای رسیدن را برای ناوبری گامبهگام مشخص کنید.
- بااستفاده از یک کد مسیر بازکاربردپذیر، مسیر برنامهریزیشده مجدد را برای ناوبری گامبهگام مشخص کنید.
- بهروزرسانیهای رسیدن کاربر را از جلسه ناوبری گامبهگام برگردانید.
- بهروزرسانیهای مکان کاربر را از جلسه ناوبری گامبهگام برگردانید.
- بهروزرسانیهای زمان و مسافت را از جلسه ناوبری گامبهگام برمیگرداند.
- بهروزرسانیهای تغییر مسیر برگشت از جلسه ناوبری گامبهگام.
- بهروزرسانیهای حالت شب را از جلسه ناوبری گامبهگام برگردانید.
- بهروزرسانیهای سرعت کاربر را از جلسه ناوبری گامبهگام برمیگرداند.
- عناصر و کنترلهای میانای کاربر را که درطول ناوبری گامبهگام نشان داده میشود سفارشیسازی کنید.
- عنصر میانای کاربر جدیدی به ناوبری گامبهگام اضافه کنید.
- نشانگر پیشرفت سفر را به ناوبری گامبهگام اضافه کنید.
- ویژگیهای نقشه را که درطول ناوبری گامبهگام نشان داده میشود سفارشیسازی کنید.
- افزودن لایه ترافیک به ناوبری گامبهگام.
- نمای دوربین و رفتار ناوبری گامبهگام را اصلاح کنید.
- هشدارهای سرعتسنج و حد مجاز سرعت را برای ناوبری گامبهگام سفارشیسازی کنید.
- فید ناوبری گامبهگام را بهصورت مجموعهای از پیامها برای هر مانور درطول مسیر برمیگرداند.
- نمادهای مانور سفارشی را برای استفاده با فید ناوبری گامبهگام مشخص کنید.
- ناوبری گامبهگام تعاملی را برای CarPlay به برنامه iOS اضافه کنید. پیشدید
- به کاربران درباره اختلالات درطول مسیرشان هشدار دهید.
- به کاربران اجازه دهید قبلاز شروع ناوبری، اختلالات موجود در مسیرشان را مشاهده کنند.
- به کاربران اجازه دهید اختلالات درطول مسیرشان را گزارش کنند.
- به کاربران اجازه دهید اختلالات درطول مسیرشان را تأیید کنند.
- دکمه گزارش اختلال مسیر سفارشی اضافه کنید.