Навигация по маршруту

Следуйте этому руководству, чтобы проложить маршрут в вашем приложении к одному пункту назначения с помощью Navigation SDK для iOS.

Обзор

  1. Интегрируйте Navigation SDK в свое приложение, как описано в разделе «Настройка проекта» .
  2. Настройте GMSMapView .
  3. Предложите пользователю принять условия и разрешить использование служб определения местоположения и фоновых уведомлений.
  4. Создайте массив, содержащий одно или несколько пунктов назначения.
  5. Определите GMSNavigator для управления пошаговой навигацией.

    • Добавьте пункты назначения, используя setDestinations .
    • Установите для isGuidanceActive значение true , чтобы начать навигацию.
    • Используйте simulateLocationsAlongExistingRoute для имитации движения транспортного средства по маршруту для тестирования, отладки и демонстрации вашего приложения.

Посмотреть код

Запросить у пользователя необходимые авторизации

Перед использованием Navigation SDK пользователь должен согласиться с условиями и разрешить использование служб определения местоположения, необходимых для навигации. Если ваше приложение будет работать в фоновом режиме, оно также должно предлагать пользователю авторизовать уведомления о предупреждениях. В этом разделе показано, как отображать необходимые запросы авторизации.

Авторизовать службы определения местоположения

Навигационный SDK использует службы определения местоположения, для которых требуется авторизация пользователя. Чтобы включить службы определения местоположения и отобразить диалог авторизации, выполните следующие действия:

  1. Добавьте ключ NSLocationAlwaysUsageDescription в Info.plist .
  2. В качестве значения добавьте краткое объяснение того, почему вашему приложению требуются службы определения местоположения. Например: «Этому приложению требуется разрешение на использование служб определения местоположения для пошаговой навигации».

  3. Чтобы отобразить диалог авторизации, вызовите requestAlwaysAuthorization() экземпляра диспетчера местоположений.

Быстрый

self.locationManager.requestAlwaysAuthorization()

Цель-C

[_locationManager requestAlwaysAuthorization];

Разрешить уведомления о предупреждениях для фоновых указаний

Для навигационного SDK требуется разрешение пользователя для предоставления уведомлений, когда приложение работает в фоновом режиме. Добавьте следующий код, чтобы запросить у пользователя разрешение на отображение этих уведомлений:

Быстрый

UNUserNotificationCenter.current().requestAuthorization(options: [.alert]) {
  granted, error in
    // Handle denied authorization to display notifications.
    if !granted || error != nil {
      print("User rejected request to display notifications.")
    }
}

Цель-C

// Request authorization for alert notifications.
UNUserNotificationCenter *center = [UNUserNotificationCenter currentNotificationCenter];
UNAuthorizationOptions options = UNAuthorizationOptionAlert;
[center requestAuthorizationWithOptions:options
                      completionHandler:
 ^(
   BOOL granted,
   NSError *_Nullable error) {
     if (!error && granted) {
       NSLog(@"iOS Notification Permission: newly Granted");
     } else {
       NSLog(@"iOS Notification Permission: Failed or Denied");
     }
   }];

Примите условия использования

Используйте следующий код, чтобы отобразить диалоговое окно условий использования и включить навигацию, когда пользователь принимает условия. Обратите внимание, что этот пример включает код для служб определения местоположения и уведомлений о предупреждениях (показанных ранее).

Быстрый

  let termsAndConditionsOptions = GMSNavigationTermsAndConditionsOptions(companyName: "Ride Sharing Co.")

  GMSNavigationServices.showTermsAndConditionsDialogIfNeeded(
    with: termsAndConditionsOptions) { termsAccepted in
    if termsAccepted {
      // Enable navigation if the user accepts the terms.
      self.mapView.isNavigationEnabled = true
      self.mapView.settings.compassButton = true

      // Request authorization to use location services.
      self.locationManager.requestAlwaysAuthorization()

      // Request authorization for alert notifications which deliver guidance instructions
      // in the background.
    UNUserNotificationCenter.current().requestAuthorization(options: [.alert]) {
      granted, error in
        // Handle rejection of notification authorization.
        if !granted || error != nil {
          print("Authorization to deliver notifications was rejected.")
        }
      }
    } else {
      // Handle rejection of terms and conditions.
    }
  }

Цель-C

GMSNavigationTermsAndConditionsOptions *termsAndConditionsOptions = [[GMSNavigationTermsAndConditionsOptions alloc] initWithCompanyName:@"Ride Sharing Co."];

