Настройка

На этой странице описано, что необходимо сделать для начала работы с SDK Maps 3D для 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 на странице выбора проекта нажмите «Создать проект» , чтобы начать создание нового проекта Cloud.

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

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

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

Облачный SDK 

gcloud projects create "PROJECT"

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

Шаг 2

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

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

Для включения одного или нескольких API или SDK:

Консоль

  1. Список API и SDK платформы Google Maps, которые можно включить, можно найти на странице «Библиотека API карт» в консоли Cloud:

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

  2. Щелкните по API или SDK, который хотите включить.
    • Если на кнопке написано ENABLE , нажмите эту кнопку, чтобы включить 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 Maps» > «Учетные данные» .

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

  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 Maps» .

Создайте проект 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, затем перейдите в меню Файл > Добавить зависимости пакета .
  • Введите в качестве URL-адреса https://github.com/googlemaps/ios-maps-3d-sdk , нажмите Enter , чтобы загрузить пакет, и нажмите «Добавить пакет».
  • В окне «Выбор продуктов пакета» убедитесь, что GoogleMaps3D будет добавлен к указанному вами основному целевому объекту. После завершения нажмите «Добавить пакет» .
  • Чтобы проверить установку, перейдите в раздел «Общие» целевого проекта. В разделах «Фреймворки», «Библиотеки» и «Встроенный контент» вы должны увидеть установленные пакеты. Вы также можете просмотреть раздел «Зависимости пакетов» в 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)
  }
}

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

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

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

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

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