Примеры кода 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

    Быстрый 

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

    Objective-C 

    cd ios-places-sdk-samples/Archive/GooglePlaces
open GooglePlacesXCFrameworkDemos.xcodeproj
  3. В проекте Xcode перейдите в меню Файл > Добавить зависимости пакета . Введите https://github.com/googlemaps/ios-places-sdk в качестве URL-адреса, нажмите Enter , чтобы подключить пакет, и нажмите Добавить пакет .
  4. Включите SDK Places для iOS и SDK Maps для 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 и MAPS_API_KEY = YOUR_MAPS_API_KEY .

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

    Для получения справки по созданию локального файла конфигурации см. раздел «Формат файла настроек конфигурации (xcconfig)» .

    Быстрый

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

    let placesAPIKey = "YOUR_API_KEY"

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

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

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

    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 для редактирования, выберите «Разблокировать» .

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