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

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

Разработчик

Ссылка платформы MapKit ссылка класса MKMapView

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

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

MKMapView

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

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

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

Swift

import MapKit

Objective C

@import MapKit;

Доступность

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

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

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

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

Можно также использовать спроектированные координаты карты вместо областей для указания некоторых значений. При проектировании кривой поверхности земного шара на плоскую поверхность Вы получаете двумерную версию карты, где строки долготы, кажется, параллельны. Для указания расположений и расстояний Вы используете MKMapPoint, MKMapSize, и MKMapRect типы данных.

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

Аннотирование карты

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

Объект пометок является любым объектом, соответствующим MKAnnotation протокол. Объекты пометок обычно реализуются с помощью существующих классов в модели данных приложения. Это позволяет Вам управлять данными аннотации непосредственно, но все еще делать их доступными для представления карты. Каждый объект пометок содержит информацию о расположении аннотации на карте вместе с дескриптивной информацией, которая может быть выведена на экран в выноске.

Представление объектов пометок на экране обрабатывается представлением аннотации, которое является экземпляром MKAnnotationView класс. Представление аннотации ответственно за представление данных аннотации в пути, который целесообразен. Например, приложение Карт использует значок контакта для обозначения отдельных моментов процента по карте. (Платформа Набора Карты предлагает MKPinAnnotationView класс для подобных аннотаций в Ваших собственных приложениях.) Вы могли также создать представления аннотации, покрывающие большие части карты.

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

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

Добавление оверлейных программ к карте

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

В iOS 7 и OS X v10.9 и позже, представление наложения обрабатывается объектом средства рендеринга наложения, который является экземпляром MKOverlayRenderer класс. Задание средства рендеринга должно нарисовать содержание наложения на экран, когда спросили сделать так представлением карты. Например, если у Вас есть простое наложение, представляющее маршрут шины, Вы могли использовать средство рендеринга ломаной линии для разграничивания сегментов, прослеживающих маршрут шины. Вы могли также определить пользовательское средство рендеринга, рисующее и маршрут шины и значки в расположении каждой автобусной остановки. При указании оверлейных программ можно добавить их к определенным уровням карты, позволяющей им быть представленными выше или ниже других типов содержания карты. До iOS 7 оверлейные программы нарисованы на экранных представлениях наложения использования, которые являются экземплярами MKOverlayView класс.

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

Доступ к свойствам карты
  • mapType Свойство

    Тип данных выведен на экран представлением карты.

    Объявление

    Swift

    var mapType: MKMapType

    Objective C

    @property(nonatomic) MKMapType mapType

    Обсуждение

    Изменение значения в этом свойстве может заставить получатель начинать загружать новое содержание карты. Например, изменение от MKMapTypeStandard к MKMapTypeSatellite мог бы заставить его начинать загружать спутниковое формирование изображений, необходимое для карты. Если новые данные необходимы, однако, они загружаются асинхронно, и надлежащие сообщения отправляются делегату получателя, указывающему состояние работы.

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

    Objective C

    @import MapKit;

    Swift

    import MapKit

    Доступность

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

  • zoomEnabled Свойство

    Булево значение, определяющее, может ли пользователь использовать жесты повышения для увеличивания масштаб и из карты.

    Объявление

    Swift

    var zoomEnabled: Bool

    Objective C

    @property(nonatomic, getter=isZoomEnabled) BOOL zoomEnabled

    Обсуждение

    Это свойство управляет только взаимодействием с пользователем с картой. Если Вы устанавливаете значение этого свойства к NOfalse, можно все еще изменить уровень изменения масштаба программно путем изменения значения в region свойство.

    Значение по умолчанию этого свойства YEStrue.

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

    Objective C

    @import MapKit;

    Swift

    import MapKit

    Доступность

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

  • scrollEnabled Свойство

    Булево значение, определяющее, может ли пользователь прокрутить вокруг карты.

    Объявление

    Swift

    var scrollEnabled: Bool

    Objective C

    @property(nonatomic, getter=isScrollEnabled) BOOL scrollEnabled

    Обсуждение

    Это свойство управляет только взаимодействием с пользователем с картой. Если Вы устанавливаете значение этого свойства к NOfalse, можно все еще изменить местоположение карты программно путем изменения значения в region свойство.

    Значение по умолчанию этого свойства YEStrue.

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

    Objective C

    @import MapKit;

    Swift

    import MapKit

    Доступность

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

  • pitchEnabled Свойство

    Булево значение, указывающее, используется ли информация о подаче камеры карты.

    Объявление

    Swift

    var pitchEnabled: Bool

    Objective C

    @property(nonatomic, getter=isPitchEnabled) BOOL pitchEnabled

    Обсуждение

    Когда это свойство установлено в YEStrue и допустимая камера связана с картой, угол подачи камеры используется для наклона плоскости карты. Когда это свойство установлено в NOfalse, угол подачи камеры проигнорирован, и карта всегда выводится на экран, как будто пользователь выглядит прямым вниз на него.

    В приложении всегда проверяйте значение этого свойства, чтобы определить, может ли карта поддерживать 3D.

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

    Objective C

    @import MapKit;

    Swift

    import MapKit

    Доступность

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

  • rotateEnabled Свойство

    Булево значение, указывающее, используется ли информация о заголовке камеры карты.

    Объявление

    Swift

    var rotateEnabled: Bool

    Objective C

    @property(nonatomic, getter=isRotateEnabled) BOOL rotateEnabled

    Обсуждение

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

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

    Objective C

    @import MapKit;

    Swift

    import MapKit

    Доступность

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

Доступ к делегату
  • delegate Свойство

    Делегат получателя.

    Объявление

    Swift

    weak var delegate: MKMapViewDelegate!

    Objective C

    @property(nonatomic, weak) id< MKMapViewDelegate > delegate

    Обсуждение

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

    Делегат должен реализовать методы MKMapViewDelegate протокол.

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

    Objective C

    @import MapKit;

    Swift

    import MapKit

    Доступность

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

