Настройка и демонстрация

Выберите платформу: Android iOS.

На этой странице описано, как настроить библиотеку утилит для Maps SDK для iOS .

Чтобы попробовать эти утилиты, вы можете:

Добавьте библиотеку служебных программ Maps SDK для iOS в проект Xcode.

Выполните следующие шаги, чтобы добавить служебную библиотеку в рабочую область Xcode:

Используйте диспетчер пакетов Swift

  1. Если у вас еще нет проекта Xcode, создайте его сейчас и сохраните на своем локальном компьютере. (Если вы новичок в разработке для iOS, создайте новый проект и выберите шаблон приложения iOS . В Xcode 11.7 или более ранней версии создайте приложение с одним представлением .)
  2. Добавьте Maps SDK для iOS в качестве зависимости. Дополнительные сведения см. в разделе Установка SDK .
  3. В проекте Xcode перейдите в File -> Swift Packages -> Add Package Dependency .
  4. В появившемся окне введите URL-адрес репозитория библиотеки утилит Maps SDK для iOS https://github.com/googlemaps/google-maps-ios-utils и нажмите «Далее» .
    • На этом этапе вам может быть предложено пройти аутентификацию с использованием вашей учетной записи GitHub. Следуйте инструкциям по созданию токена личного доступа GitHub, чтобы продолжить процесс.
  5. В следующем окне выберите переключатель «Версия» , выберите «До следующей основной версии» в раскрывающемся списке и введите последнюю версию библиотеки служебных программ Maps SDK для iOS (например, «6.0.0»).
  6. Щелкните раскрывающийся список рядом с надписью «Добавить в проект» , выберите свой проект и нажмите «Добавить пакет» .

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

  1. Если у вас еще нет проекта Xcode, создайте его сейчас и сохраните на своем локальном компьютере. (Если вы новичок в разработке для iOS, создайте приложение с единым представлением .)
  2. Если у вас еще нет файла pod для вашего проекта, создайте файл с именем Podfile в каталоге вашего проекта. Этот файл определяет зависимости вашего проекта.
  3. Отредактируйте файл модуля вашего проекта и добавьте зависимость от модуля Google-Maps-iOS-Utils . Ниже приведен пример, который включает зависимости, необходимые для Maps SDK для iOS и библиотеки утилит: 
    source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '15.0'

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  use_frameworks!
  pod 'GoogleMaps', '9.0.0'
  pod 'Google-Maps-iOS-Utils', '6.0.0' # x-release-please-version
end
  4. Запустите pod install .
  5. Закройте Xcode, а затем откройте (дважды щелкните) файл .xcworkspace вашего проекта, чтобы запустить Xcode. С этого момента вы должны использовать файл .xcworkspace для открытия проекта.

Примечание. Утилита кластеризации маркеров зависит от дерева квадрантов, но вы можете использовать дерево квадроциклов без кластеризации маркеров. Если вам нужна только утилита Quadtree, вы можете изменить pod 'Google-Maps-iOS-Utils' на 'Google-Maps-iOS-Utils/QuadTree' в своем файле модуля.

Добавьте ключ API в свое приложение

См. раздел «Настройка проекта Xcode» для получения инструкций по созданию ключа API и добавлению его в проект Xcode.

Сборка и запуск проекта

После добавления ключа API соберите и запустите проект.

Используйте утилиту в своем приложении

Дополнительную информацию об использовании каждой утилиты в вашем приложении см. в документации по каждой утилите:

Установите и запустите демо-приложение

Библиотека утилит включает демонстрационное приложение, которое вы можете установить, а затем опробовать каждую утилиту.

Установите демо-приложение одним из этих двух способов:

Используйте файлы с GitHub

  1. Загрузите архив примера кода с GitHub и распакуйте архив.
  2. Откройте окно терминала, перейдите в каталог, в котором вы развернули файлы примеров, и перейдите к соответствующему каталогу примеров для языка, который вы хотите использовать:
    • Для Swift запустите cd google-maps-ios-utils-master/samples/SwiftDemoApp
    • Для Objective-C запустите cd google-maps-ios-utils-master/samples/ObjCDemoApp
  3. Выполните следующую команду:
    pod install
  4. Закройте Xcode, а затем откройте (дважды щелкните) файл .xcworkspace вашего проекта, чтобы запустить Xcode. С этого момента вы должны использовать файл .xcworkspace для открытия проекта.

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

  1. Откройте окно терминала и установите версию 1.6.1: 
    sudo gem install cocoapods -v1.6.1
  2. Получите файлы Google Maps с помощью Cocoapods:
    pod try Google-Maps-iOS-Utils

    При появлении запроса выберите Swift или Objective-C. CocoaPods обновляет ваши репозитории спецификаций, а затем открывает демо-версию во временном проекте Xcode с именем SwiftDemoApp.xcodeproj или ObjCDemoApp.xcodeproj .

Добавьте ключ API в демонстрационное приложение

В разделе «Получить ключ API» вы создаете ключ API для своего приложения. Теперь добавьте этот ключ в проект Xcode для демонстрационного приложения.

Быстрый

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

  1. Добавьте следующий оператор импорта: 
    import GoogleMaps
  2. Отредактируйте следующую строку, чтобы добавить ключ API в двойные кавычки: 
    // Change this key to a valid key registered with the demo app bundle id.
let mapsAPIKey = ""

Цель-C

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

  1. Добавьте следующий оператор импорта: 
    @import GoogleMaps;
  2. Отредактируйте следующую строку, чтобы добавить ключ API в двойные кавычки: 
    // Change this key to a valid key registered with the demo app bundle id.
static NSString *const kMapsAPIKey = @"";

Создайте и запустите демонстрационное приложение

После добавления ключа API соберите и запустите проект:

  • Если вы используете демо-версию Swift, вы можете выбрать, какую утилиту просматривать в приложении.
  • Если вы используете демо-версию Objective-C, вы увидите демо-версию утилиты кластеризации маркеров. Затем вы можете отредактировать демо-версию Objective-C, чтобы опробовать каждую утилиту. Дополнительную информацию см. в разделе «Добавление утилиты в ваше приложение» ниже.