Настройка

На этой странице описывается, что нужно сделать для начала работы с Maps 3D SDK для iOS. Процесс настройки включает в себя настройку проекта Google Cloud и API для использования с SDK, а также настройку проекта Xcode. Выполните эти шаги, прежде чем добавлять свою первую 3D-карту в приложение .

Настройте проект Google Cloud и ключ API

Прежде чем приступить к разработке с помощью Maps 3D SDK для iOS, вам необходимо настроить проект Google Cloud и ключ API для использования с Maps 3D SDK для iOS, выполнив следующие шаги:

Шаг 1

Консоль

  1. В консоли Google Cloud на странице выбора проекта нажмите «Создать проект» , чтобы начать создание нового облачного проекта.

    Перейти на страницу выбора проекта

  2. Убедитесь, что для вашего облачного проекта включена функция выставления счетов. Убедитесь, что для вашего проекта включена функция выставления счетов .

    Google Cloud предлагает пробный период стоимостью 0,00 долларов США. Срок действия пробного периода истекает по истечении 90 дней или после накопления на счете средств на сумму 300 долларов США, в зависимости от того, что наступит раньше. Отменить подписку можно в любое время. Подробнее см. в разделах «Биллинговые кредиты» и «Выставление счетов».

Облачный SDK 

gcloud projects create "PROJECT"

Узнайте больше о Google Cloud SDK , установке Cloud SDK и следующих командах:

Шаг 2

Чтобы использовать платформу Google Карт, необходимо включить API или SDK, которые вы планируете использовать в своем проекте.

Обратите внимание, что для некоторых интеграций требуется включить несколько API/SDK. Если вы не уверены, какие API или SDK нужно включить, попробуйте воспользоваться API Picker или обратитесь к документации по нужному API/SDK.

Чтобы включить один или несколько API или SDK:

Консоль

  1. Ознакомьтесь с API и SDK платформы Google Карт, которые можно включить, перейдя на страницу библиотеки API Карт в консоли Cloud:

    Перейти на страницу библиотеки API Карт

  2. Щелкните API или SDK, который вы хотите включить.
    • Если на кнопке написано ВКЛЮЧИТЬ , нажмите ее, чтобы включить API или SDK.
    • Если на кнопке написано УПРАВЛЕНИЕ , API или SDK уже включены и вам не нужно ничего делать дополнительно.
    • При нажатии любой из кнопок откроется панель управления API или SDK. (Нажмите кнопку ОТКЛЮЧИТЬ , чтобы удалить API или SDK из этого проекта.)

Облачный SDK

Следующая команда включает все API карт, маршрутов и мест:

gcloud services enable \
    --project "PROJECT" \
    "addressvalidation.googleapis.com" \
    "areainsights.googleapis.com" \
    "tile.googleapis.com" \
    "aerialview.googleapis.com" \
    "elevation-backend.googleapis.com" \
    "routes.googleapis.com" \
    "geocoding-backend.googleapis.com" \
    "geolocation.googleapis.com" \
    "maps-android-backend.googleapis.com" \
    "maps-backend.googleapis.com" \
    "maps-embed-backend.googleapis.com" \
    "maps-ios-backend.googleapis.com" \
    "mapsplatformdatasets.googleapis.com" \
    "places-backend.googleapis.com" \
    "roads.googleapis.com" \
    "routeoptimization.googleapis.com" \
    "static-maps-backend.googleapis.com" \
    "street-view-image-backend.googleapis.com" \
    "timezone-backend.googleapis.com"

Узнайте больше о Google Cloud SDK , установке Cloud SDK и следующих командах:

Используйте эту команду для включения API среды:

gcloud services enable \
    --project "PROJECT" \
    "airquality.googleapis.com" \
    "solar.googleapis.com" \
    "pollen.googleapis.com" \
    "weather.googleapis.com"

Шаг 3