Управление видимой частью карты
  • region Свойство

    Область в настоящее время выведена на экран представлением карты.

    Объявление

    Swift

    var region: MKCoordinateRegion

    Objective C

    @property(nonatomic) MKCoordinateRegion region

    Обсуждение

    Область охватывает и широту и точку долготы, на которой карта центрируется и промежуток координат для отображения. Значения промежутка обеспечивают неявное значение изменения масштаба для карты. Чем больше выведенная на экран область, тем ниже сумма изменения масштаба. Точно так же, чем меньший выведенная на экран область, тем больше сумма изменения масштаба.

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

    Изменение значения этого свойства сразу обновляет представление карты. При установке этого свойства карта может скорректировать новое значение области так, чтобы это соответствовало видимой области карты точно. Это нормально и сделано, чтобы гарантировать, что значение в этом свойстве всегда отражает видимую часть карты. Однако это действительно означает, что, если Вы получаете значение этого права собственности после установки его, возвращенное значение может не соответствовать значение, которое Вы устанавливаете. (Можно использовать regionThatFits: метод для определения области, которая будет фактически установлена картой.)

    Если Вы хотите анимировать изменение в области, используйте setRegion:animated: метод вместо этого.

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

    Objective C

    @import MapKit;

    Swift

    import MapKit

    Доступность

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

    См. также

    – setRegion:animated:
    centerCoordinate

  • setRegion (_: анимированный:) - setRegion:animated:

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

    Объявление

    Swift

    func setRegion(_ region: MKCoordinateRegion, animated animated: Bool)

    Objective C

    - (void)setRegion:(MKCoordinateRegion)region animated:(BOOL)animated

    Параметры

    region

    Новая область для отображения в представлении карты.

    animated

    Указать YEStrue если Вы хотите, чтобы представление карты анимировало переход к новой области или NOfalse если Вы хотите, чтобы карта сразу центрировалась на указанной области.

    Обсуждение

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

    При установке новой области карта может скорректировать значение в region параметр так, чтобы это соответствовало видимой области карты точно. Эта корректировка нормальна и сделана, чтобы гарантировать что значение в region свойство всегда отражает видимую часть карты. Однако это действительно означает, что, если Вы получаете значение того права собственности после вызова этого метода, возвращенное значение может не соответствовать значение, которое Вы устанавливаете. (Можно использовать regionThatFits: метод для определения области, которая будет фактически установлена картой.)

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

    Objective C

    @import MapKit;

    Swift

    import MapKit

    Доступность

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

    См. также

    область
    – setCenterCoordinate:animated:

  • centerCoordinate Свойство

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

    Объявление

    Swift

    var centerCoordinate: CLLocationCoordinate2D

    Objective C

    @property(nonatomic) CLLocationCoordinate2D centerCoordinate

    Обсуждение

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

    Изменение значения этого свойства сразу обновляет представление карты. Если Вы хотите анимировать изменение, используйте setCenterCoordinate:animated: метод вместо этого.

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

    Objective C

    @import MapKit;

    Swift

    import MapKit

    Доступность

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

    См. также

    – setCenterCoordinate:animated:
    область

  • setCenterCoordinate (_: анимированный:) - setCenterCoordinate:animated:

    Изменяет центральную координату карты и дополнительно анимирует изменение.

    Объявление

    Swift

    func setCenterCoordinate(_ coordinate: CLLocationCoordinate2D, animated animated: Bool)

    Objective C

    - (void)setCenterCoordinate:(CLLocationCoordinate2D)coordinate animated:(BOOL)animated

    Параметры

    coordinate

    Новая центральная координата для карты.

    animated

    Указать YEStrue если Вы хотите, чтобы представление карты прокрутило к новому расположению или NOfalse если Вы хотите, чтобы карта сразу вывела на экран новое расположение.

    Обсуждение

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

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

    Objective C

    @import MapKit;

    Swift

    import MapKit

    Доступность

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

    См. также

    centerCoordinate
    область

  • showAnnotations (_: анимированный:) - showAnnotations:animated:

    Устанавливает видимую область так, чтобы карта вывела на экран указанные аннотации.

    Объявление

    Swift

    func showAnnotations(_ annotations: [AnyObject]!, animated animated: Bool)

    Objective C

    - (void)showAnnotations:(NSArray *)annotations animated:(BOOL)animated

    Параметры

    annotations

    Аннотации, что Вы хотите быть видимыми в карте.

    animated

    YEStrue если Вы хотите, чтобы изменение области карты было анимировано, или NOfalse если Вы хотите, чтобы карта сразу вывела на экран новую область без анимаций.

    Обсуждение

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

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

    Objective C

    @import MapKit;

    Swift

    import MapKit

    Доступность

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

  • visibleMapRect Свойство

    Область в настоящее время выведена на экран представлением карты.

    Объявление

    Swift

    var visibleMapRect: MKMapRect

    Objective C

    @property(nonatomic) MKMapRect visibleMapRect

    Обсуждение

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

    Изменение значения этого свойства сразу обновляет представление карты. Если Вы хотите анимировать изменение, используйте setVisibleMapRect:animated: метод вместо этого.

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

    Objective C

    @import MapKit;

    Swift

    import MapKit

    Доступность

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

  • setVisibleMapRect (_: анимированный:) - setVisibleMapRect:animated:

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

    Объявление

    Swift

    func setVisibleMapRect(_ mapRect: MKMapRect, animated animate: Bool)

    Objective C

    - (void)setVisibleMapRect:(MKMapRect)mapRect animated:(BOOL)animate

    Параметры

    mapRect

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

    animate

    Указать YEStrue если Вы хотите, чтобы представление карты анимировало переход к новому прямоугольнику карты или NOfalse если Вы хотите, чтобы карта сразу центрировалась на указанном прямоугольнике.

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

    Objective C

    @import MapKit;

    Swift

    import MapKit

    Доступность

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

    См. также

    – setVisibleMapRect:edgePadding:animated:

  • setVisibleMapRect (_: edgePadding:animated:) - setVisibleMapRect:edgePadding:animated:

    Изменяет в настоящее время видимую часть карты, позволяя Вам указать дополнительное пространство вокруг краев.

    Объявление

    Swift

    func setVisibleMapRect(_ mapRect: MKMapRect, edgePadding insets: UIEdgeInsets, animated animate: Bool)

    Objective C

    - (void)setVisibleMapRect:(MKMapRect)mapRect edgePadding:(UIEdgeInsets)insets animated:(BOOL)animate

    Параметры

    mapRect

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

    insets

    Сумма дополнительного пространства (измеренный в экранных точках) для создания видимым вокруг указанного прямоугольника.

    animate

    Указать YEStrue если Вы хотите, чтобы представление карты анимировало переход к новому прямоугольнику карты или NOfalse если Вы хотите, чтобы карта сразу центрировалась на указанном прямоугольнике.

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

    Objective C

    @import MapKit;

    Swift

    import MapKit

    Доступность

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

    См. также

    – setVisibleMapRect:animated:

