Настройка

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

Требования

Чтобы использовать Maps 3D SDK для iOS, ваш проект и целевые устройства должны соответствовать следующим требованиям:

• Минимальная версия iOS. Целевая версия iOS – 16.0 или более поздняя.
• Xcode: Xcode версии 16.0 или более поздней.

Как настроить проект Google Cloud и ключ API

Чтобы начать работу с Maps 3D SDK для iOS, вам нужно настроить проект Google Cloud и ключ API. Для этого выполните следующие действия:

Шаг 1

Консоль

1. Перейдите на страницу выбора проекта в консоли Google Cloud и нажмите Create Project (Создать проект).

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

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

   Мы предлагаем бесплатный пробный период для использования Google Cloud. Он длится 90 дней или пока сумма расходов не достигнет 300 долл. США в зависимости от того, что произойдет раньше. Отказаться от предложения можно в любое время. Ознакомьтесь с информацией о бонусах в платежных аккаунтах и об оплате.

Cloud SDK

gcloud projects create "PROJECT"

Прочитайте статьи о Google Cloud SDK, установке Cloud SDK и следующих командах:

• gcloud projects create

Примечание. Если вы не планируете использовать ресурсы, которые появятся в результате выполнения этого упражнения, не выбирайте существующий проект, а создайте новый. После завершения упражнения вы сможете удалить проект, и все ресурсы, связанные с ним, также будут удалены.

Шаг 2

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

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

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

Консоль

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

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

2. Нажмите на API или SDK, который вы хотите включить.
   • Если появится кнопка Включить, нажмите ее, чтобы активировать API или SDK.
   • Если отобразится кнопка Управление API, это означает, что API или SDK уже включен и вам ничего не нужно делать.
   • Нажав на любую из этих кнопок, вы перейдете на панель управления для выбранного API или SDK. Чтобы деактивировать API или SDK для проекта, нажмите на кнопку Отключить.

Cloud SDK

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

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 и следующих командах:

• gcloud services enable
• gcloud services disable

Чтобы включить Environment API, используйте следующую команду:

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

Примечание. Если вы включите Places API, вместе с ним будут активированы библиотека Places, Maps JavaScript API, Places SDK для Android и Places SDK для iOS.

Шаг 3

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

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

Чтобы создать ключ API, выполните следующие действия.

Cloud Console

1. Откройте страницу Google Maps Platform > Credentials (Платформа Google Карт > Учетные данные).

   Перейти к настройкам учетных данных

2. На странице Credentials (Учетные данные) нажмите Create credentials > API key (Создать учетные данные > Ключ API).
   Появится диалоговое окно с созданным ключом API.
3. Нажмите Close (Закрыть).
   Новый ключ API можно будет найти на странице Credentials (Учетные данные) в разделе API keys (Ключи API).
   Не забудьте настроить ограничения для ключа API, прежде чем использовать его в рабочей среде.

Cloud SDK

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

Прочитайте статьи о Google Cloud SDK, установке Cloud SDK и следующих командах:

• gcloud services api-keys create

Чтобы включить 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 Package Manager

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

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

• Откройте файл project или workspace в Xcode и выберите File (Файл) > Add Package Dependencies (Добавить зависимости пакетов).
• Введите URL https://github.com/googlemaps/ios-maps-3d-sdk, нажмите Ввод, чтобы получить пакет, и нажмите "Добавить пакет".
• В окне Выбор продуктов пакета убедитесь, что GoogleMaps3D будет добавлен в основную цель. Нажмите Добавить пакет.
• Чтобы проверить установку, перейдите на панель General (Общие). В разделе Frameworks, Libraries, and Embedded Content (Фреймворки, библиотеки и встроенный контент) вы увидите установленные пакеты. Вы также можете проверить пакет и его версию в разделе Package Dependencies (Зависимости пакета) в Project Navigator (Навигатор проекта).

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

Swift Package Manager

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

Ключ API может быть указан в точке входа приложения или отдельно для каждого представления карты. Если ключ API указан и в точке входа, и в представлениях карты, консоль выдаст ошибку.

Шаг 4 (необязательно). Проверьте файл манифеста конфиденциальности Apple

Примечание. Информация ниже относится к развертыванию приложения в интернет-магазине.

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

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

Дальнейшие действия

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