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

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

Разработчик

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

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

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

CLLocationManagerDelegate

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

После получения успешного расположения или заголовка обновления, можно использовать результат обновить пользовательский интерфейс или выполнить другие действия. Если расположение или заголовок не могли бы быть определены, Вы могли бы хотеть остановить обновления в течение короткого периода времени и попробовать еще раз позже. Можно использовать stopUpdatingLocation, stopMonitoringSignificantLocationChanges, stopUpdatingHeading, stopMonitoringForRegion:, или stopMonitoringVisits методы CLLocationManager остановить различные службы определения местоположения.

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

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


Не применимый

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


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


Swift

import CoreLocation

Objective C

@import CoreLocation;

Доступность


Доступный в OS X v10.6 и позже.
  • Говорит делегату, что новые данные расположения доступны.

    Объявление

    Swift

    optional func locationManager(_ manager: CLLocationManager!, didUpdateLocations locations: [AnyObject]!)

    Objective C

    - (void)locationManager:(CLLocationManager *)manager didUpdateLocations:(NSArray *)locations

    Параметры

    manager

    Менеджер расположения возражает, что генерировал событие обновления.

    locations

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

    Обсуждение

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

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

    Objective C

    @import CoreLocation;

    Swift

    import CoreLocation

    Доступность

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

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

    Объявление

    Swift

    optional func locationManager(_ manager: CLLocationManager!, didFailWithError error: NSError!)

    Objective C

    - (void)locationManager:(CLLocationManager *)manager didFailWithError:(NSError *)error

    Параметры

    manager

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

    error

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

    Обсуждение

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

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

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

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

    Objective C

    @import CoreLocation;

    Swift

    import CoreLocation

    Доступность

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

  • Говорит делегату, что больше не будут задерживаться обновления.

    Объявление

    Swift

    optional func locationManager(_ manager: CLLocationManager!, didFinishDeferredUpdatesWithError error: NSError!)

    Objective C

    - (void)locationManager:(CLLocationManager *)manager didFinishDeferredUpdatesWithError:(NSError *)error

    Параметры

    manager

    Менеджер расположения возражает, что генерировал событие обновления.

    error

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

    Обсуждение

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

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

    Objective C

    @import CoreLocation;

    Swift

    import CoreLocation

    Доступность

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

  • Говорит делегату, что новое значение расположения доступно.

    Использовать locationManager:didUpdateLocations: вместо этого.

    Объявление

    Swift

    optional func locationManager(_ manager: CLLocationManager!, didUpdateToLocation newLocation: CLLocation!, fromLocation oldLocation: CLLocation!)

    Objective C

    - (void)locationManager:(CLLocationManager *)manager didUpdateToLocation:(CLLocation *)newLocation fromLocation:(CLLocation *)oldLocation

    Параметры

    manager

    Менеджер расположения возражает, что генерировал событие обновления.

    newLocation

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

    oldLocation

    Данные расположения от предыдущего обновления. Если это - первое событие обновления, поставленное этим менеджером расположения, этот параметр nil.

    Обсуждение

    К тому времени, когда это сообщение передается Вашему делегату, новые данные расположения также доступны непосредственно от CLLocationManager объект. newLocation параметр может содержать данные, кэшировавшиеся от предыдущего использования службы определения местоположения. Можно использовать timestamp свойство расположения возражает, чтобы определить, насколько недавний данные расположения.

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

    Objective C

    @import CoreLocation;

    Swift

    import CoreLocation

    Доступность

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

  • Говорит делегату, что пользователь ввел указанную область.

    Объявление

    Swift

    optional func locationManager(_ manager: CLLocationManager!, didEnterRegion region: CLRegion!)

    Objective C

    - (void)locationManager:(CLLocationManager *)manager didEnterRegion:(CLRegion *)region

    Параметры

    manager

    Менеджер расположения объектное создание отчетов о событии.

    region

    Объект, содержащий информацию о вводившейся области.

    Обсуждение

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

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

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

    Objective C

    @import CoreLocation;

    Swift

    import CoreLocation

    Доступность

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

  • Говорит делегату, что пользователь оставил указанную область.

    Объявление

    Swift

    optional func locationManager(_ manager: CLLocationManager!, didExitRegion region: CLRegion!)

    Objective C

    - (void)locationManager:(CLLocationManager *)manager didExitRegion:(CLRegion *)region

    Параметры

    manager

    Менеджер расположения объектное создание отчетов о событии.

    region

    Объект, содержащий информацию об области, из которой вышли.

    Обсуждение

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

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

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

    Objective C

    @import CoreLocation;

    Swift

    import CoreLocation

    Доступность

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

  • Говорит делегату о состоянии указанной области. (требуемый)

    Объявление

    Swift

    optional func locationManager(_ manager: CLLocationManager!, didDetermineState state: CLRegionState, forRegion region: CLRegion!)

    Objective C

    - (void)locationManager:(CLLocationManager *)manager didDetermineState:(CLRegionState)state forRegion:(CLRegion *)region

    Параметры

    manager

    Менеджер расположения объектное создание отчетов о событии.

    state

    Состояние указанной области. Для списка возможных значений посмотрите CLRegionState ввести.

    region

    Область, состояние которой было определено.

    Обсуждение

    Вызовы диспетчера расположения этот метод каждый раз, когда существует граничный переход для области. Это вызывает этот метод в дополнение к вызову locationManager:didEnterRegion: и locationManager:didExitRegion: методы. Менеджер расположения также вызывает этот метод в ответ на вызов к requestStateForRegion: метод, работающий асинхронно.

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

    Objective C

    @import CoreLocation;

    Swift

    import CoreLocation

    Доступность

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

  • Говорит делегату, что произошла контрольная ошибка области.

    Объявление

    Swift

    optional func locationManager(_ manager: CLLocationManager!, monitoringDidFailForRegion region: CLRegion!, withError error: NSError!)

    Objective C

    - (void)locationManager:(CLLocationManager *)manager monitoringDidFailForRegion:(CLRegion *)region withError:(NSError *)error

    Параметры

    manager

    Менеджер расположения объектное создание отчетов о событии.

    region

    Область, для которой произошла ошибка.

    error

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

    Обсуждение

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

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

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

    Objective C

    @import CoreLocation;

    Swift

    import CoreLocation

    Доступность

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

  • Говорит делегату, что контролируется новая область.

    Объявление

    Swift

    optional func locationManager(_ manager: CLLocationManager!, didStartMonitoringForRegion region: CLRegion!)

    Objective C

    - (void)locationManager:(CLLocationManager *)manager didStartMonitoringForRegion:(CLRegion *)region

    Параметры

    manager

    Менеджер расположения объектное создание отчетов о событии.

    region

    Контролирующаяся область.

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

    Objective C

    @import CoreLocation;

    Swift

    import CoreLocation

    Доступность

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

  • Говорит делегату что состояние авторизации для измененного приложения.

    Объявление

    Swift

    optional func locationManager(_ manager: CLLocationManager!, didChangeAuthorizationStatus status: CLAuthorizationStatus)

    Objective C

    - (void)locationManager:(CLLocationManager *)manager didChangeAuthorizationStatus:(CLAuthorizationStatus)status

    Параметры

    manager

    Менеджер расположения объектное создание отчетов о событии.

    status

    Новое состояние авторизации для приложения.

    Обсуждение

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

    Когда Вы вызываете, если уже известно состояние авторизации requestWhenInUseAuthorization или requestAlwaysAuthorization метод, менеджер расположения не сообщает о текущем состоянии авторизации этому методу. Менеджер расположения только сообщает об изменениях в состоянии авторизации. Например, когда состояние изменяется от, это вызывает этот метод kCLAuthorizationStatusNotDetermined к kCLAuthorizationStatusAuthorizedWhenInUse.

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

    Objective C

    @import CoreLocation;

    Swift

    import CoreLocation

    Доступность

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