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

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

Разработчик

Ссылка платформы CoreLocation ссылка класса CLRegion

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

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

CLRegion

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

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

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

Swift

import CoreLocation

Objective C

@import CoreLocation;

Доступность

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

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

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

Инициализация области в OS X
  • - initCircularRegionWithCenter:radius:identifier: (iOS 7.0)

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

    Объявление

    Objective C

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

    Параметры

    center

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

    radius

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

    identifier

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

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

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

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

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

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

    Objective C

    @import CoreLocation;

    Доступность

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

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

Доступ к атрибутам области
  • identifier Свойство

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

    Объявление

    Swift

    var identifier: String! { get }

    Objective C

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

    Обсуждение

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

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

    Objective C

    @import CoreLocation;

    Swift

    import CoreLocation

    Доступность

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

  • center (iOS 7.0) Свойство

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

    Объявление

    Objective C

    @property(readonly, nonatomic) CLLocationCoordinate2D center

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

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

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

    Objective C

    @import CoreLocation;

    Доступность

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

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

  • radius (iOS 7.0) Свойство

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

    Объявление

    Objective C

    @property(readonly, nonatomic) CLLocationDistance radius

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

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

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

    Objective C

    @import CoreLocation;

    Доступность

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

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

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

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

    Объявление

    Swift

    var notifyOnEntry: Bool

    Objective C

    @property(nonatomic, assign) BOOL notifyOnEntry

    Обсуждение

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

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

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

    Objective C

    @import CoreLocation;

    Swift

    import CoreLocation

    Доступность

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

  • notifyOnExit Свойство

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

    Объявление

    Swift

    var notifyOnExit: Bool

    Objective C

    @property(nonatomic, assign) BOOL notifyOnExit

    Обсуждение

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

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

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

    Objective C

    @import CoreLocation;

    Swift

    import CoreLocation

    Доступность

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

Тестирование хита в области
  • - containsCoordinate: (iOS 7.0)

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

    Объявление

    Objective C

    - (BOOL)containsCoordinate:(CLLocationCoordinate2D)coordinate

    Параметры

    coordinate

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

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

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

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

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

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

    Objective C

    @import CoreLocation;

    Доступность

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

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

Константы
  • CLRegionState

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

    Объявление

    Swift

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

    Objective C

    typedef { CLRegionStateUnknown, CLRegionStateInside, CLRegionStateOutside } CLRegionState;

    Константы

    • Unknown

      CLRegionStateUnknown

      Это неизвестно, является ли расположение внутри или снаружи области.

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

    • Inside

      CLRegionStateInside

      Расположение в данной области.

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

    • Outside

      CLRegionStateOutside

      Расположение за пределами данной области.

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

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

    Objective C

    @import CoreLocation;

    Swift

    import CoreLocation

    Доступность

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