از این راهنما برای فعال کردن برنامه خود برای گوش دادن و پاسخ به رویدادهای مختلفی استفاده کنید که با حرکت کاربر در مسیر تغییر می کند. این راهنما تعریف مسیر را پوشش نمی دهد، فقط به رویدادهای یک مسیر پاسخ می دهد.
نمای کلی
Navigation SDK برای iOS شنوندگان مرتبط با موقعیت کاربر و شرایط در طول مسیر و داده های مهم زمان و مسافت را در اختیار شما قرار می دهد. در کنترلکننده نمای نقشه، برنامه شما باید پروتکلهایی را برای این شنوندگان بپذیرد: GMSRoadSnappedLocationProviderListener
و GMSNavigatorListener
.
این لیست روش های شنونده موجود برای رویدادهای ناوبری را نشان می دهد:
-
GMSNavigatorListener.didArriveAtWaypoint
، با رسیدن به مقصد فعال می شود. -
GMSNavigatorListener.navigatorDidChangeRoute
، با تغییر مسیر فعال می شود. -
GMSNavigatorListener.didUpdateRemainingTime
، به طور مکرر با تغییر زمان رسیدن به مقصد بعدی، در حالی که راهنما فعال است، فراخوانی می شود. -
GMSNavigatorListener.didUpdateRemainingDistance
، با تغییر فاصله تا مقصد بعدی، در حالی که راهنما فعال است، مکرراً فراخوانی می شود. -
GMSNavigatorListener.didUpdateDelayCategory
، زمانی که دسته تاخیر به مقصد بعدی تغییر می کند، در حالی که راهنما فعال است، فراخوانی می شود. -
GMSNavigatorListener.didChangeSuggestedLightingMode
، زمانی که شرایط نوری تخمینی بهروزرسانی میشود، فعال میشود. به عنوان مثال، هنگامی که شب در مکان فعلی کاربر فرا می رسد، نور تغییر می کند. -
GMSNavigatorListener.didUpdateSpeedingPercentage
، هنگامی که راننده از حد مجاز سرعت فراتر می رود فعال می شود. -
GMSRoadSnappedLocationProviderListener.didUpdateLocation
، با تغییر مکان کاربر به طور مکرر فراخوانی می شود.
کد را ببینید
اعلام انطباق با پروتکل های مورد نیاز
قبل از اجرای روشهای ناوبری، کنترلکننده view باید پروتکلهای زیر را اتخاذ کند:
سویفت
class ViewController: UIViewController, GMSNavigatorListener,
GMSRoadSnappedLocationProviderListener {
هدف-C
@interface ViewController () <GMSNavigatorListener,
GMSRoadSnappedLocationProviderListener>
@end
پس از اتخاذ پروتکل های ناوبری، شنوندگان را روی کنترلر View قرار دهید. برای مثال می توانید کد زیر را به متد viewDidLoad()
اضافه کنید.
سویفت
mapView.navigator?.add(self) mapView.roadSnappedLocationProvider?.add(self)
هدف-C
[_mapView.navigator addListener:self]; [_mapView.roadSnappedLocationProvider
addListener:self];
دریافت یا توقف بهروزرسانیهای مکان
بهروزرسانیهای مکان برای نشان دادن پیشرفت کاربر روی نقشه مورد نیاز است.
نمونه location
ویژگی های زیر را نشان می دهد:
دارایی مکان | توضیحات |
---|---|
ارتفاع | ارتفاع فعلی. |
مختصات. عرض جغرافیایی | مختصات عرض جغرافیایی کنونی شکسته شده در جاده. |
مختصات.طول جغرافیایی | مختصات طول جغرافیایی کنونی شکسته شده. |
دوره | بلبرینگ جریان بر حسب درجه |
سرعت | سرعت فعلی. |
مهر زمانی | تاریخ/زمان خواندن فعلی |
برای دریافت بهروزرسانیهای مستمر مکان، با mapView.roadSnappedLocationProvider.startUpdatingLocation
تماس بگیرید و GMSRoadSnappedLocationProviderListener
برای مدیریت رویداد didUpdateLocation
استفاده کنید.
مثال زیر فراخوانی startUpdatingLocation
را نشان می دهد:
سویفت
mapView.roadSnappedLocationProvider.startUpdatingLocation()
هدف-C
[_mapView.roadSnappedLocationProvider startUpdatingLocation];
کد زیر یک GMSRoadSnappedLocationProviderListener
ایجاد می کند که رویداد didUpdateLocation
را مدیریت می کند.
سویفت
func locationProvider(_ locationProvider: GMSRoadSnappedLocationProvider,
didUpdate location: CLLocation) { print("Location: \(location.description)") }
هدف-C
- (void)locationProvider:(GMSRoadSnappedLocationProvider *)locationProvider
didUpdateLocation:(CLLocation *)location { NSLog(@"Location: %@",
location.description); }
برای دریافت بهروزرسانیهای مکان زمانی که برنامه در پسزمینه است، allowsBackgroundLocationUpdates
روی true تنظیم کنید:
سویفت
mapView.roadSnappedLocationProvider.allowsBackgroundLocationUpdates = true
هدف-C
_mapView.roadSnappedLocationProvider.allowsBackgroundLocationUpdates = YES;
تشخیص رویدادهای ورود
برنامه شما از رویداد didArriveAtWaypoint
برای تشخیص اینکه چه زمانی به مقصد رسیده است استفاده می کند. می توانید با فراخوانی continueToNextDestination()
و سپس فعال کردن مجدد راهنما، راهنمایی را از سر بگیرید و به ایستگاه بعدی بروید. برنامه شما باید پس از فراخوانی continueToNextDestination()
راهنما را دوباره فعال کند.
پس از تماس برنامه continueToNextDestination
، ناوبر دیگر اطلاعاتی درباره مقصد قبلی ندارد. اگر میخواهید اطلاعات مربوط به یک مسیر را تجزیه و تحلیل کنید، باید قبل از فراخوانی continueToNextDestination()
آن را از ناوبر بازیابی کنید.
مثال کد زیر روشی را برای مدیریت رویداد didArriveAtWaypoint
نشان می دهد:
سویفت
func navigator(_ navigator: GMSNavigator, didArriveAt waypoint:
GMSNavigationWaypoint) { print("You have arrived at: \(waypoint.title)")
mapView.navigator?.continueToNextDestination()
mapView.navigator?.isGuidanceActive = true }
هدف-C
- (void)navigator:(GMSNavigator *)navigator
didArriveAtWaypoint:(GMSNavigationWaypoint *)waypoint { NSLog(@"You have
arrived at: %@", waypoint.title); [_mapView.navigator
continueToNextDestination]; _mapView.navigator.guidanceActive = YES; }
دریافت بهروزرسانیهای تغییر مسیر
برای دریافت اعلان هر زمان که مسیر تغییر کرد، روشی برای مدیریت رویداد navigatorDidChangeRoute
ایجاد کنید. با استفاده از ویژگی routeLegs
و currentRouteLeg
GMSNavigator
می توانید به مسیر جدید دسترسی پیدا کنید.
سویفت
func navigatorDidChangeRoute(_ navigator: GMSNavigator) { print("The route has
changed.") }
هدف-C
- (void)navigatorDidChangeRoute:(GMSNavigator *)navigator { NSLog(@"The route
has changed."); }
دریافت زمان بهروزرسانیهای مقصد
برای دریافت زمان پیوسته بهروزرسانیهای مقصد، روشی برای مدیریت رویداد didUpdateRemainingTime
ایجاد کنید. پارامتر time
زمان تخمینی را در ثانیه تا رسیدن به مقصد بعدی ارائه می دهد.
سویفت
func navigator(_ navigator: GMSNavigator, didUpdateRemainingTime time:
TimeInterval) { print("Time to next destination: \(time)") }
هدف-C
- (void)navigator:(GMSNavigator *)navigator
didUpdateRemainingTime:(NSTimeInterval)time { NSLog(@"Time to next
destination: %f", time); }
برای تنظیم حداقل تغییر در زمان تخمینی به مقصد بعدی، ویژگی timeUpdateThreshold
را در GMSNavigator
تنظیم کنید. مقدار در ثانیه مشخص می شود. اگر این ویژگی تنظیم نشده باشد، سرویس ها از مقدار پیش فرض یک ثانیه استفاده می کنند.
سویفت
navigator?.timeUpdateThreshold = 10
هدف-C
navigator.timeUpdateThreshold = 10;
دریافت به روز رسانی فاصله تا مقصد
برای دریافت بهروزرسانیهای مسافت مداوم تا مقصد، روشی برای مدیریت رویداد didUpdateRemainingDistance
ایجاد کنید. پارامتر distance
، فاصله تخمین زده شده را تا مقصد بعدی بر حسب متر ارائه می کند.
سویفت
func navigator(_ navigator: GMSNavigator, didUpdateRemainingDistance distance:
CLLocationDistance) { let miles = distance * 0.00062137 print("Distance to next
destination: \(miles) miles.") }
هدف-C
- (void)navigator:(GMSNavigator *)navigator
didUpdateRemainingDistance:(CLLocationDistance)distance { double miles =
distance * 0.00062137; NSLog(@"%@", [NSString stringWithFormat:@"Distance to
next destination: %.2f.", miles]); }
برای تنظیم حداقل تغییر در فاصله تخمینی تا مقصد بعدی، ویژگی distanceUpdateThreshold
را در GMSNavigator
تنظیم کنید (مقدار بر حسب متر مشخص شده است). اگر این ویژگی تنظیم نشده باشد، سرویس ها از مقدار پیش فرض یک متر استفاده می کنند.
سویفت
navigator?.distanceUpdateThreshold = 100
هدف-C
navigator.distanceUpdateThreshold = 100;
دریافت به روز رسانی ترافیک
برای دریافت بهروزرسانیهای مداوم جریان ترافیک برای مسیر باقیمانده، روشی برای مدیریت رویداد didUpdateDelayCategory
ایجاد کنید. تماس با delayCategoryToNextDestination
GMSNavigationDelayCategory
را برمیگرداند که مقدار 0 تا 3 را ارائه میکند. بهروزرسانیهای دسته براساس موقعیت فعلی کاربر برنامه است. اگر داده های ترافیک در دسترس نباشد، GMSNavigationDelayCategory
0 را برمی گرداند. اعداد 1-3 نشان دهنده افزایش جریان از سبک به سنگین است.
سویفت
func navigator(_ navigator: GMSNavigator, didUpdate delayCategory:
GMSNavigationDelayCategory) { print("Traffic flow to next destination:
\(delayCategory)") }
هدف-C
- (void)navigator:(GMSNavigator *)navigator
didUpdateDelayCategory:(GMSNavigationDelayCategory)delayCategory {
NSLog(@"Traffic flow to next destination: %ld", (long)delayCategory); }
ویژگی GMSNavigationDelayCategory
سطوح تاخیر زیر را نشان می دهد:
دسته تاخیر | توضیحات |
---|---|
GMSNavigationDelayCategoryNoData | 0 - در دسترس نیست، هیچ داده ای برای ترافیک یا: |
مسیر | |
GMSNavigationDelayCategoryHeavy | 1 - سنگین |
GMSNavigationDelayCategoryMedium | 2 - متوسط |
GMSNavigationDelayCategoryLight | 3 - نور. |
دریافت به روز رسانی سرعت
برای دریافت بهروزرسانیها وقتی راننده از حد مجاز فراتر میرود، روشی برای مدیریت رویداد didUpdateSpeedingPercentage
ایجاد کنید.
سویفت
// Listener to handle speeding events. func navigator( _ navigator:
GMSNavigator, didUpdateSpeedingPercentage percentageAboveLimit: CGFloat ) {
print("Speed is \(percentageAboveLimit) above the limit.") }
هدف-C
// Listener to handle speeding events. - (void)navigator:(GMSNavigator
*)navigator didUpdateSpeedingPercentage:(CGFloat)percentageAboveLimit {
NSLog(@"Speed is %f percent above the limit.", percentageAboveLimit); }
تغییر حالت نورپردازی پیشنهادی
برای دریافت بهروزرسانیها برای تغییرات تخمینی نور، روشی برای مدیریت رویداد didChangeSuggestedLightingMode
ایجاد کنید.
سویفت
// Define a listener for suggested changes to lighting mode. func navigator(_
navigator: GMSNavigator, didChangeSuggestedLightingMode lightingMode:
GMSNavigationLightingMode) { print("Suggested lighting mode has changed:
\(String(describing: lightingMode))")
// Make the suggested change. mapView.lightingMode = lightingMode }
هدف-C
// Define a listener for suggested changes to lighting mode.
-(void)navigator:(GMSNavigator *)navigator didChangeSuggestedLightingMode:
(GMSNavigationLightingMode)lightingMode { NSLog(@"Suggested lighting mode has
changed: %ld", (long)lightingMode);
// Make the suggested change. _mapView.lightingMode = lightingMode; }