Этот шаг касается только процесса создания API-ключа. Если вы используете API-ключ в рабочей среде, мы настоятельно рекомендуем ограничить его использование. Подробнее см. на странице «Использование API-ключей» для конкретного продукта.

Ключ API — это уникальный идентификатор, который аутентифицирует запросы, связанные с вашим проектом, для целей использования и выставления счетов. С вашим проектом должен быть связан хотя бы один ключ API.

Чтобы создать ключ API:

Консоль

  1. Перейдите на страницу «Платформа Google Карт» > «Учетные данные» .

    Перейти на страницу «Учетные данные»

  2. На странице «Учетные данные» нажмите Создать учетные данные > Ключ API .
    В диалоговом окне создания ключа API отобразится ваш недавно созданный ключ API.
  3. Нажмите «Закрыть».
    Новый ключ API указан на странице «Учетные данные» в разделе «Ключи API» .
    (Не забудьте ограничить ключ API перед его использованием в производстве.)

Облачный SDK 

gcloud services api-keys create \
    --project "PROJECT" \
    --display-name "DISPLAY_NAME"

Узнайте больше о Google Cloud SDK , установке Cloud SDK и следующих командах:

Чтобы включить SDK, посетите страницу Maps 3D SDK для iOS в консоли Google Cloud. Подробнее об этом см. в статье «Начало работы с платформой Google Карт» .

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

В этом разделе объясняется, как создать и настроить проект Xcode для использования с Maps 3D SDK для iOS.

После включения биллинга и создания ключа API вы готовы настроить проект Xcode, который вы используете для разработки своего приложения.

Шаг 1: Установите необходимое программное обеспечение

Чтобы создать проект с использованием Maps 3D SDK для iOS, необходимо загрузить и установить:

  • Xcode версии 16.0 или более поздней

Шаг 2: Создайте проект Xcode и установите Maps 3D SDK для iOS

Менеджер пакетов Swift

Maps 3D SDK для iOS можно установить с помощью Swift Package Manager.

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

  • Откройте project или workspace Xcode, затем перейдите в Файл > Добавить зависимости пакета .
  • Введите https://github.com/googlemaps/ios-maps-3d-sdk в качестве URL-адреса, нажмите Enter , чтобы загрузить пакет, и нажмите «Добавить пакет».
  • В окне «Выбрать пакет продуктов» убедитесь, что GoogleMaps3D будет добавлен в выбранный вами основной целевой объект. После этого нажмите «Добавить пакет» .
  • Чтобы проверить установку, перейдите на панель «Общие» вашей целевой платформы. В разделе «Фреймворки», «Библиотеки» и «Встроенный контент» вы увидите установленные пакеты. Вы также можете просмотреть раздел «Зависимости пакетов» в «Навигаторе проектов», чтобы проверить пакет и его версию.

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

Менеджер пакетов Swift

Добавьте свой ключ API в основную точку входа вашего приложения (или в любое время до загрузки карты) следующим образом.

  1. Добавьте следующий оператор импорта: 
    import GoogleMaps3D
  2. Добавьте следующий метод. Замените YOUR_API_KEY на ваш ключ API. 
    struct ContentView: View {
  init () {
    Map.apiKey = "YOUR_API_KEY"
  }

  var body: some View {
    Map(mode: .hybrid)
  }
}

Шаг 4 (необязательно): проверьте файл Apple Privacy Manifest

Apple требует предоставления сведений о конфиденциальности приложений в App Store.

Файл манифеста конфиденциальности Apple входит в комплект ресурсов SDK. Чтобы убедиться в наличии файла манифеста конфиденциальности и изучить его содержимое, создайте архив приложения и сгенерируйте отчёт о конфиденциальности на основе архива.

Следующие шаги

Теперь, когда у вас есть проект Google Cloud, ключ API и проект Xcode, настроенные для использования с Maps 3D SDK для iOS, вы можете добавить 3D-карту в свое приложение .