[GMSNavigationServices
  showTermsAndConditionsDialogIfNeededWithOptions:termsAndConditionsOptions
  callback:^(BOOL termsAccepted) {
   if (termsAccepted) {
     // Enable navigation if the user accepts the terms.
     _mapView.navigationEnabled = YES;
     _mapView.settings.compassButton = YES;

     // Request authorization to use the current device location.
     [_locationManager requestAlwaysAuthorization];

     // Request authorization for alert notifications which deliver guidance instructions
     // in the background.
     UNUserNotificationCenter *center = [UNUserNotificationCenter currentNotificationCenter];
     UNAuthorizationOptions options = UNAuthorizationOptionAlert;
     [center requestAuthorizationWithOptions:options
                           completionHandler:
     ^(
       BOOL granted,
       NSError *_Nullable error) {
         if (!error && granted) {
           NSLog(@"iOS Notification Permission: newly Granted");
         } else {
           NSLog(@"iOS Notification Permission: Failed or Denied");
         }
       }];
   } else {
     // Handle rejection of the terms and conditions.
   }
 }];

Создайте маршрут и начните наведение

Чтобы построить маршрут, вызовите метод setDestinations() навигатора с массивом, содержащим один или несколько пунктов назначения ( GMSNavigationWaypoint ), которые необходимо посетить. В случае успешного расчета маршрут отображается на карте. Чтобы начать наведение по маршруту, начиная с первого пункта назначения, установите для isGuidanceActive значение true в обратном вызове.

В следующем примере показано:

  • Создание нового маршрута с двумя пунктами назначения.
  • Начало руководства.
  • Включение фоновых уведомлений о подсказках.
  • Имитация путешествия по маршруту (опционально).
  • Установка режима камеры «следовать» (опционально).

Быстрый

func startNav() {
  var destinations = [GMSNavigationWaypoint]()
  destinations.append(GMSNavigationWaypoint.init(placeID: "ChIJnUYTpNASkFQR_gSty5kyoUk",
                                                 title: "PCC Natural Market")!)
  destinations.append(GMSNavigationWaypoint.init(placeID:"ChIJJ326ROcSkFQRBfUzOL2DSbo",
                                                 title:"Marina Park")!)

  mapView.navigator?.setDestinations(destinations) { routeStatus in
    self.mapView.navigator?.isGuidanceActive = true
    self.mapView.locationSimulator?.simulateLocationsAlongExistingRoute()
    self.mapView.cameraMode = .following
  }
}

Цель-C

- (void)startNav {
  NSArray<GMSNavigationWaypoint *> *destinations =
  @[[[GMSNavigationWaypoint alloc] initWithPlaceID:@"ChIJnUYTpNASkFQR_gSty5kyoUk"
                                             title:@"PCC Natural Market"],
    [[GMSNavigationWaypoint alloc] initWithPlaceID:@"ChIJJ326ROcSkFQRBfUzOL2DSbo"
                                             title:@"Marina Park"]];

  [_mapView.navigator setDestinations:destinations
                             callback:^(GMSRouteStatus routeStatus){
                               [_mapView.locationSimulator simulateLocationsAlongExistingRoute];
                               _mapView.navigator.guidanceActive = YES;
                               _mapView.cameraMode = GMSNavigationCameraModeFollowing;
                             }];
}

Дополнительную информацию об идентификаторах мест см. в разделе «Идентификаторы мест» .

Установить режим путешествия

Режим путешествия определяет, какой тип маршрута будет выбран, а также способ определения курса пользователя. Для маршрута можно задать один из четырех режимов движения: автомобиль, велосипед, пешком и такси. В режиме вождения и такси курс пользователя зависит от направления движения; в режимах езды на велосипеде и ходьбы курс определяется направлением, в котором смотрит устройство.

Установите свойство travelMode представления карты, как показано в следующем примере:

Быстрый

self.mapView.travelMode = .cycling

Цель-C

_mapView.travelMode = GMSNavigationTravelModeCycling;

Установите дороги, которых следует избегать

Используйте BOOL -свойства avoidsHighways и avoidsTolls , чтобы избегать автомагистралей и/или платных дорог на маршруте.

Быстрый

self.mapView.navigator?.avoidsTolls = true

Цель-C

_mapView.navigator.avoidsTolls = YES;

Поиск PlaceID

Вы можете использовать PlaceID Finder , чтобы найти идентификаторы мест, которые можно использовать для пунктов назначения маршрута. Добавьте пункт назначения из placeID с помощью GMSNavigationWaypoint .

Плавающий текст

Вы можете добавить плавающий текст в любом месте вашего приложения, если только не указана атрибуция Google. Navigation SDK не поддерживает привязку текста к широте и долготе на карте или к метке. Дополнительную информацию см. в разделе Информационные окна .

