Настройте свой проект

Используйте CocoaPods

Навигационный SDK для iOS доступен в виде модуля CocoaPods . CocoaPods — это менеджер зависимостей с открытым исходным кодом для проектов Swift и Objective-C Cocoa.

Если у вас еще нет инструмента CocoaPods, установите его в macOS, выполнив следующую команду из терминала. Подробности см. в руководстве по началу работы с CocoaPods .

sudo gem install cocoapods

Создайте Podfile для навигационного SDK для iOS и используйте его для установки API и его зависимостей:

1. Если у вас еще нет проекта Xcode, создайте его сейчас и сохраните на своем локальном компьютере. Если вы новичок в разработке для iOS:
   1. Создайте новый проект.
   2. Выберите iOS > Шаблон приложения .
   3. На экране опций проекта:
      1. Введите название проекта .
      2. Запишите значение поля идентификатора пакета . Вы можете использовать это значение, чтобы ограничить свой ключ API ниже.
      3. Установите для интерфейса проекта значение Storyboard .
      4. Установите язык Swift или Objective-C .
2. Создайте файл с именем Podfile в каталоге вашего проекта. Этот файл определяет зависимости вашего проекта.
3. Отредактируйте Podfile и добавьте свои зависимости вместе с их версиями . Вот пример, который включает зависимость, необходимую для навигационного SDK для iOS:

   source 'https://github.com/CocoaPods/Specs.git'
   
   platform :ios, '13.0'
   
   target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
     pod 'GoogleNavigation', '4.4.0'
   end
           

   Обязательно регулярно запускайте pod outdated для обнаружения новых версий. При необходимости обновитесь до последней версии .
4. Сохраните Podfile .

5. Откройте терминал и перейдите в каталог, содержащий Podfile :

   cd <path-to-project>

6. Запустите команду pod install . При этом будут установлены API, указанные в Podfile , вместе со всеми зависимостями.

   pod install

7. Закройте Xcode, а затем откройте (дважды щелкните) файл .xcworkspace вашего проекта, чтобы запустить Xcode. С этого момента вы должны использовать файл .xcworkspace для открытия проекта.

Чтобы обновить API для существующего проекта, выполните следующие действия:

1. Откройте терминал и перейдите в каталог проекта, содержащий Podfile .
2. Запустите команду pod update . При этом все API, указанные в Podfile обновляются до последней версии.

Установить вручную

В этом руководстве показано, как вручную добавить XCFrameworks, содержащий Navigation SDK для iOS и Maps SDK для iOS, в ваш проект и настроить параметры сборки в Xcode. XCFramework — это двоичный пакет, который можно использовать на нескольких платформах, включая машины с набором микросхем M1.

Выполните следующие действия, чтобы установить XCFrameworks для Navigation SDK для iOS и Maps SDK для iOS:

1. Загрузите XCFrameworks, выполнив следующие действия:
1. Найдите последнюю версию файла Podspec Navigation SDK на странице спецификаций CocoaPods для Google Navigation и последнюю версию файла Podspec Maps SDK на странице спецификаций CocoaPods для Google Maps .
2. Перейдите в каталог последней версии.
3. Откройте файлы GoogleNavigation.podspec.json и GoogleMaps.podspec.json .
4. Перейдите в конец файлов JSON и найдите поле с именем source и поле внутри него с именем http .
5. Значением этого поля является ссылка для скачивания CocoaPod. Загрузите и распакуйте это локально.
6. Для GoogleNavigation найдите GoogleNavigation.xcframework в каталоге Frameworks.
7. Для GoogleMaps найдите GoogleMapsBase.xcframework в каталоге Base/Frameworks и найдите GoogleMapsCore.xcframework и GoogleMaps.xcframework в каталоге Maps/Frameworks .
2. Запустите Xcode и либо откройте существующий проект, либо создайте новый проект. Если вы новичок в iOS, создайте новый проект и выберите шаблон приложения iOS .
3. Удалите из проекта все существующие ссылки на карты, навигацию и места.
4. Перетащите следующие файлы XCFrameworks в свой проект в разделе «Платформы, библиотеки и встроенный контент», чтобы установить SDK «Карты» и «Навигация» (при появлении запроса выберите «Копировать элементы, если необходимо »):
   • GoogleMapsBase.xcframework
   • GoogleMaps.xcframework
   • GoogleMapsCore.xcframework
   • GoogleNavigation.xcframework
