Spec-Zone .ru
спецификации, руководства, описания, API

Библиотека Разработчика iOS

Разработчик

Ссылка платформы WatchKit ссылка класса WKInterfaceMap

Опции
Развертывание Target:

На этой странице
Язык:

WKInterfaceMap

Наследование

Соответствует

Оператор импорта

Swift

import WatchKit

Objective C

@import WatchKit;

Доступность

Доступный в iOS 8.2 и позже.

A WKInterfaceMap отображения объекта неинтерактивная карта для расположения Вы указываете. Карты должны быть сконфигурированы динамично от Вашего контроллера интерфейса. Используйте методы WKInterfaceMap класс, чтобы указать видимую область карты и добавить любые аннотации или интересные места. Ответвление карты запускает приложение Карт на Часах Apple пользователя и выводит на экран соответствующее расположение.

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

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

Swift

  • @IBOutlet weak var myMap: WKInterfaceMap!

Objective C

  • @property (weak, nonatomic) IBOutlet WKInterfaceMap* myMap;

Во время инициализации Вашего контроллера интерфейса WatchKit создает новый экземпляр этого класса и присваивает его Вашему выходу. В той точке можно использовать объект в выходе для внесения изменений в экранную карту.

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

Соедините интерфейсом с параметрами конфигурации разработчика

XCode позволяет Вам сконфигурировать информацию о своем объекте группового интерфейса в Вашем файле раскадровки. Таблица 1 перечисляет атрибуты, которые можно сконфигурировать в раскадровке и их значении.

Табличные 1WatchKit атрибуты карты

Атрибут

Описание

Включенный

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

Указание области карты
  • setVisibleMapRect (_:) - setVisibleMapRect:

    Изменяет видимую область карты на указанный прямоугольник карты.

    Объявление

    Swift

    func setVisibleMapRect(_ mapRect: MKMapRect)

    Objective C

    - (void)setVisibleMapRect:(MKMapRect)mapRect

    Параметры

    mapRect

    Область, которая будет выведена на экран, указанная как прямоугольник карты. Размер прямоугольника обеспечивает неявное значение изменения масштаба для карты. Для получения дополнительной информации о MKMapRect введите, посмотрите Ссылку Типов данных MapKit.

    Обсуждение

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

    Изменение видимой области может потребовать, чтобы загрузка дополнительных мозаик карты представила карту. Загрузка мозаик требует сетевого соединения на iPhone пользователя.

    Оператор импорта

    Objective C

    @import WatchKit;

    Swift

    import WatchKit

    Доступность

    Доступный в iOS 8.2 и позже.

  • setRegion (_:) - setRegion:

    Изменяет видимую область карты на указанную координатную область.

    Объявление

    Swift

    func setRegion(_ coordinateRegion: MKCoordinateRegion)

    Objective C

    - (void)setRegion:(MKCoordinateRegion)coordinateRegion

    Параметры

    coordinateRegion

    Новая область карты, которая будет выведена на экран. Значение промежутка этого параметра обеспечивает неявное значение изменения масштаба для карты. Для получения дополнительной информации о MKCoordinateRegion введите, посмотрите Ссылку Типов данных MapKit.

    Обсуждение

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

    Изменение видимой области может потребовать, чтобы загрузка дополнительных мозаик карты представила карту. Загрузка мозаик требует сетевого соединения на iPhone пользователя.

    Оператор импорта

    Objective C

    @import WatchKit;

    Swift

    import WatchKit

    Доступность

    Доступный в iOS 8.2 и позже.

