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

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

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

Чтобы опробовать эти утилиты, вы можете сделать одно из следующих действий:

Добавьте библиотеку утилит Maps SDK для iOS в проект Xcode.

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

Используйте менеджер пакетов Swift.

  1. Если у вас ещё нет проекта Xcode, создайте его сейчас и сохраните на локальном компьютере. (Если вы новичок в разработке под iOS, создайте новый проект и выберите шаблон iOS App . В Xcode 11.7 или более ранних версиях создайте Single View Application .)
  2. Добавьте 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. Щелкните раскрывающийся список рядом с кнопкой «Добавить в проект» , выберите свой проект и нажмите «Добавить пакет» .

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

Инструкции по генерации ключа API и его добавлению в проект Xcode см. в разделе «Настройка проекта 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 .

Добавьте ключ 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 = ""

Objective-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, чтобы попробовать каждую из утилит. Дополнительную информацию см. в разделе « Добавление утилиты в ваше приложение» ниже.