5. Щелкните правой кнопкой мыши GoogleMaps.xcframework в своем проекте и выберите «Показать в Finder» .
6. Перетащите файл GoogleMaps.bundle из папки ios-arm64/GoogleMaps.framework/Resources в каталог верхнего уровня вашего проекта Xcode. При появлении запроса убедитесь, что флажок «Копировать элементы при необходимости» не выбран.
7. Повторите два предыдущих шага, чтобы добавить GoogleNavigation.bundle из папки ios-arm64/GoogleNavigation.framework/Resources .
8. Выберите свой проект в Навигаторе проектов и выберите цель своего приложения.
9. Откройте вкладку «Фазы сборки » и в разделе «Связывание двоичных файлов с библиотеками» добавьте следующие платформы и библиотеки:
   • Accelerate.framework
   • AudioToolbox.framework
   • AVFoundation.framework
   • CoreData.framework
   • CoreGraphics.framework
   • CoreImage.framework
   • CoreLocation.framework
   • CoreTelephony.framework
   • CoreText.framework
   • GLKit.framework
   • ImageIO.framework
   • libc++.tbd
   • libxml2.tbd
   • libz.tbd
   • Metal.framework
   • OpenGLES.framework
   • QuartzCore.framework
   • Security.framework
   • SystemConfiguration.framework
   • UIKit.framework
   • UserNotifications.framework
   • WebKit.framework
10. В целевом приложении выберите вкладку «Возможности» , включите «Фоновые режимы» и включите следующие режимы:
    • Аудио, AirPlay и картинка в картинке
    • Обновления местоположения
11. Выберите свой проект, а не конкретную цель, и откройте вкладку «Настройки сборки» . В разделе «Другие флаги компоновщика» добавьте ‑ObjC как для отладки , так и для выпуска . Если эти настройки не отображаются, измените фильтр на панели «Настройки сборки» с «Базовый» на «Все» .
12. Откройте Info.plist и добавьте следующие пары ключ-значение:
    • Ключ: NSLocationWhenInUseUsageDescription ( Конфиденциальность — местоположение при использовании, описание использования )
      Значение: «Этому приложению требуется разрешение на использование вашего местоположения для пошаговой навигации».
    • Ключ: NSLocationAlwaysAndWhenInUseUsageDescription ( Конфиденциальность — описание местоположения всегда и при использовании ).
      Значение: «Этому приложению требуется разрешение на использование вашего местоположения для пошаговой навигации».

Быстрый

Добавьте свой ключ API в AppDelegate.swift следующим образом:

1. Добавьте следующие операторы импорта:

   import GoogleMaps
   import GoogleNavigation

2. Добавьте в свой application(_:didFinishLaunchingWithOptions:) следующее:

   GMSServices.provideAPIKey("YOUR_API_KEY")

Цель-C

Добавьте свой ключ API в свой AppDelegate.m следующим образом:

1. Добавьте следующие операторы импорта:

   @import GoogleMaps;
   @import GoogleNavigation;

2. Добавьте в свое application:didFinishLaunchingWithOptions: метод:

   [GMSServices provideAPIKey:@"YOUR_API_KEY"];

Быстрый

import UIKit
import GoogleNavigation

class ViewController: UIViewController {

  var mapView: GMSMapView!
  var locationManager: CLLocationManager!

  override func loadView() {
    locationManager = CLLocationManager()
    locationManager.requestAlwaysAuthorization()

    let camera = GMSCameraPosition.camera(withLatitude: 47.67, longitude: -122.20, zoom: 14)
    mapView = GMSMapView.map(withFrame: CGRect.zero, camera: camera)

    // Show the terms and conditions.
    let companyName = "Ride Sharing Co."
    GMSNavigationServices.showTermsAndConditionsDialogIfNeeded(
      withCompanyName: companyName) { termsAccepted in
      if termsAccepted {
        // Enable navigation if the user accepts the terms.
        self.mapView.isNavigationEnabled = true
      } else {
        // Handle the case when the user rejects the terms and conditions.
      }
    }

    view = mapView
  }

  // TODO: Add navigation code.

}

Цель-C

#import "ViewController.h"
@import GoogleNavigation;

@interface ViewController ()
@end

@implementation ViewController
GMSMapView *_mapView;
CLLocationManager *_locationManager;

- (void)loadView {

  _locationManager = [[CLLocationManager alloc] init];
  [_locationManager requestAlwaysAuthorization];

  GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:47.67
                                                          longitude:-122.20
                                                               zoom:14];
  _mapView = [GMSMapView mapWithFrame:CGRectZero camera:camera];

  // Show the terms and conditions.
  NSString *companyName = @"Ride Sharing Co.";
  [GMSNavigationServices
    showTermsAndConditionsDialogIfNeededWithCompanyName:companyName
    callback:^(BOOL termsAccepted) {
     if (termsAccepted) {
       // Enable navigation if the user accepts the terms.
       _mapView.navigationEnabled = YES;
     } else {
       // Handle the case when the user rejects the terms and conditions.
     }
   }];

  self.view = _mapView;
}

// TODO: Add navigation code.

@end