Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

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

В этом руководстве показано, как добавить карту Google в ваше приложение для iOS. На карте есть маркер, также называемый булавкой, для обозначения определенного местоположения.

Получение кода

Клонируйте или загрузите репозиторий примеров Google Maps iOS с GitHub.

Настройка вашего проекта разработки

Выполните следующие действия, чтобы установить Maps SDK для iOS:

  1. Загрузите и установите Xcode версии 13.0 или новее.
  2. Если у вас еще нет CocoaPods , установите его в macOS, выполнив в терминале следующую команду:
    sudo gem install cocoapods
  3. Клонируйте или загрузите репозиторий примеров Google Maps для iOS .
  4. Перейдите в каталог tutorials/map-with-marker .
  5. Запустите команду pod install . Это установит API, указанные в Podfile , вместе со всеми возможными зависимостями.
  6. Откройте (дважды щелкните) файл проекта map-with-marker.xcworkspace , чтобы открыть его в Xcode. Для открытия проекта необходимо использовать файл .xcworkspace .

Получение ключа API и включение необходимых API

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

Начать

Дополнительные сведения см. в разделе Получение ключа API .

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

Быстрый

Добавьте свой ключ API в свой AppDelegate.swift следующим образом:

  1. Обратите внимание, что в файл добавлен следующий оператор импорта:
    import GoogleMaps
  2. Отредактируйте следующую строку в вашем методе application(_:didFinishLaunchingWithOptions:) , заменив YOUR_API_KEY вашим ключом API:
    GMSServices.provideAPIKey("YOUR_API_KEY")

Цель-C

Добавьте свой ключ API в AppDelegate.m следующим образом:

  1. Обратите внимание, что в файл добавлен следующий оператор импорта:
    @import GoogleMaps;
  2. Отредактируйте следующую строку в вашем методе application(_:didFinishLaunchingWithOptions:) , заменив YOUR_API_KEY вашим ключом API:
    [GMSServices provideAPIKey:@"YOUR_API_KEY"];

Создание и запуск вашего приложения

  1. Подключите устройство iOS к компьютеру или выберите симулятор во всплывающем меню схемы Xcode.
  2. Если вы используете устройство, убедитесь, что службы определения местоположения включены. Если вы используете симулятор, выберите местоположение в меню « Функции ».
  3. В Xcode щелкните пункт меню « Продукт/Выполнить » (или значок кнопки воспроизведения).

Xcode создает приложение, а затем запускает его на устройстве или в симуляторе.

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

Исправление проблем:

  • Если вы не видите карту, убедитесь, что вы получили ключ API и добавили его в приложение, как описано выше . Проверьте консоль отладки Xcode на наличие сообщений об ошибках, связанных с ключом API.
  • Если вы ограничили ключ API идентификатором пакета iOS, отредактируйте ключ, добавив идентификатор пакета для приложения: com.google.examples.map-with-marker .
  • Убедитесь, что у вас есть хорошее соединение WiFi или GPS.
  • Используйте инструменты отладки Xcode для просмотра журналов и отладки приложения.

Понимание кода

  1. Создайте карту и установите ее в качестве представления в loadView() .

    Быстрый

    // Create a GMSCameraPosition that tells the map to display the
    // coordinate -33.86,151.20 at zoom level 6.
    let camera = GMSCameraPosition.camera(withLatitude: -33.86, longitude: 151.20, zoom: 6.0)
    let mapView = GMSMapView.map(withFrame: CGRect.zero, camera: camera)
    view = mapView
          

    Цель-C

    // Create a GMSCameraPosition that tells the map to display the
    // coordinate -33.86,151.20 at zoom level 6.
    GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:-33.86
                                                            longitude:151.20
                                                                 zoom:6.0];
    GMSMapView *mapView = [[GMSMapView alloc] initWithFrame: CGRectZero camera:camera];
    self.view = mapView;
          
  2. Добавьте маркер на карту в loadView() .

    Быстрый

    // Creates a marker in the center of the map.
    let marker = GMSMarker()
    marker.position = CLLocationCoordinate2D(latitude: -33.86, longitude: 151.20)
    marker.title = "Sydney"
    marker.snippet = "Australia"
    marker.map = mapView
          

    Цель-C

    // Creates a marker in the center of the map.
    GMSMarker *marker = [[GMSMarker alloc] init];
    marker.position = CLLocationCoordinate2DMake(-33.86, 151.20);
    marker.title = @"Sydney";
    marker.snippet = @"Australia";
    marker.map = mapView;
          

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

Поздравляем! Вы создали приложение для iOS, которое отображает карту Google с маркером для указания определенного местоположения. Вы также узнали, как использовать Maps SDK для iOS .

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

Узнайте больше об объекте карты и о том, что можно делать с маркерами .