Примеры кода для Places SDK для iOS

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

В демонстрационном приложении Places SDK для iOS на GitHub, которое поставляется вместе с Places SDK для iOS, показано, как использовать ряд функций, в том числе автозаполнение мест и фотографии мест. Кроме того, на каждой странице этого руководства для разработчиков можно найти фрагменты кода. Импортируйте и соберите приложение, добавьте ключ API, посмотрите демоверсию и примените полученный образец кода в качестве стартовой точки для вашего приложения.

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

Как запустить образец приложения локально

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

  1. Скачайте архив с примером кода с GitHub и распакуйте его. Вы также можете клонировать хранилище в локальный каталог: 
    git clone https://github.com/googlemaps-samples/ios-places-sdk-samples.git

  2. Откройте окно терминала, перейдите в каталог, в который вы распаковали файлы примеров, и выберите каталог нужной версии:

    SwiftUI

    cd ios-places-sdk-samples/GooglePlacesDemos/
open GooglePlacesDemos.xcodeproj

    Swift

    cd ios-places-sdk-samples/GooglePlaces-Swift/
open GooglePlacesSwiftDemos.xcodeproj

    Objective-C

    cd ios-places-sdk-samples/Archive/GooglePlaces
open GooglePlacesXCFrameworkDemos.xcodeproj
  3. В проекте Xcode выберите File (Файл) > Add Package Dependencies (Добавить зависимости пакетов). Введите URL https://github.com/googlemaps/ios-places-sdk, нажмите Ввод, чтобы получить пакет, и нажмите Add Package (Добавить пакет).
  4. Включите Places SDK для iOS для проекта в консоли Google Cloud.
  5. Получите ключ API из проекта, в котором включен Places API и/или Places API (новая версия).
  6. Добавьте ключ API в приложение, следуя приведенным ниже инструкциям.

    SwiftUI

    Создайте локальный файл конфигурации с названием GooglePlacesDemos.xcconfig для ключа API в том же каталоге, где находится файл Info.plist демонстрационного приложения (GooglePlacesDemos/GooglePlacesDemos).

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

    PLACES_API_KEY = YOUR_PLACES_API_KEY

    Замените YOUR_PLACES_API_KEY ключом API, полученным на предыдущих шагах.

    Инструкции по созданию локального файла конфигурации приведены в статье Формат файла настроек конфигурации (xcconfig).

    Swift

    Отредактируйте файл SDKDemoAPIKey и вставьте ключ API в нужную константу. Пример:

    let placesAPIKey = "YOUR_API_KEY"

    Если она есть, удалите следующую строку:

    #error (Register for API Key and insert here. Then delete this line.)

    Если Xcode предложит разблокировать файл SDKDemoAPIKey для редактирования, выберите Unlock (Разблокировать).

    Objective-C

    Отредактируйте файл SDKDemoAPIKey и вставьте ключ API в нужную константу. Пример:

    static NSString *const kAPIKey = @"YOUR_API_KEY";

    Если она есть, удалите следующую строку:

    #error (Register for API Key and insert here. Then delete this line.)

    Если Xcode предложит разблокировать файл SDKDemoAPIKey для редактирования, выберите Unlock (Разблокировать).

  7. Создайте приложение.
  8. Если при первом запуске сборка не удалась или произошел сбой приложения с ошибкой, связанной с ключом API, убедитесь, что вы указали ключи, требуемые в инструкциях выше.
  9. Если вы запустите пример приложения, в окне симулятора iOS появится список демонстраций Places.
  10. Если появится запрос на доступ к местоположению, нажмите Разрешить.
  11. Теперь выбранный вами пример готов к запуску.