Конфигурирование появления карты
  • camera Свойство

    Камера, используемая для определения появления карты.

    Объявление

    Swift

    @NSCopying var camera: MKMapCamera!

    Objective C

    @property(nonatomic, copy) MKMapCamera *camera

    Обсуждение

    Объект камеры определяет точку выше поверхности карты, от которой можно просмотреть карту. Применение камеры к карте может иметь эффект предоставления карты подобное 3-му появление. Можно использовать камеру для вращения карты так, чтобы она была ориентирована, чтобы соответствовать заголовок пользователя или применить угол подачи для наклона плоскости карты. (Можно проверить карту pitchEnabled свойство, чтобы определить, может ли быть передана карта.)

    Присвоение новой камеры к этому свойству сразу обновляет карту и не анимируя изменение. Если Вы хотите анимировать изменения при закрытых дверях позиция, используйте setCamera:animated: метод вместо этого.

    Вы не должны устанавливать это свойство в nil. Для восстановления карты к плоскому появлению примените камеру с углом подачи 0, который приводит к камере, выглядящей прямым вниз на поверхность карты.

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

    Objective C

    @import MapKit;

    Swift

    import MapKit

    Доступность

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

    См. также

    – setCamera:animated:

  • setCamera (_: анимированный:) - setCamera:animated:

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

    Объявление

    Swift

    func setCamera(_ camera: MKMapCamera!, animated animated: Bool)

    Objective C

    - (void)setCamera:(MKMapCamera *)camera animated:(BOOL)animated

    Параметры

    camera

    Объект камеры, содержащий информацию об угле обзора. Этот параметр не должен быть nil.

    animated

    Указать YEStrue если Вы хотите, чтобы изменение в углу обзора было анимировано или NOfalse если Вы хотите, чтобы карта отразила изменения без анимаций.

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

    Objective C

    @import MapKit;

    Swift

    import MapKit

    Доступность

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

    См. также

    камера

  • showsPointsOfInterest Свойство

    Булевская переменная, указывающая, выводит ли карта на экран информацию об интересном месте.

    Объявление

    Swift

    var showsPointsOfInterest: Bool

    Objective C

    @property(nonatomic) BOOL showsPointsOfInterest

    Обсуждение

    Когда это свойство установлено в YEStrue, карта выводит на экран значки и метки для ресторанов, школ и других важных моментов интереса. Значение по умолчанию этого свойства YEStrue.

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

    Objective C

    @import MapKit;

    Swift

    import MapKit

    Доступность

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

  • showsBuildings Свойство

    Булевская переменная, указывающая, вытеснили ли дисплеи карты создание информации.

    Объявление

    Swift

    var showsBuildings: Bool

    Objective C

    @property(nonatomic) BOOL showsBuildings

    Обсуждение

    Когда это свойство установлено в YEStrue и камера имеет угол подачи, больше, чем нуль, карта вытесняет здания так, чтобы они расширились выше плоскости карты, создав 3D эффект. mapType свойство должно быть установлено в MKMapTypeStandard для вытесненных зданий, которые будут выведены на экран. Значение по умолчанию этого свойства YEStrue.

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

    Objective C

    @import MapKit;

    Swift

    import MapKit

    Доступность

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

Отображение расположения пользователя
  • showsUserLocation Свойство

    Булево значение, указывающее, должна ли карта попытаться вывести на экран расположение пользователя.

    Объявление

    Swift

    var showsUserLocation: Bool

    Objective C

    @property(nonatomic) BOOL showsUserLocation

    Обсуждение

    Это свойство не указывает, фактически видима ли позиция пользователя на карте, только должно ли представление карты попытаться вывести на экран его. Установка этого свойства к YEStrue заставляет представление карты использовать Базовую платформу Расположения для нахождения текущего расположения и попытки вывести на экран его на карте. Пока это свойство YEStrue, представление карты продолжает отслеживать расположение пользователя и обновлять его периодически. Значение по умолчанию этого свойства NOfalse.

    Показ расположения пользователя не гарантирует, что расположение видимо на карте. Пользователь, возможно, прокрутил карту к различной точке, заставив текущее расположение быть внеэкранным. Чтобы определить, выводится ли текущее расположение пользователя в настоящее время на экран на карте, используйте userLocationVisible свойство.

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

    Objective C

    @import MapKit;

    Swift

    import MapKit

    Доступность

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

    См. также

    userLocationVisible

  • userLocationVisible Свойство

    Булево значение, указывающее, видимо ли текущее расположение устройства в представлении карты. (только для чтения)

    Объявление

    Swift

    var userLocationVisible: Bool { get }

    Objective C

    @property(nonatomic, readonly, getter=isUserLocationVisible) BOOL userLocationVisible

    Обсуждение

    Это свойство говорит Вам, видим ли значок, используемый для представления текущего расположения пользователя, в представлении карты. При определении, видимо ли текущее расположение, это свойство факторы в горизонтальной точности данных расположения. В частности, если прямоугольник, представленный текущим расположением пользователя плюс или минус минус горизонтальная точность того расположения, пересекает видимый прямоугольник карты, это свойство содержит значение YEStrue. Если тот прямоугольник расположения не пересекает видимый прямоугольник карты, это свойство содержит значение NOfalse.

    Если расположение пользователя не может быть определено, это свойство содержит значение NOfalse.

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

    Objective C

    @import MapKit;

    Swift

    import MapKit

    Доступность

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

  • userLocation Свойство

    Объект пометок, представляющий текущее расположение пользователя. (только для чтения)

    Объявление

    Swift

    var userLocation: MKUserLocation! { get }

    Objective C

    @property(nonatomic, readonly) MKUserLocation *userLocation

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

    Objective C

    @import MapKit;

    Swift

    import MapKit

    Доступность

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

    См. также

    showsUserLocation

  • userTrackingMode Свойство

    Режим раньше отслеживал пользовательское расположение.

    Объявление

    Swift

    var userTrackingMode: MKUserTrackingMode

    Objective C

    @property(nonatomic) MKUserTrackingMode userTrackingMode

    Обсуждение

    Возможные значения описаны в MKUserTrackingMode.

    Установка режима отслеживания к MKUserTrackingModeFollow или MKUserTrackingModeFollowWithHeading заставляет представление карты центрировать карту на том расположении и начинать отслеживать расположение пользователя. Если карта уменьшена, представление карты автоматически увеличивает масштаб расположения пользователя, эффективно изменяя текущую видимую область.

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

    Objective C

    @import MapKit;

    Swift

    import MapKit

    Доступность

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

    См. также

    – setUserTrackingMode:animated:

  • setUserTrackingMode (_: анимированный:) - setUserTrackingMode:animated:

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

    Объявление

    Swift

    func setUserTrackingMode(_ mode: MKUserTrackingMode, animated animated: Bool)

    Objective C

    - (void)setUserTrackingMode:(MKUserTrackingMode)mode animated:(BOOL)animated

    Параметры

    mode

    Режим раньше отслеживал пользовательское расположение. Возможные значения описаны в MKUserTrackingMode.

    animated

    Если YEStrue, изменение от текущего режима до нового режима анимировано; иначе, это не. Этот параметр влияет только на изменения режима отслеживания. Изменения в пользовательском расположении или заголовке всегда анимируются.

    Обсуждение

    Установка режима отслеживания к MKUserTrackingModeFollow или MKUserTrackingModeFollowWithHeading заставляет представление карты центрировать карту на том расположении и начинать отслеживать расположение пользователя. Если карта уменьшена, представление карты автоматически увеличивает масштаб расположения пользователя, эффективно изменяя текущую видимую область.

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

    Objective C

    @import MapKit;

    Swift

    import MapKit

    Доступность

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

    См. также

    userTrackingMode
    mapView:didChangeUserTrackingMode:animated:
    mapView:didUpdateUserLocation:
    заголовок