,

Следуйте этому руководству, чтобы проложить маршрут в вашем приложении к одному пункту назначения с помощью Navigation SDK для iOS.

Обзор

  1. Интегрируйте Navigation SDK в свое приложение, как описано в разделе «Настройка проекта» .
  2. Настройте GMSMapView .
  3. Предложите пользователю принять условия и разрешить использование служб определения местоположения и фоновых уведомлений.
  4. Создайте массив, содержащий одно или несколько пунктов назначения.
  5. Определите GMSNavigator для управления пошаговой навигацией.

    • Добавьте пункты назначения, используя setDestinations .
    • Установите для isGuidanceActive значение true , чтобы начать навигацию.
    • Используйте simulateLocationsAlongExistingRoute для имитации движения транспортного средства по маршруту для тестирования, отладки и демонстрации вашего приложения.

Посмотреть код

Запросить у пользователя необходимые авторизации

Перед использованием Navigation SDK пользователь должен согласиться с условиями и разрешить использование служб определения местоположения, необходимых для навигации. Если ваше приложение будет работать в фоновом режиме, оно также должно предлагать пользователю авторизовать уведомления о предупреждениях. В этом разделе показано, как отображать необходимые запросы авторизации.

Авторизовать службы определения местоположения

Навигационный SDK использует службы определения местоположения, для которых требуется авторизация пользователя. Чтобы включить службы определения местоположения и отобразить диалог авторизации, выполните следующие действия:

  1. Добавьте ключ NSLocationAlwaysUsageDescription в Info.plist .
  2. В качестве значения добавьте краткое объяснение того, почему вашему приложению требуются службы определения местоположения. Например: «Этому приложению требуется разрешение на использование служб определения местоположения для пошаговой навигации».

  3. Чтобы отобразить диалог авторизации, вызовите requestAlwaysAuthorization() экземпляра диспетчера местоположений.

Быстрый

self.locationManager.requestAlwaysAuthorization()

Цель-C

[_locationManager requestAlwaysAuthorization];

Разрешить уведомления о предупреждениях для фоновых указаний

Для навигационного SDK требуется разрешение пользователя для предоставления уведомлений, когда приложение работает в фоновом режиме. Добавьте следующий код, чтобы запросить у пользователя разрешение на отображение этих уведомлений:

Быстрый

UNUserNotificationCenter.current().requestAuthorization(options: [.alert]) {
  granted, error in
    // Handle denied authorization to display notifications.
    if !granted || error != nil {
      print("User rejected request to display notifications.")
    }
}

Цель-C

// Request authorization for alert notifications.
UNUserNotificationCenter *center = [UNUserNotificationCenter currentNotificationCenter];
UNAuthorizationOptions options = UNAuthorizationOptionAlert;
[center requestAuthorizationWithOptions:options
                      completionHandler:
 ^(
   BOOL granted,
   NSError *_Nullable error) {
     if (!error && granted) {
       NSLog(@"iOS Notification Permission: newly Granted");
     } else {
       NSLog(@"iOS Notification Permission: Failed or Denied");
     }
   }];

Примите условия использования

Используйте следующий код, чтобы отобразить диалоговое окно условий использования и включить навигацию, когда пользователь принимает условия. Обратите внимание, что этот пример включает код для служб определения местоположения и уведомлений о предупреждениях (показанных ранее).

Быстрый

  let termsAndConditionsOptions = GMSNavigationTermsAndConditionsOptions(companyName: "Ride Sharing Co.")

  GMSNavigationServices.showTermsAndConditionsDialogIfNeeded(
    with: termsAndConditionsOptions) { termsAccepted in
    if termsAccepted {
      // Enable navigation if the user accepts the terms.
      self.mapView.isNavigationEnabled = true
      self.mapView.settings.compassButton = true

      // Request authorization to use location services.
      self.locationManager.requestAlwaysAuthorization()

      // Request authorization for alert notifications which deliver guidance instructions
      // in the background.
    UNUserNotificationCenter.current().requestAuthorization(options: [.alert]) {
      granted, error in
        // Handle rejection of notification authorization.
        if !granted || error != nil {
          print("Authorization to deliver notifications was rejected.")
        }
      }
    } else {
      // Handle rejection of terms and conditions.
    }
  }

Цель-C

GMSNavigationTermsAndConditionsOptions *termsAndConditionsOptions = [[GMSNavigationTermsAndConditionsOptions alloc] initWithCompanyName:@"Ride Sharing Co."];

