CLRegion

CLRegion класс определяет абстрактную область, которая может быть прослежена. В iOS Вы не создаете экземпляры этого класса непосредственно; вместо этого, Вы инстанцируете подклассов, определяющих определенные типы областей. В OS X Вы создаете экземпляры этого класса и используете их, чтобы хранить информацию области. После создания области необходимо зарегистрировать ее в a CLLocationManager объект. Менеджер расположения генерирует надлежащие события каждый раз, когда пользователь пересекает границы области.

Для использования этого класса создайте экземпляр его и используйте startMonitoringForRegion: метод a CLLocationManager объект начать контролировать его.

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

NSObject
CLRegion
CLCircularRegion

NSObject
CLRegion
CLCircularRegion

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

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

Swift

import CoreLocation

Objective C

@import CoreLocation;

Доступность

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

Инициализация области в OS X


    
    init (circularRegionWithCenter:radius:identifier:)
    - initCircularRegionWithCenter:radius:identifier:

(OS X v10.10)

Инициализирует и возвращает объект области определение круговой области.

Объявление

Swift

init!(circularRegionWithCenter center: CLLocationCoordinate2D, radius radius: CLLocationDistance, identifier identifier: String!)

Objective C

- (instancetype)initCircularRegionWithCenter:(CLLocationCoordinate2D)center radius:(CLLocationDistance)radius identifier:(NSString *)identifier

Параметры

`center`	Центральная точка области.
`radius`	Расстояние (измеренный в метрах) от центральной точки, отмечающей границу области.
`identifier`	Уникальный идентификатор для соединения с объектом области. Вы используете этот идентификатор для дифференциации областей в приложении. Это значение не должно быть `nil`.

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

Инициализированный объект области.

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

В iOS используйте a CLCircularRegion объект управлять географическими областями.

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

Objective C

@import CoreLocation;

Swift

import CoreLocation

Доступность

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

Осуждаемый в OS X v10.10.

Доступ к атрибутам области

идентификатор идентификатор Свойство

Идентификатор для объекта области. (только для чтения)

Объявление

Swift

var identifier: String! { get }

Objective C

@property(readonly, nonatomic, copy) NSString *identifier

Обсуждение

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

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

Objective C

@import CoreLocation;

Swift

import CoreLocation

Доступность

Доступный в OS X v10.7 и позже.
центр центр (OS X v10.10) Свойство

Центральная точка области. (только для чтения)

Объявление

Swift

var center: CLLocationCoordinate2D { get }

Objective C

@property(readonly, nonatomic) CLLocationCoordinate2D center

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

В iOS используйте a CLCircularRegion объект управлять географическими областями.

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

Objective C

@import CoreLocation;

Swift

import CoreLocation

Доступность

Доступный в OS X v10.7 и позже.
Осуждаемый в OS X v10.10.
радиус радиус (OS X v10.10) Свойство

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

Объявление

Swift

var radius: CLLocationDistance { get }

Objective C

@property(readonly, nonatomic) CLLocationDistance radius

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

В iOS используйте a CLCircularRegion объект управлять географическими областями.

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

Objective C

@import CoreLocation;

Swift

import CoreLocation

Доступность

Доступный в OS X v10.7 и позже.
Осуждаемый в OS X v10.10.

Конфигурирование поставки уведомления

notifyOnEntry notifyOnEntry Свойство

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

Объявление

Swift

var notifyOnEntry: Bool

Objective C

@property(nonatomic, assign) BOOL notifyOnEntry

Обсуждение

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

Если приложение не работает, когда граничное пересечение происходит, система запускает приложение в фон для обработки его. На запуск Ваше приложение должно сконфигурировать нового менеджера расположения, и делегат возражает для получения уведомления. Уведомление отправляется Вашему делегату locationManager:didEnterRegion: метод.

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

Objective C

@import CoreLocation;

Swift

import CoreLocation

Доступность

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

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

Объявление

Swift

var notifyOnExit: Bool

Objective C

@property(nonatomic, assign) BOOL notifyOnExit

Обсуждение

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

Если приложение не работает, когда граничное пересечение происходит, система запускает приложение в фон для обработки его. На запуск Ваше приложение должно сконфигурировать нового менеджера расположения, и делегат возражает для получения уведомления. Уведомление отправляется Вашему делегату locationManager:didExitRegion: метод.

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

Objective C

@import CoreLocation;

Swift

import CoreLocation

Доступность

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

Тестирование хита в области

containsCoordinate (_:) - containsCoordinate: (OS X v10.10)

Возвращает булево значение, указывающее, содержит ли область указанную координату.

Объявление

Swift

func containsCoordinate(_ coordinate: CLLocationCoordinate2D) -> Bool

Objective C

- (BOOL)containsCoordinate:(CLLocationCoordinate2D)coordinate

Параметры

coordinate

Координата для тестирования против области.

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

YEStrue если координата находится в границах области или NOfalse если это не делает.

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

В iOS используйте a CLCircularRegion объект управлять географическими областями.

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

Objective C

@import CoreLocation;

Swift

import CoreLocation

Доступность

Доступный в OS X v10.7 и позже.
Осуждаемый в OS X v10.10.

Константы

CLRegionState
Константы, отражающие отношение текущего расположения к границам области.

Объявление

Swift

enum CLRegionState : Int { case Unknown case Inside case Outside }

Objective C

typedef { CLRegionStateUnknown, CLRegionStateInside, CLRegionStateOutside } CLRegionState;

Константы
- Unknown
  
  CLRegionStateUnknown
  
  Это неизвестно, является ли расположение внутри или снаружи области.
  
  Доступный в OS X v10.10 и позже.
- Inside
  
  CLRegionStateInside
  
  Расположение в данной области.
  
  Доступный в OS X v10.10 и позже.
- Outside
  
  CLRegionStateOutside
  
  Расположение за пределами данной области.
  
  Доступный в OS X v10.10 и позже.
Оператор импорта

Objective C

@import CoreLocation;

Swift

import CoreLocation

Доступность

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

CLRegion

Инициализация области в OS X

Объявление

Параметры

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

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

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

Доступность

Доступ к атрибутам области

Объявление

Обсуждение

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

Доступность

Объявление

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

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

Доступность

Объявление

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

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

Доступность

Конфигурирование поставки уведомления

Объявление

Обсуждение

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

Доступность

Объявление

Обсуждение

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

Доступность

Тестирование хита в области

Объявление

Параметры

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

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

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

Доступность

Константы

Объявление

Константы

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

Доступность