Аннотирование карты
  • annotations Свойство

    Полный список аннотаций связался с получателем. (только для чтения)

    Объявление

    Swift

    var annotations: [AnyObject]! { get }

    Objective C

    @property(nonatomic, readonly) NSArray *annotations

    Обсуждение

    Объекты в этом массиве должны принять MKAnnotation протокол. Если никакие аннотации не связаны с представлением карты, значение этого свойства nil.

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

    Objective C

    @import MapKit;

    Swift

    import MapKit

    Доступность

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

    См. также

    – addAnnotation:
    – addAnnotations:
    – removeAnnotation:
    – removeAnnotations:

  • addAnnotation (_:) - addAnnotation:

    Добавляет указанная аннотация к представлению карты.

    Объявление

    Swift

    func addAnnotation(_ annotation: MKAnnotation!)

    Objective C

    - (void)addAnnotation:(id<MKAnnotation>)annotation

    Параметры

    annotation

    Объект пометок для добавления к получателю. Этот объект должен соответствовать MKAnnotation протокол. Представление карты сохраняет указанный объект.

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

    Objective C

    @import MapKit;

    Swift

    import MapKit

    Доступность

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

    См. также

    – addAnnotations:
    – removeAnnotation:

  • addAnnotations (_:) - addAnnotations:

    Добавляет массив объектов пометок к представлению карты.

    Объявление

    Swift

    func addAnnotations(_ annotations: [AnyObject]!)

    Objective C

    - (void)addAnnotations:(NSArray *)annotations

    Параметры

    annotations

    Массив объектов пометок. Каждый объект в массиве должен соответствовать MKAnnotation протокол. Представление карты сохраняет отдельные объекты пометок.

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

    Objective C

    @import MapKit;

    Swift

    import MapKit

    Доступность

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

    См. также

    – addAnnotation:
    – removeAnnotations:

  • removeAnnotation (_:) - removeAnnotation:

    Удаляет указанный объект пометок из представления карты.

    Объявление

    Swift

    func removeAnnotation(_ annotation: MKAnnotation!)

    Objective C

    - (void)removeAnnotation:(id<MKAnnotation>)annotation

    Параметры

    annotation

    Объект пометок для удаления. Этот объект должен соответствовать MKAnnotation протокол.

    Обсуждение

    Если аннотация в настоящее время связывается с представлением аннотации, и то представление имеет идентификатор повторного использования, этот метод удаляет представление аннотации и ставит его в очередь внутренне для более позднего повторного использования. Можно получить поставленные в очередь представления аннотации (и связать их с новыми аннотациями), использование dequeueReusableAnnotationViewWithIdentifier: метод.

    Удаление объекта пометок разъединяет его с представлением карты полностью, препятствуя тому, чтобы он был выведен на экран на карте. Таким образом Вы обычно вызывали бы этот метод только, когда Вы хотите скрыть или удалить данную аннотацию.

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

    Objective C

    @import MapKit;

    Swift

    import MapKit

    Доступность

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

    См. также

    – removeAnnotations:
    – addAnnotation:

  • removeAnnotations (_:) - removeAnnotations:

    Удаляет массив объектов пометок от представления карты.

    Объявление

    Swift

    func removeAnnotations(_ annotations: [AnyObject]!)

    Objective C

    - (void)removeAnnotations:(NSArray *)annotations

    Параметры

    annotations

    Массив аннотаций для удаления. Объекты в массиве должны соответствовать MKAnnotation протокол.

    Обсуждение

    Если какой-либо объект пометок в массиве имеет связанное представление аннотации, и если то представление имеет идентификатор повторного использования, этот метод удаляет представление аннотации и ставит его в очередь внутренне для более позднего повторного использования. Можно получить поставленные в очередь представления аннотации (и связать их с новыми аннотациями), использование dequeueReusableAnnotationViewWithIdentifier: метод.

    Удаление объектов пометок разъединяет их с представлением карты полностью, препятствуя тому, чтобы они были выведены на экран на карте. Таким образом Вы обычно вызывали бы этот метод только, когда Вы хотите скрыть или удалить указанные аннотации.

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

    Objective C

    @import MapKit;

    Swift

    import MapKit

    Доступность

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

    См. также

    – removeAnnotation:
    – addAnnotations:

  • viewForAnnotation (_:) - viewForAnnotation:

    Возвращает представление аннотации, связанное с указанным объектом пометок, если таковые имеются.

    Объявление

    Swift

    func viewForAnnotation(_ annotation: MKAnnotation!) -> MKAnnotationView!

    Objective C

    - (MKAnnotationView *)viewForAnnotation:(id<MKAnnotation>)annotation

    Параметры

    annotation

    Объект пометок, представление которого Вы хотите.

    Возвращаемое значение

    Представление аннотации или nil если еще не было создано представление. Этот метод может также возвратиться nil если аннотация не находится в видимой области карты и поэтому не имеет связанного представления аннотации.

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

    Objective C

    @import MapKit;

    Swift

    import MapKit

    Доступность

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

  • annotationsInMapRect (_:) - annotationsInMapRect:

    Возвращает объекты пометок, расположенные в указанном прямоугольнике карты.

    Объявление

    Swift

    func annotationsInMapRect(_ mapRect: MKMapRect) -> Set<NSObject>!

    Objective C

    - (NSSet *)annotationsInMapRect:(MKMapRect)mapRect

    Параметры

    mapRect

    Часть карты, что Вы хотите искать аннотации.

    Возвращаемое значение

    Набор объектов пометок расположился в mapRect.

    Обсуждение

    Этот метод предлагает быстрый способ получить объекты пометок в определенной части карты. Этот метод намного быстрее, чем выполнение в линейном поиске объектов annotations свойство самостоятельно.

    Специальные замечания

    До iOS 7 этот метод неправильно не возвращал экземпляры MKUserLocation.

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

    Objective C

    @import MapKit;

    Swift

    import MapKit

    Доступность

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

  • annotationVisibleRect Свойство

    Видимый прямоугольник, где представления аннотации в настоящее время выводятся на экран. (только для чтения)

    Объявление

    Swift

    var annotationVisibleRect: CGRect { get }

    Objective C

    @property(nonatomic, readonly) CGRect annotationVisibleRect

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

    Objective C

    @import MapKit;

    Swift

    import MapKit

    Доступность

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

  • dequeueReusableAnnotationViewWithIdentifier (_:) - dequeueReusableAnnotationViewWithIdentifier:

    Возвращает допускающее повторное использование представление аннотации, расположенное его идентификатором.

    Объявление

    Swift

    func dequeueReusableAnnotationViewWithIdentifier(_ identifier: String!) -> MKAnnotationView!

    Objective C

    - (MKAnnotationView *)dequeueReusableAnnotationViewWithIdentifier:(NSString *)identifier

    Параметры

    identifier

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

    Возвращаемое значение

    Представление аннотации с указанным идентификатором, или nil если никакой такой объект не существует в очереди повторного использования.

    Обсуждение

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

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

    Objective C

    @import MapKit;

    Swift

    import MapKit

    Доступность

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