Управление аннотациями карты
  • addAnnotation (_: withImage:centerOffset:) - addAnnotation:withImage:centerOffset:

    Выводит на экран указанное изображение поверх карты.

    Объявление

    Swift

    func addAnnotation(_ location: CLLocationCoordinate2D, withImage image: UIImage?, centerOffset offset: CGPoint)

    Objective C

    - (void)addAnnotation:(CLLocationCoordinate2D)location withImage:(UIImage *)image centerOffset:(CGPoint)offset

    Параметры

    location

    Расположение, в котором можно вывести на экран изображение.

    image

    Изображение для отображения в указанном расположении. Если значение этого параметра nil, карта добавляет красный контакт в указанном расположении.

    offset

    Смещение (в точках), в котором можно разместить центр изображения. Обычно, центральная точка изображения аннотации помещается в указанное расположение на карте. Используйте этот параметр, чтобы изменить местоположение изображения относительно той точки. Положительные значения смещения перемещают изображение аннотации вниз и вправо, в то время как отрицательные величины повышают его и налево.

    Обсуждение

    Этот метод добавляет изображение к карте в указанном географическом местоположении. Изображение располагается чуть выше фактической координаты и центрируется на координате горизонтально.

    Оператор импорта

    Objective C

    @import WatchKit;

    Swift

    import WatchKit

    Доступность

    Доступный в iOS 8.2 и позже.

  • addAnnotation (_: withImageNamed:centerOffset:) - addAnnotation:withImageNamed:centerOffset:

    Выводит на экран изображение от пакета приложения WatchKit поверх карты.

    Объявление

    Swift

    func addAnnotation(_ location: CLLocationCoordinate2D, withImageNamed name: String?, centerOffset offset: CGPoint)

    Objective C

    - (void)addAnnotation:(CLLocationCoordinate2D)location withImageNamed:(NSString *)name centerOffset:(CGPoint)offset

    Параметры

    location

    Расположение, в котором можно вывести на экран изображение.

    name

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

    offset

    Смещение (в точках), в котором можно разместить центр изображения. Обычно, центральная точка изображения аннотации помещается в указанное расположение на карте. Используйте этот параметр, чтобы изменить местоположение изображения относительно той точки.

    Обсуждение

    Этот метод добавляет изображение к карте в указанном географическом местоположении. Изображение располагается чуть выше фактической координаты и центрируется на координате горизонтально.

    Оператор импорта

    Objective C

    @import WatchKit;

    Swift

    import WatchKit

    Доступность

    Доступный в iOS 8.2 и позже.

  • addAnnotation (_: withPinColor:) - addAnnotation:withPinColor:

    Добавляет контакт к карте в указанном расположении.

    Объявление

    Swift

    func addAnnotation(_ location: CLLocationCoordinate2D, withPinColor pinColor: WKInterfaceMapPinColor)

    Objective C

    - (void)addAnnotation:(CLLocationCoordinate2D)location withPinColor:(WKInterfaceMapPinColor)pinColor

    Параметры

    location

    Расположение, в котором можно вывести на экран контакт.

    pinColor

    Цвет контакта. Для списка возможных значений посмотрите WKInterfaceMapPinColor.

    Обсуждение

    Контакт расположен так, чтобы основа контакта находилась поверх указанной координаты.

    Оператор импорта

    Objective C

    @import WatchKit;

    Swift

    import WatchKit

    Доступность

    Доступный в iOS 8.2 и позже.

  • removeAllAnnotations () - removeAllAnnotations

    Удаляет все аннотации из карты.

    Объявление

    Swift

    func removeAllAnnotations()

    Objective C

    - (void)removeAllAnnotations

    Оператор импорта

    Objective C

    @import WatchKit;

    Swift

    import WatchKit

    Доступность

    Доступный в iOS 8.2 и позже.

Константы
  • WKInterfaceMapPinColor

    Константы для цветов канцелярской кнопки.

    Объявление

    Swift

    enum WKInterfaceMapPinColor : Int { case Red case Green case Purple }

    Objective C

    typedef enum WKInterfaceMapPinColor : NSInteger { WKInterfaceMapPinColorRed, WKInterfaceMapPinColorGreen, WKInterfaceMapPinColorPurple, } WKInterfaceMapPinColor;

    Константы

    • Red

      WKInterfaceMapPinColorRed

      Красный контакт.

      Доступный в iOS 8.2 и позже.

    • Green

      WKInterfaceMapPinColorGreen

      Зеленый контакт.

      Доступный в iOS 8.2 и позже.

    • Purple

      WKInterfaceMapPinColorPurple

      Фиолетовый контакт.

      Доступный в iOS 8.2 и позже.

    Оператор импорта

    Objective C

    @import WatchKit;

    Swift

    import WatchKit

    Доступность

    Доступный в iOS 8.2 и позже.