Следуйте этому руководству, чтобы проложить маршрут в вашем приложении к одному пункту назначения с помощью Navigation SDK для iOS.
Обзор
- Интегрируйте Navigation SDK в свое приложение, как описано в разделе «Настройка проекта» .
- Настройте
GMSMapView
. - Предложите пользователю принять условия и разрешить использование служб определения местоположения и фоновых уведомлений.
- Создайте массив, содержащий одно или несколько пунктов назначения.
Определите
GMSNavigator
для управления пошаговой навигацией.- Добавьте пункты назначения, используя
setDestinations
. - Установите для
isGuidanceActive
значениеtrue
, чтобы начать навигацию. - Используйте
simulateLocationsAlongExistingRoute
для имитации движения транспортного средства по маршруту для тестирования, отладки и демонстрации вашего приложения.
- Добавьте пункты назначения, используя
Посмотреть код
Запросить у пользователя необходимые авторизации
Перед использованием Navigation SDK пользователь должен согласиться с условиями и разрешить использование служб определения местоположения, необходимых для навигации. Если ваше приложение будет работать в фоновом режиме, оно также должно предлагать пользователю авторизовать уведомления о предупреждениях. В этом разделе показано, как отображать необходимые запросы авторизации.
Авторизовать службы определения местоположения
Навигационный SDK использует службы определения местоположения, для которых требуется авторизация пользователя. Чтобы включить службы определения местоположения и отобразить диалог авторизации, выполните следующие действия:
- Добавьте ключ
NSLocationAlwaysUsageDescription
вInfo.plist
. В качестве значения добавьте краткое объяснение того, почему вашему приложению требуются службы определения местоположения. Например: «Этому приложению требуется разрешение на использование служб определения местоположения для пошаговой навигации».
Чтобы отобразить диалог авторизации, вызовите
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 не поддерживает привязку текста к широте и долготе на карте или к метке. Дополнительную информацию см. в разделе Информационные окна .