Управление выборами аннотации
  • selectedAnnotations Свойство

    В настоящее время выбирающиеся аннотации.

    Объявление

    Swift

    var selectedAnnotations: [AnyObject]!

    Objective C

    @property(nonatomic, copy) NSArray *selectedAnnotations

    Обсуждение

    Присвоение нового массива к этому свойству выбирает только первую аннотацию в массиве.

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

    Objective C

    @import MapKit;

    Swift

    import MapKit

    Доступность

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

  • selectAnnotation (_: анимированный:) - selectAnnotation:animated:

    Выбирает указанную аннотацию и выводит на экран представление выноски для него.

    Объявление

    Swift

    func selectAnnotation(_ annotation: MKAnnotation!, animated animated: Bool)

    Objective C

    - (void)selectAnnotation:(id<MKAnnotation>)annotation animated:(BOOL)animated

    Параметры

    annotation

    Объект пометок для выбора.

    animated

    Если YEStrue, представление выноски анимировано в позицию.

    Обсуждение

    Если указанная аннотация не является экранной, и поэтому не имеет связанного представления аннотации, этот метод не имеет никакого эффекта.

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

    Objective C

    @import MapKit;

    Swift

    import MapKit

    Доступность

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

  • deselectAnnotation (_: анимированный:) - deselectAnnotation:animated:

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

    Объявление

    Swift

    func deselectAnnotation(_ annotation: MKAnnotation!, animated animated: Bool)

    Objective C

    - (void)deselectAnnotation:(id<MKAnnotation>)annotation animated:(BOOL)animated

    Параметры

    annotation

    Объект пометок для отмены выбора.

    animated

    Если YEStrue, представление выноски анимировано вне экрана.

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

    Objective C

    @import MapKit;

    Swift

    import MapKit

    Доступность

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

Доступ к оверлейным программам
  • overlays Свойство

    Объекты наложения в настоящее время связывались с представлением карты. (только для чтения)

    Объявление

    Swift

    var overlays: [AnyObject]! { get }

    Objective C

    @property(nonatomic, readonly) NSArray *overlays

    Обсуждение

    Это свойство содержит объединение всех оверлейных программ на разных уровнях карты. Объекты в этом массиве должны принять MKOverlay протокол. Если никакие оверлейные программы не связаны с представлением карты, значение этого свойства является пустым массивом.

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

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

    Objective C

    @import MapKit;

    Swift

    import MapKit

    Доступность

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

  • overlaysInLevel (_:) - overlaysInLevel:

    Объекты наложения на указанном уровне карты.

    Объявление

    Swift

    func overlaysInLevel(_ level: MKOverlayLevel) -> [AnyObject]!

    Objective C

    - (NSArray *)overlaysInLevel:(MKOverlayLevel)level

    Параметры

    level

    Уровень карты, оверлейные программы которого Вы хотите. Для списка возможных значений для этого параметра посмотрите MKOverlayLevel.

    Возвращаемое значение

    Массив объектов, соответствующих MKOverlay протокол, которые выводят на экран на указанном уровне карты. Если нет никаких оверлейных программ на указанном уровне, этот метод возвращает пустой массив.

    Обсуждение

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

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

    Objective C

    @import MapKit;

    Swift

    import MapKit

    Доступность

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

    См. также

    – addOverlay:level:
    – addOverlays:level:

  • rendererForOverlay (_:) - rendererForOverlay:

    Возвращается объект средства рендеринга раньше рисовал содержание указанного объекта наложения.

    Объявление

    Swift

    func rendererForOverlay(_ overlay: MKOverlay!) -> MKOverlayRenderer!

    Objective C

    - (MKOverlayRenderer *)rendererForOverlay:(id<MKOverlay>)overlay

    Параметры

    overlay

    Объект наложения, средство рендеринга которого Вы хотите.

    Возвращаемое значение

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

    Обсуждение

    Этот метод возвращает объект средства рендеринга, который Ваш делегат карты обеспечил в mapView:rendererForOverlay: метод.

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

    Objective C

    @import MapKit;

    Swift

    import MapKit

    Доступность

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

  • - viewForOverlay: (iOS 7.0)

    Возвращает представление, связанное с объектом наложения если таковые имеются.

    Оператор осуждения

    Используйте rendererForOverlay: метод вместо этого.

    Объявление

    Objective C

    - (MKOverlayView *)viewForOverlay:(id<MKOverlay>)overlay

    Параметры

    overlay

    Объект наложения, представление которого Вы хотите.

    Возвращаемое значение

    Представление связалось с объектом наложения или nil если наложение не является экранным.

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

    Objective C

    @import MapKit;

    Доступность

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

    Осуждаемый в iOS 7.0.

