MKMapSnapshotter

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

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

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

NSObject
MKMapSnapshotter

NSObject
MKMapSnapshotter

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

AnyObject
CVarArgType
Equatable
Hashable
NSObjectProtocol
Печатаемый
NSObject

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

Swift

import MapKit

Objective C

@import MapKit;

Доступность

Доступный в OS X v10.9 и позже.

Инициализация объекта Snapshotter


    
    init (опции:)
    - initWithOptions:

Определяемый инициализатор

Инициализирует и возвращает snapshotter основанное на объектах на указанных опциях.

Объявление

Swift

init!(options options: MKMapSnapshotOptions!)

Objective C

- (instancetype)initWithOptions:(MKMapSnapshotOptions *)options

Параметры


      options

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

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

Инициализированная snapshotter опция.

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

Objective C

@import MapKit;

Swift

import MapKit

Доступность

Доступный в OS X v10.9 и позже.

Генерация снимка


    
    startWithCompletionHandler (_:)
    - startWithCompletionHandler:

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

Объявление

Swift

func startWithCompletionHandler(_ completionHandler: MKMapSnapshotCompletionHandler!)

Objective C

- (void)startWithCompletionHandler:(MKMapSnapshotCompletionHandler)completionHandler

Параметры


      completionHandler

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

Обсуждение

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

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

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

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

Objective C

@import MapKit;

Swift

import MapKit

Доступность

Доступный в OS X v10.9 и позже.


    
    startWithQueue (_: completionHandler:)
    - startWithQueue:completionHandler:

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

Объявление

Swift

func startWithQueue(_ queue: dispatch_queue_t!, completionHandler completionHandler: MKMapSnapshotCompletionHandler!)

Objective C

- (void)startWithQueue:(dispatch_queue_t)queue completionHandler:(MKMapSnapshotCompletionHandler)completionHandler

Параметры

`queue`	Очередь отгрузки, на которой можно выполнить блок, указанный `completionHandler` параметр.
`completionHandler`	Блок для вызова с получающимся снимком. Этот блок не должен быть `nil`.

Обсуждение

Вызовите этот метод, чтобы начать генерировать изображение снимка на основе указанных параметров. Этот метод выполняет запрос асинхронно. Когда рендеринг завершен, snapshotter поставляет результаты к Вашему блоку на очереди отгрузки в queue параметр.

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

Objective C

@import MapKit;

Swift

import MapKit

Доступность

Доступный в OS X v10.9 и позже.

отмена () - отмена

Отменяет текущий запрос для создания снимка.

Объявление

Swift

func cancel()

Objective C

- (void)cancel

Обсуждение

Если snapshotter не находится в процессе генерации снимка, вызывание этого метода ничего не делает.

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

Objective C

@import MapKit;

Swift

import MapKit

Доступность

Доступный в OS X v10.9 и позже.
загрузка загрузка Свойство

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

Объявление

Swift

var loading: Bool { get }

Objective C

@property(nonatomic, readonly, getter=isLoading) BOOL loading

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

Objective C

@import MapKit;

Swift

import MapKit

Доступность

Доступный в OS X v10.9 и позже.

Типы данных


      
      MKMapSnapshotCompletionHandler
      MKMapSnapshotCompletionHandler

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

Объявление

Swift

typealias MKMapSnapshotCompletionHandler = (MKMapSnapshot!, NSError!) -> Void

Objective C

typedef void (^MKMapSnapshotCompletionHandler)(MKMapSnapshot *snapshot, NSError *error);

Обсуждение

Этот блок берет следующие параметры:

`snapshot`	Данные изображения, сгенерированные или `nil` если произошла ошибка
`error`	Ошибка, произошедшая или `nil` если снимок был сгенерирован успешно.

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

Objective C

@import MapKit;

Swift

import MapKit

Доступность

Доступный в OS X v10.9 и позже.