Используйте это руководство, чтобы ваше приложение могло прослушивать и реагировать на различные события, которые изменяются по мере того, как пользователь перемещается по маршруту. В этом руководстве не рассматривается определение маршрута, а только реагирование на события на маршруте.
Обзор
Навигационный SDK для iOS предоставляет вам прослушиватели, связанные с местоположением пользователя и условиями на маршруте, а также важные данные о времени и расстоянии. В контроллере представления карты ваше приложение должно принять протоколы для этих прослушивателей: GMSRoadSnappedLocationProviderListener
и GMSNavigatorListener
.
В этом списке показаны методы прослушивателя, доступные для событий навигации:
-
GMSNavigatorListener.didArriveAtWaypoint
, срабатывает при достижении пункта назначения. -
GMSNavigatorListener.navigatorDidChangeRoute
, срабатывает при изменении маршрута. -
GMSNavigatorListener.didUpdateRemainingTime
, вызывается повторно при изменении времени до следующего пункта назначения, пока активно руководство. -
GMSNavigatorListener.didUpdateRemainingDistance
, вызывается повторно при изменении расстояния до следующего пункта назначения, пока активно руководство. -
GMSNavigatorListener.didUpdateDelayCategory
, вызывается, когда изменяется категория задержки до следующего пункта назначения, когда направление активно. -
GMSNavigatorListener.didChangeSuggestedLightingMode
, срабатывает при обновлении предполагаемых условий освещения. Например, когда в текущем местоположении пользователя наступает ночь, освещение меняется. -
GMSNavigatorListener.didUpdateSpeedingPercentage
, срабатывает, когда водитель превышает ограничение скорости. -
GMSRoadSnappedLocationProviderListener.didUpdateLocation
, вызываемый повторно при изменении местоположения пользователя.
Посмотреть код
Декларирование соответствия требуемым протоколам
Перед реализацией методов навигации контроллер представления должен принять протоколы:
Быстрый
class ViewController: UIViewController, GMSNavigatorListener,
GMSRoadSnappedLocationProviderListener {
Цель-C
@interface ViewController () <GMSNavigatorListener,
GMSRoadSnappedLocationProviderListener>
@end
После принятия протоколов навигации установите прослушиватели на контроллер представления. Например, вы можете добавить следующий код в метод 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; }