Добавление и вставка оверлейных программ
  • addOverlay (_: уровень:) - addOverlay:level:

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

    Объявление

    Swift

    func addOverlay(_ overlay: MKOverlay!, level level: MKOverlayLevel)

    Objective C

    - (void)addOverlay:(id<MKOverlay>)overlay level:(MKOverlayLevel)level

    Параметры

    overlay

    Объект наложения для добавления. Этот объект должен соответствовать MKOverlay протокол.

    level

    Уровень карты, на котором можно поместить наложение. Для списка возможных значений для этого параметра посмотрите MKOverlayLevel.

    Обсуждение

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

    Этот метод добавляет указанное наложение до конца списка объектов наложения на данном уровне. Добавление наложения также заставляет представление карты начинать контролировать область, которую они представляют. Как только ограничительный прямоугольник наложения пересекает видимую часть карты, представление карты вызывает Вашего делегата mapView:rendererForOverlay: метод для получения средства рендеринга возражает для использования при рисовании наложения.

    Для удаления наложения из карты используйте removeOverlay: метод.

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

    Objective C

    @import MapKit;

    Swift

    import MapKit

    Доступность

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

  • addOverlays (_: уровень:) - addOverlays:level:

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

    Объявление

    Swift

    func addOverlays(_ overlays: [AnyObject]!, level level: MKOverlayLevel)

    Objective C

    - (void)addOverlays:(NSArray *)overlays level:(MKOverlayLevel)level

    Параметры

    overlays

    Массив объектов наложения для добавления. Каждый объект в массиве должен соответствовать MKOverlay протокол.

    level

    Уровень карты, на котором можно поместить оверлейные программы. Для списка возможных значений для этого параметра посмотрите MKOverlayLevel.

    Обсуждение

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

    Этот метод добавляет указанные оверлейные программы до конца списка объектов наложения на данном уровне. Добавление оверлейных программ также заставляет представление карты начинать контролировать область, которую они представляют. Как только ограничительный прямоугольник наложения пересекает видимую часть карты, представление карты вызывает Вашего делегата mapView:rendererForOverlay: метод для получения средства рендеринга возражает для использования при рисовании того наложения.

    Для удаления многократных оверлейных программ из карты используйте removeOverlays: метод.

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

    Objective C

    @import MapKit;

    Swift

    import MapKit

    Доступность

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

  • addOverlay (_:) - addOverlay:

    Добавляет единственный объект наложения к карте.

    Объявление

    Swift

    func addOverlay(_ overlay: MKOverlay!)

    Objective C

    - (void)addOverlay:(id<MKOverlay>)overlay

    Параметры

    overlay

    Объект наложения для добавления. Этот объект должен соответствовать MKOverlay протокол.

    Обсуждение

    Указанный объект добавляется к группе объектов наложения в MKOverlayLevelAboveLabels уровень. Добавление наложения заставляет представление карты начинать контролировать область, представленную тем наложением. Как только ограничительный прямоугольник наложения пересекает видимую часть карты, представление карты добавляет соответствующее представление наложения к карте. Представление наложения предоставлено mapView:viewForOverlay: метод делегата представления карты объект.

    Для удаления наложения из карты используйте removeOverlay: метод.

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

    Objective C

    @import MapKit;

    Swift

    import MapKit

    Доступность

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

    См. также

    – addOverlays:
    – removeOverlay:
    – removeOverlays:

  • addOverlays (_:) - addOverlays:

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

    Объявление

    Swift

    func addOverlays(_ overlays: [AnyObject]!)

    Objective C

    - (void)addOverlays:(NSArray *)overlays

    Параметры

    overlays

    Массив объектов, каждый из которых должен соответствовать MKOverlay протокол.

    Обсуждение

    Указанные объекты добавляются к группе объектов наложения в MKOverlayLevelAboveLabels уровень. Добавление наложения заставляет представление карты начинать контролировать область, представленную тем наложением. Как только ограничительный прямоугольник наложения пересекает видимую часть карты, представление карты пытается нарисовать наложение. Как только ограничительный прямоугольник наложения пересекает видимую часть карты, представление карты добавляет соответствующее представление наложения к карте. Представление наложения предоставлено mapView:viewForOverlay: метод делегата представления карты объект.

    Для удаления многократных оверлейных программ из карты используйте removeOverlays: метод.

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

    Objective C

    @import MapKit;

    Swift

    import MapKit

    Доступность

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

    См. также

    – addOverlay:
    – removeOverlay:
    – removeOverlays:

  • insertOverlay (_: atIndex:level:) - insertOverlay:atIndex:level:

    Вставляет объект наложения на уровень в указанном индексе.

    Объявление

    Swift

    func insertOverlay(_ overlay: MKOverlay!, atIndex index: Int, level level: MKOverlayLevel)

    Objective C

    - (void)insertOverlay:(id<MKOverlay>)overlay atIndex:(NSUInteger)index level:(MKOverlayLevel)level

    Параметры

    overlay

    Объект наложения для вставки.

    index

    Индекс, в котором можно вставить объект наложения. Если это значение больше, чем число объектов в overlays свойство, этот метод добавляет объект до конца массива.

    level

    Уровень карты, на котором можно поместить наложение. Для списка возможных значений для этого параметра посмотрите MKOverlayLevel.

    Обсуждение

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

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

    Objective C

    @import MapKit;

    Swift

    import MapKit

    Доступность

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

  • insertOverlay (_: atIndex:) - insertOverlay:atIndex:

    Вставляет объект наложения в список, связанный с картой.

    Объявление

    Swift

    func insertOverlay(_ overlay: MKOverlay!, atIndex index: Int)

    Objective C

    - (void)insertOverlay:(id<MKOverlay>)overlay atIndex:(NSUInteger)index

    Параметры

    overlay

    Объект наложения для вставки.

    index

    Индекс, в котором можно вставить объект наложения. Если это значение больше, чем число объектов в overlays свойство, этот метод добавляет объект до конца массива.

    Обсуждение

    Этот метод вставляет наложение в MKOverlayLevelAboveLabels уровень.

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

    Objective C

    @import MapKit;

    Swift

    import MapKit

    Доступность

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

    См. также

    – insertOverlay:aboveOverlay:
    – insertOverlay:belowOverlay:

  • insertOverlay (_: aboveOverlay:) - insertOverlay:aboveOverlay:

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

    Объявление

    Swift

    func insertOverlay(_ overlay: MKOverlay!, aboveOverlay sibling: MKOverlay!)

    Objective C

    - (void)insertOverlay:(id<MKOverlay>)overlay aboveOverlay:(id<MKOverlay>)sibling

    Параметры

    overlay

    Объект наложения для вставки.

    sibling

    Существующий объект в overlays массив. Этот объект должен существовать в массиве и не должен быть nil.

    Обсуждение

    Этот метод вставляет наложение в MKOverlayLevelAboveLabels уровень и позиции это относительно указанного одноуровневого элемента. Когда выведено на экран, это приводит к содержанию наложения, выводимому на экран выше того из его одноуровневого элемента. Если одноуровневый элемент не находится на том же уровне карты, этот метод добавляет наложение до конца списка оверлейных программ на обозначенном уровне.

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

    Objective C

    @import MapKit;

    Swift

    import MapKit

    Доступность

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

    См. также

    – insertOverlay:atIndex:
    – insertOverlay:belowOverlay:

  • insertOverlay (_: belowOverlay:) - insertOverlay:belowOverlay:

    Вставляет один объект наложения ниже другого.

    Объявление

    Swift

    func insertOverlay(_ overlay: MKOverlay!, belowOverlay sibling: MKOverlay!)

    Objective C

    - (void)insertOverlay:(id<MKOverlay>)overlay belowOverlay:(id<MKOverlay>)sibling

    Параметры

    overlay

    Объект наложения для вставки.

    sibling

    Существующий объект в overlays массив. Этот объект должен существовать в массиве и не должен быть nil.

    Обсуждение

    Этот метод вставляет наложение в MKOverlayLevelAboveLabels уровень и позиции это относительно указанного одноуровневого элемента. Когда выведено на экран, это приводит к содержанию наложения, выводимому на экран ниже того из его одноуровневого элемента. Если одноуровневый элемент не находится на том же уровне карты, этот метод добавляет наложение до конца списка оверлейных программ на обозначенном уровне.

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

    Objective C

    @import MapKit;

    Swift

    import MapKit

    Доступность

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

    См. также

    – insertOverlay:atIndex:
    – insertOverlay:aboveOverlay:

  • exchangeOverlay (_: withOverlay:) - exchangeOverlay:withOverlay:

    Обменивается позициями этих двух объектов наложения.

    Объявление

    Swift

    func exchangeOverlay(_ overlay1: MKOverlay!, withOverlay overlay2: MKOverlay!)

    Objective C

    - (void)exchangeOverlay:(id<MKOverlay>)overlay1 withOverlay:(id<MKOverlay>)overlay2

    Параметры

    overlay1

    Первый объект наложения.

    overlay2

    Второй объект наложения.

    Обсуждение

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

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

    Objective C

    @import MapKit;

    Swift

    import MapKit

    Доступность

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

    См. также

    – exchangeOverlayAtIndex:withOverlayAtIndex:

  • exchangeOverlayAtIndex (_: withOverlayAtIndex:) - exchangeOverlayAtIndex:withOverlayAtIndex:

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

    Объявление

    Swift

    func exchangeOverlayAtIndex(_ index1: Int, withOverlayAtIndex index2: Int)

    Objective C

    - (void)exchangeOverlayAtIndex:(NSUInteger)index1 withOverlayAtIndex:(NSUInteger)index2

    Параметры

    index1

    Индекс наложения в MKOverlayLevelAboveLabels уровень карты.

    index2

    Индекс другого наложения в MKOverlayLevelAboveLabels уровень карты.

    Обсуждение

    Если необходимо обмениваться оверлейными программами на других уровнях карты, используйте exchangeOverlay:withOverlay: метод.

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

    Objective C

    @import MapKit;

    Swift

    import MapKit

    Доступность

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

    См. также

    – exchangeOverlay:withOverlay:

