Настройка

Данный продукт или функция являются экспериментальными (предварительно выпущенными). Поддержка предварительно выпущенных продуктов и функций может быть ограничена, а изменения в них могут быть несовместимы с другими предварительно выпущенными версиями. На предварительно выпущенные продукты и функции распространяются Условия использования сервиса Google Maps Platform . Для получения дополнительной информации см. описания этапов запуска .

На этой странице описано, что необходимо сделать для начала работы с 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 и следующих командах можно узнать здесь:

• gcloud projects create

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

Шаг 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 и следующих командах можно узнать здесь:

• gcloud services enable
• gcloud services disable

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

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

Примечание: Включение Places API также активирует библиотеку Places Library, Maps JavaScript API, Places SDK для Android и Places SDK для iOS.

Шаг 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 и следующих командах можно узнать здесь:

• gcloud services api-keys create

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

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

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

Примечание: Следующая информация актуальна при размещении вашего приложения в интернет-магазине.

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

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

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

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