[GMSNavigationServices
  showTermsAndConditionsDialogIfNeededWithOptions:termsAndConditionsOptions
  callback:^(BOOL termsAccepted) {
   if (termsAccepted) {
     // Enable navigation if the user accepts the terms.
     _mapView.navigationEnabled = YES;
     _mapView.settings.compassButton = YES;

     // Request authorization to use the current device location.
     [_locationManager requestAlwaysAuthorization];

     // Request authorization for alert notifications which deliver guidance instructions
     // in the background.
     UNUserNotificationCenter *center = [UNUserNotificationCenter currentNotificationCenter];
     UNAuthorizationOptions options = UNAuthorizationOptionAlert;
     [center requestAuthorizationWithOptions:options
                           completionHandler:
     ^(
       BOOL granted,
       NSError *_Nullable error) {
         if (!error && granted) {
           NSLog(@"iOS Notification Permission: newly Granted");
         } else {
           NSLog(@"iOS Notification Permission: Failed or Denied");
         }
       }];
   } else {
     // Handle rejection of the terms and conditions.
   }
 }];

Создайте маршрут и начните наведение

Чтобы построить маршрут, вызовите метод setDestinations() навигатора с массивом, содержащим один или несколько пунктов назначения ( GMSNavigationWaypoint ), которые необходимо посетить. В случае успешного расчета маршрут отображается на карте. Чтобы начать наведение по маршруту, начиная с первого пункта назначения, установите для isGuidanceActive значение true в обратном вызове.

В следующем примере показано:

  • Создание нового маршрута с двумя пунктами назначения.
  • Начало руководства.
  • Включение фоновых уведомлений о подсказках.
  • Имитация путешествия по маршруту (опционально).
  • Установка режима камеры «следовать» (опционально).

Быстрый

func startNav() {
  var destinations = [GMSNavigationWaypoint]()
  destinations.append(GMSNavigationWaypoint.init(placeID: "ChIJnUYTpNASkFQR_gSty5kyoUk",
                                                 title: "PCC Natural Market")!)
  destinations.append(GMSNavigationWaypoint.init(placeID:"ChIJJ326ROcSkFQRBfUzOL2DSbo",
                                                 title:"Marina Park")!)

  mapView.navigator?.setDestinations(destinations) { routeStatus in
    self.mapView.navigator?.isGuidanceActive = true
    self.mapView.locationSimulator?.simulateLocationsAlongExistingRoute()
    self.mapView.cameraMode = .following
  }
}

Цель-C

- (void)startNav {
  NSArray<GMSNavigationWaypoint *> *destinations =
  @[[[GMSNavigationWaypoint alloc] initWithPlaceID:@"ChIJnUYTpNASkFQR_gSty5kyoUk"
                                             title:@"PCC Natural Market"],
    [[GMSNavigationWaypoint alloc] initWithPlaceID:@"ChIJJ326ROcSkFQRBfUzOL2DSbo"
                                             title:@"Marina Park"]];

  [_mapView.navigator setDestinations:destinations
                             callback:^(GMSRouteStatus routeStatus){
                               [_mapView.locationSimulator simulateLocationsAlongExistingRoute];
                               _mapView.navigator.guidanceActive = YES;
                               _mapView.cameraMode = GMSNavigationCameraModeFollowing;
                             }];
}

Дополнительную информацию об идентификаторах мест см. в разделе «Идентификаторы мест» .

Установить режим путешествия

Режим путешествия определяет, какой тип маршрута будет выбран, а также способ определения курса пользователя. Для маршрута можно задать один из четырех режимов движения: автомобиль, велосипед, пешком и такси. В режиме вождения и такси курс пользователя зависит от направления движения; в режимах езды на велосипеде и ходьбы курс определяется направлением, в котором смотрит устройство.

Установите свойство travelMode представления карты, как показано в следующем примере:

Быстрый

self.mapView.travelMode = .cycling

Цель-C

_mapView.travelMode = GMSNavigationTravelModeCycling;

Установите дороги, которых следует избегать

Используйте BOOL -свойства avoidsHighways и avoidsTolls , чтобы избегать автомагистралей и/или платных дорог на маршруте.

Быстрый

self.mapView.navigator?.avoidsTolls = true

Цель-C

_mapView.navigator.avoidsTolls = YES;

Поиск PlaceID

Вы можете использовать PlaceID Finder , чтобы найти идентификаторы мест, которые можно использовать для пунктов назначения маршрута. Добавьте пункт назначения из placeID с помощью GMSNavigationWaypoint .

Плавающий текст

Вы можете добавить плавающий текст в любое место вашего приложения, если только не указана атрибуция Google. Navigation SDK не поддерживает привязку текста к широте и долготе на карте или к метке. Дополнительную информацию см. в разделе Информационные окна .