Удаление оверлейных программ
  • removeOverlay (_:) - removeOverlay:

    Удаляет единственный объект наложения из карты.

    Объявление

    Swift

    func removeOverlay(_ overlay: MKOverlay!)

    Objective C

    - (void)removeOverlay:(id<MKOverlay>)overlay

    Параметры

    overlay

    Объект наложения для удаления.

    Обсуждение

    Этот метод удаляет наложение независимо от уровня, в котором это находится. Удаление наложения также удаляет свое соответствующее средство рендеринга, если Вы используетесь. Если указанное наложение в настоящее время не связывается с представлением карты, этот метод ничего не делает.

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

    Objective C

    @import MapKit;

    Swift

    import MapKit

    Доступность

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

    См. также

    – addOverlay:
    – addOverlays:
    – removeOverlays:

  • removeOverlays (_:) - removeOverlays:

    Удаляет один или несколько объектов наложения из карты.

    Объявление

    Swift

    func removeOverlays(_ overlays: [AnyObject]!)

    Objective C

    - (void)removeOverlays:(NSArray *)overlays

    Параметры

    overlays

    Массив объектов, каждый из которых соответствует MKOverlay протокол.

    Обсуждение

    Этот метод удаляет указанные оверлейные программы, независимо от которых уровня каждый находится в. Удаление наложения также удаляет свое соответствующее средство рендеринга, если Вы используетесь. Если данный объект наложения не связан с представлением карты, он проигнорирован.

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

    Objective C

    @import MapKit;

    Swift

    import MapKit

    Доступность

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

    См. также

    – addOverlay:
    – addOverlays:
    – removeOverlay:

