Слушайте навигационные события

Это руководство поможет вашему приложению отслеживать и реагировать на различные события, изменяющиеся по мере перемещения пользователя по маршруту. В данном руководстве не рассматривается определение маршрута, а только реагирование на события, происходящие вдоль маршрута.

Обзор

SDK навигации для iOS предоставляет слушатели событий, связанные с местоположением пользователя, условиями на маршруте, а также важными данными о времени и расстоянии. В контроллере представления карты ваше приложение должно использовать протоколы для этих слушателей: GMSRoadSnappedLocationProviderListener и GMSNavigatorListener .

В этом списке показаны методы прослушивания, доступные для событий навигации:

См. код

Подтверждение соответствия требуемым протоколам.

Перед реализацией методов навигации контроллер представления должен использовать следующие протоколы:

Быстрый

class ViewController: UIViewController, GMSNavigatorListener,
GMSRoadSnappedLocationProviderListener {

Objective-C

@interface ViewController () <GMSNavigatorListener,
GMSRoadSnappedLocationProviderListener>

@end

После настройки протоколов навигации добавьте слушатели событий в контроллер представления. Например, вы можете добавить следующий код в метод viewDidLoad() .

Быстрый

mapView.navigator?.add(self) mapView.roadSnappedLocationProvider?.add(self)

Objective-C

[_mapView.navigator addListener:self]; [_mapView.roadSnappedLocationProvider
addListener:self];

Получение или прекращение получения обновлений местоположения

Для отображения перемещения пользователя на карте необходимы обновления местоположения.

Экземпляр location предоставляет следующие свойства:

Местоположение объекта недвижимости Описание
высота Текущая высота.
координата.широта Текущие координаты широты, к которым привязана дорога.
координата.долгота Текущие координаты долготы, привязанные к дороге.
курс Текущий азимут в градусах.
скорость Текущая скорость.
метка времени Дата/время текущего чтения.

Для получения непрерывных обновлений местоположения вызовите mapView.roadSnappedLocationProvider.startUpdatingLocation и используйте GMSRoadSnappedLocationProviderListener для обработки события didUpdateLocation .

В следующем примере показан вызов функции startUpdatingLocation :

Быстрый

mapView.roadSnappedLocationProvider.startUpdatingLocation()

Objective-C

[_mapView.roadSnappedLocationProvider startUpdatingLocation];

Приведенный ниже код создает объект GMSRoadSnappedLocationProviderListener , который обрабатывает событие didUpdateLocation .

Быстрый

func locationProvider(_ locationProvider: GMSRoadSnappedLocationProvider,
didUpdate location: CLLocation) { print("Location: \(location.description)") }

Objective-C

-   (void)locationProvider:(GMSRoadSnappedLocationProvider *)locationProvider
    didUpdateLocation:(CLLocation *)location { NSLog(@"Location: %@",
    location.description); }

Чтобы получать обновления местоположения, когда приложение находится в фоновом режиме, установите allowsBackgroundLocationUpdates в значение true:

Быстрый

mapView.roadSnappedLocationProvider.allowsBackgroundLocationUpdates = true

Objective-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 }

Objective-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.") }

Objective-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)") }

Objective-C

-   (void)navigator:(GMSNavigator *)navigator
    didUpdateRemainingTime:(NSTimeInterval)time { NSLog(@"Time to next
    destination: %f", time); }

Чтобы задать минимальное изменение расчетного времени до следующего пункта назначения, установите свойство timeUpdateThreshold в GMSNavigator . Значение указывается в секундах. Если это свойство не задано, службы используют значение по умолчанию, равное одной секунде.

Быстрый

navigator?.timeUpdateThreshold = 10

Objective-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.") }

Objective-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

Objective-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)") }

Objective-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.") }

Objective-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 }

Objective-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; }