Добавление карты

Карты представлены в API классом GMSMapView , подклассом UIView . Карта — самый важный объект в Maps SDK для iOS, предоставляющий необходимые методы для добавления, удаления и управления другими объектами, такими как маркеры и полилинии.

Введение

Maps SDK для iOS позволяет отображать карты Google в вашем приложении iOS. Эти карты выглядят так же, как карты в приложении Google Maps для iOS, и SDK предоставляет многие из тех же функций.

Помимо картографической функциональности, API также поддерживает ряд взаимодействий, соответствующих модели пользовательского интерфейса iOS. Например, вы можете настроить взаимодействие с картой, определив ответчики, реагирующие на жесты пользователя, такие как касание и двойное касание.

Ключевым классом при работе с объектом карты является класс GMSMapView . GMSMapView автоматически выполняет следующие операции:

• Подключение к сервису Google Maps.
• Загрузка фрагментов карты.
• Отображение плиток на экране устройства.
• Отображение различных элементов управления, таких как панорамирование и масштабирование.
• Реагирование на жесты панорамирования и масштабирования путем перемещения карты и изменения масштаба.
  • Реагирование на жесты двумя пальцами путем изменения угла обзора карты.

Помимо этих автоматических операций, вы можете управлять поведением и внешним видом карты с помощью свойств и методов класса GMSMapView . Используйте GMSMapView для добавления и удаления маркеров, наложений на земную поверхность и полилиний, изменения типа отображаемой карты и управления отображаемыми на ней объектами с помощью класса GMSCameraPosition .

Создавайте карты с помощью SwiftUI

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

Maps SDK для iOS создан на основе UIKit и не предоставляет представления, совместимого со SwiftUI. Для добавления карт в SwiftUI требуется соответствие требованиям UIViewRepresentable или UIViewControllerRepresentable . Подробнее см. в практической работе по добавлению карты в приложение iOS с помощью SwiftUI .

Добавить карту

Основные шаги по добавлению карты:

1. Чтобы получить SDK, получить ключ API и добавить необходимые фреймворки, выполните следующие действия:

   1. Настройка в консоли Google Cloud

   2. Используйте ключ API

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

   4. В AppDelegate укажите свой ключ API для метода класса provideAPIKey: в GMSServices .

   5. Создайте или обновите ViewController . Если карта отображается, когда этот контроллер представления становится видимым, обязательно создайте его в методе viewDidLoad .

   6. При инициализации вида карты задайте параметры конфигурации с помощью GMSMapViewOptions . Свойства включают frame , camera , mapID , backgroundColor или screen .

   7. Задайте свойство camera в параметрах карты с помощью объекта GMSCameraPosition . Оно определяет центр и уровень масштабирования карты.

   8. Создайте и создайте экземпляр класса GMSMapView с помощью метода GMSMapView options: Если эта карта будет использоваться как единственное представление контроллера представления, значение по умолчанию frame параметров карты CGRectZero можно использовать в качестве frame представления — размер карты изменится автоматически.

   9. Установите объект GMSMapView в качестве представления контроллера представления. Например, self.view = mapView; .

В примере ниже в приложение добавляется карта с центром в центре Сингапура.

import GoogleMaps

class MapObjects : UIViewController {
  override func viewDidLoad() {
    super.viewDidLoad()

    let options = GMSMapViewOptions()
    options.camera = GMSCameraPosition(latitude: 1.285, longitude: 103.848, zoom: 12)
    options.frame = self.view.bounds;

    let mapView = GMSMapView(options:options)
    self.view = mapView
  }
}

- (void)viewDidLoad {
  [super viewDidLoad];

  GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init];
  options.camera = [GMSCameraPosition cameraWithLatitude:1.285
                                                        longitude:103.848
                                                             zoom:12];
  options.frame = self.view.bounds;

  GMSMapView *mapView = [[GMSMapView alloc] initWithOptions:options];
  self.view = mapView;
}

После выполнения этих шагов вы можете продолжить настройку объекта GMSMapView .

Что дальше?

После выполнения этих шагов вы сможете настроить параметры карты .