Преобразование координат карты
  • convertCoordinate (_: toPointToView:) - convertCoordinate:toPointToView:

    Преобразовывает координату карты в точку в указанном представлении.

    Объявление

    Swift

    func convertCoordinate(_ coordinate: CLLocationCoordinate2D, toPointToView view: UIView!) -> CGPoint

    Objective C

    - (CGPoint)convertCoordinate:(CLLocationCoordinate2D)coordinate toPointToView:(UIView *)view

    Параметры

    coordinate

    Координата карты, для которой Вы хотите найти соответствующую точку.

    view

    Представление, в системе координат которого Вы хотите определить местоположение указанной координаты карты. Если этот параметр nil, возвращенная точка указана в системе координат окна. Если view не nil, это должно принадлежать тому же окну как представление карты.

    Возвращаемое значение

    Точка (в надлежащем представлении или системе координаты окна) соответствие указанной широте и значению долготы.

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

    Objective C

    @import MapKit;

    Swift

    import MapKit

    Доступность

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

    См. также

    – convertPoint:toCoordinateFromView:

  • convertPoint (_: toCoordinateFromView:) - convertPoint:toCoordinateFromView:

    Преобразовывает точку в системе координат указанного представления к координате карты.

    Объявление

    Swift

    func convertPoint(_ point: CGPoint, toCoordinateFromView view: UIView!) -> CLLocationCoordinate2D

    Objective C

    - (CLLocationCoordinate2D)convertPoint:(CGPoint)point toCoordinateFromView:(UIView *)view

    Параметры

    point

    Точка Вы хотите преобразовать.

    view

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

    Возвращаемое значение

    Координата карты в указанной точке.

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

    Objective C

    @import MapKit;

    Swift

    import MapKit

    Доступность

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

    См. также

    – convertCoordinate:toPointToView:

  • convertRegion (_: toRectToView:) - convertRegion:toRectToView:

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

    Объявление

    Swift

    func convertRegion(_ region: MKCoordinateRegion, toRectToView view: UIView!) -> CGRect

    Objective C

    - (CGRect)convertRegion:(MKCoordinateRegion)region toRectToView:(UIView *)view

    Параметры

    region

    Область карты, для которой Вы хотите найти соответствующий прямоугольник представления.

    view

    Представление, в системе координат которого Вы хотите определить местоположение указанной области карты. Если этот параметр nil, возвращенный прямоугольник указан в системе координат окна. Если view не nil, это должно принадлежать тому же окну как представление карты.

    Возвращаемое значение

    Прямоугольник, соответствующий указанной области карты.

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

    Objective C

    @import MapKit;

    Swift

    import MapKit

    Доступность

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

    См. также

    – convertRect:toRegionFromView:

  • convertRect (_: toRegionFromView:) - convertRect:toRegionFromView:

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

    Объявление

    Swift

    func convertRect(_ rect: CGRect, toRegionFromView view: UIView!) -> MKCoordinateRegion

    Objective C

    - (MKCoordinateRegion)convertRect:(CGRect)rect toRegionFromView:(UIView *)view

    Параметры

    rect

    Прямоугольник Вы хотите преобразовать.

    view

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

    Возвращаемое значение

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

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

    Objective C

    @import MapKit;

    Swift

    import MapKit

    Доступность

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

    См. также

    – convertRegion:toRectToView:

Корректировка областей карты и прямоугольников
  • regionThatFits (_:) - regionThatFits:

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

    Объявление

    Swift

    func regionThatFits(_ region: MKCoordinateRegion) -> MKCoordinateRegion

    Objective C

    - (MKCoordinateRegion)regionThatFits:(MKCoordinateRegion)region

    Параметры

    region

    Начальная область, промежуток которой Вы хотите скорректировать.

    Возвращаемое значение

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

    Обсуждение

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

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

    Objective C

    @import MapKit;

    Swift

    import MapKit

    Доступность

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

  • mapRectThatFits (_:) - mapRectThatFits:

    Корректирует форматное соотношение указанного прямоугольника карты, чтобы гарантировать, что это помещается в кадр представления карты.

    Объявление

    Swift

    func mapRectThatFits(_ mapRect: MKMapRect) -> MKMapRect

    Objective C

    - (MKMapRect)mapRectThatFits:(MKMapRect)mapRect

    Параметры

    mapRect

    Начальный прямоугольник карты, ширину которого и высоту Вы хотите скорректировать.

    Возвращаемое значение

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

    Обсуждение

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

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

    Objective C

    @import MapKit;

    Swift

    import MapKit

    Доступность

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

    См. также

    – mapRectThatFits:edgePadding:

  • mapRectThatFits (_: edgePadding:) - mapRectThatFits:edgePadding:

    Корректирует форматное соотношение указанного прямоугольника карты, включая указанные значения вставки.

    Объявление

    Swift

    func mapRectThatFits(_ mapRect: MKMapRect, edgePadding insets: UIEdgeInsets) -> MKMapRect

    Objective C

    - (MKMapRect)mapRectThatFits:(MKMapRect)mapRect edgePadding:(UIEdgeInsets)insets

    Параметры

    mapRect

    Начальный прямоугольник карты, ширину которого и высоту Вы хотите скорректировать.

    insets

    Расстояние (измеренный в экранных точках), которым можно вставить возвращенный прямоугольник от фактических границ кадра представления карты.

    Возвращаемое значение

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

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

    Objective C

    @import MapKit;

    Swift

    import MapKit

    Доступность

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

    См. также

    – mapRectThatFits:

Константы
  • MKMapType

    Тип карты для отображения.

    Объявление

    Swift

    enum MKMapType : UInt { case Standard case Satellite case Hybrid }

    Objective C

    typedef enum : NSUInteger { MKMapTypeStandard, MKMapTypeSatellite, MKMapTypeHybrid } MKMapType;

    Константы

    • Standard

      MKMapTypeStandard

      Выводит на экран карту города, показывающую позицию всех дорог и некоторых дорожных имен.

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

    • Satellite

      MKMapTypeSatellite

      Формирование изображений спутника дисплеев области.

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

    • Hybrid

      MKMapTypeHybrid

      Выводит на экран спутниковое изображение области с дорожной и дорожной информацией об имени, разделенной на уровни на вершине.

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

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

    Objective C

    @import MapKit;

    Swift

    import MapKit

    Доступность

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

  • MKUserTrackingMode

    Режим раньше отслеживал пользовательское расположение на карте.

    Объявление

    Swift

    enum MKUserTrackingMode : Int { case None case Follow case FollowWithHeading }

    Objective C

    typedef enum : NSInteger { MKUserTrackingModeNone = 0, MKUserTrackingModeFollow, MKUserTrackingModeFollowWithHeading, } MKUserTrackingMode;

    Константы

    • None

      MKUserTrackingModeNone

      Карта не следует за пользовательским расположением.

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

    • Follow

      MKUserTrackingModeFollow

      Карта следует за пользовательским расположением.

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

    • FollowWithHeading

      MKUserTrackingModeFollowWithHeading

      Карта следует за пользовательским расположением и вращается когда возглавляющие изменения.

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

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

    Objective C

    @import MapKit;

    Swift

    import MapKit

    Доступность

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

  • MKOverlayLevel

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

    Объявление

    Swift

    enum MKOverlayLevel : Int { case AboveRoads case AboveLabels }

    Objective C

    typedef enum : NSInteger { MKOverlayLevelAboveRoads = 0, MKOverlayLevelAboveLabels } MKOverlayLevel;

    Константы

    • AboveRoads

      MKOverlayLevelAboveRoads

      Поместите наложение выше шоссе, но ниже меток карты, экранов или значков интересного места.

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

    • AboveLabels

      MKOverlayLevelAboveLabels

      Поместите наложение выше меток карты, экранов или значков интересного места, но ниже аннотаций и 3D проекций зданий.

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

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

    Objective C

    @import MapKit;

    Swift

    import MapKit

    Доступность

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