CLLocation

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

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

Этот класс разработан, чтобы быть использованным как есть и не должен быть разделен на подклассы.

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

NSObject
CLLocation

NSObject
CLLocation

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

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

Swift

import CoreLocation

Objective C

@import CoreLocation;

Доступность

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

Инициализация объекта расположения


    
    init (latitude:longitude:)
    - initWithLatitude:longitude:

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

Объявление

Swift

init!(latitude latitude: CLLocationDegrees, longitude longitude: CLLocationDegrees)

Objective C

- (instancetype)initWithLatitude:(CLLocationDegrees)latitude longitude:(CLLocationDegrees)longitude

Параметры

`latitude`	Широта координатной точки.
`longitude`	Долгота координатной точки.

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

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

Обсуждение

Как правило, Вы получаете объекты расположения от службы определения местоположения, но можно использовать этот метод для создания новых объектов расположения для другого использования в приложении. При использовании этого метода другие свойства объекта инициализируются к надлежащим значениям. В частности altitude и horizontalAccuracy свойства установлены в 0, verticalAccuracy свойство установлено в-1 указать, что высотное значение недопустимо, и timestamp свойство установлено во время, в которое был инициализирован экземпляр.

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

Objective C

@import CoreLocation;

Swift

import CoreLocation

Доступность

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


    
    init (coordinate:altitude:horizontalAccuracy:verticalAccuracy:timestamp:)
    - initWithCoordinate:altitude:horizontalAccuracy:verticalAccuracy:timestamp:

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

Объявление

Swift

init!(coordinate coordinate: CLLocationCoordinate2D, altitude altitude: CLLocationDistance, horizontalAccuracy hAccuracy: CLLocationAccuracy, verticalAccuracy vAccuracy: CLLocationAccuracy, timestamp timestamp: NSDate!)

Objective C

- (instancetype)initWithCoordinate:(CLLocationCoordinate2D)coordinate altitude:(CLLocationDistance)altitude horizontalAccuracy:(CLLocationAccuracy)hAccuracy verticalAccuracy:(CLLocationAccuracy)vAccuracy timestamp:(NSDate *)timestamp

Параметры

`coordinate`	Координатная структура, содержащая широту и значения долготы.
`altitude`	Высотное значение для расположения.
`hAccuracy`	Точность координатного значения. Указание отрицательного числа указывает, что координатное значение недопустимо.
`vAccuracy`	Точность высотного значения. Указание отрицательного числа указывает, что высотное значение недопустимо.
`timestamp`	Время для соединения с объектом расположения. Как правило, Вы установили бы это в текущее время.

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

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

Обсуждение

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

Objective C

@import CoreLocation;

Swift

import CoreLocation

Доступность

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


    
    init (coordinate:altitude:horizontalAccuracy:verticalAccuracy:course:speed:timestamp:)
    - initWithCoordinate:altitude:horizontalAccuracy:verticalAccuracy:course:speed:timestamp:

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

Объявление

Swift

Objective C

Параметры

`coordinate`	Координатная структура, содержащая широту и значения долготы.
`altitude`	Высотное значение для расположения.
`hAccuracy`	Точность координатного значения. Указание отрицательного числа указывает, что координатное значение недопустимо.
`vAccuracy`	Точность высотного значения. Указание отрицательного числа указывает, что высотное значение недопустимо.
`course`	Направление перемещения на расположение.
`speed`	Текущая скорость связалась с этим расположением.
`timestamp`	Время для соединения с объектом расположения. Как правило, Вы установили бы это в текущее время.

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

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

Обсуждение

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

Objective C

@import CoreLocation;

Swift

import CoreLocation

Доступность

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

Атрибуты расположения

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

Информация о географической координате. (только для чтения)

Объявление

Swift

var coordinate: CLLocationCoordinate2D { get }

Objective C

@property(readonly, nonatomic) CLLocationCoordinate2D coordinate

Обсуждение

При выполнении в средстве моделирования Базовое Расположение использует значения, предоставленные для него средством моделирования. Необходимо запустить приложение на основанном на iOS устройстве для получения фактического расположения того устройства.

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

В iOS это свойство объявляется как nonatomic. В OS X это объявляется как atomic.

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

Objective C

@import CoreLocation;

Swift

import CoreLocation

Доступность

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

Высота измерилась в метрах. (только для чтения)

Объявление

Swift

var altitude: CLLocationDistance { get }

Objective C

@property(readonly, nonatomic) CLLocationDistance altitude

Обсуждение

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

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

В iOS это свойство объявляется как nonatomic. В OS X это объявляется как atomic.

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

Objective C

@import CoreLocation;

Swift

import CoreLocation

Доступность

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

См. также

verticalAccuracy
horizontalAccuracy horizontalAccuracy Свойство

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

Объявление

Swift

var horizontalAccuracy: CLLocationAccuracy { get }

Objective C

@property(readonly, nonatomic) CLLocationAccuracy horizontalAccuracy

Обсуждение

Широта и долгота расположения идентифицируют центр круга, и это значение указывает радиус того круга. Отрицательная величина указывает, что широта и долгота расположения недопустимы.

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

В iOS это свойство объявляется как nonatomic. В OS X это объявляется как atomic.

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

Objective C

@import CoreLocation;

Swift

import CoreLocation

Доступность

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

Точность высоты оценивает в метрах. (только для чтения)

Объявление

Swift

var verticalAccuracy: CLLocationAccuracy { get }

Objective C

@property(readonly, nonatomic) CLLocationAccuracy verticalAccuracy

Обсуждение

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

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

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

В iOS это свойство объявляется как nonatomic. В OS X это объявляется как atomic.

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

Objective C

@import CoreLocation;

Swift

import CoreLocation

Доступность

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

См. также

высота
метка времени метка времени Свойство

Время, в которое было определено это расположение. (только для чтения)

Объявление

Swift

@NSCopying var timestamp: NSDate! { get }

Objective C

@property(readonly, nonatomic, copy) NSDate *timestamp

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

В iOS это свойство объявляется как nonatomic. В OS X это объявляется как atomic.

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

Objective C

@import CoreLocation;

Swift

import CoreLocation

Доступность

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

Данные расположения в строке форматированного текста. (только для чтения)

Объявление

Swift

var description: String! { get }

Objective C

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

Обсуждение

Строка формы “<<широта>, <долгота>> +/-<точность> m (скорость <скорость> kph / возглавляющий <возглавляющий>) <разовый датой>”, где <широта>, <долгота>, <точность>, <скорость> и <заголовок> отформатированные числа с плавающей точкой и <разовый датой>, является строкой отформатированной даты, включающей дату, время и информация о часовом поясе.

Возвращаемая строка предназначается в целях дисплея только.

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

Objective C

@import CoreLocation;

Swift

import CoreLocation

Доступность

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

Измерение расстояния между координатами

distanceFromLocation (_:) - distanceFromLocation:

Возвращает расстояние (в метрах) от расположения получателя до указанного расположения.

Объявление

Swift

func distanceFromLocation(_ location: CLLocation!) -> CLLocationDistance

Objective C

- (CLLocationDistance)distanceFromLocation:(const CLLocation *)location

Параметры

location

Другое расположение.

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

Расстояние (в метрах) между этими двумя расположениями.

Обсуждение

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

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

Objective C

@import CoreLocation;

Swift

import CoreLocation

Доступность

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

Получение информации о скорости и курсе

скорость скорость Свойство

Мгновенная скорость устройства в метрах в секунду.

Объявление

Swift

var speed: CLLocationSpeed { get }

Objective C

@property(readonly, nonatomic) CLLocationSpeed speed

Обсуждение

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

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

В iOS это свойство объявляется как nonatomic. В OS X это объявляется как atomic.

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

Objective C

@import CoreLocation;

Swift

import CoreLocation

Доступность

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

Направление, в котором перемещается устройство.

Объявление

Swift

var course: CLLocationDirection { get }

Objective C

@property(readonly, nonatomic) CLLocationDirection course

Обсуждение

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

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

В iOS это свойство объявляется как nonatomic. В OS X это объявляется как atomic.

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

Objective C

@import CoreLocation;

Swift

import CoreLocation

Доступность

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

CLLocation

Инициализация объекта расположения

Объявление

Параметры

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

Обсуждение

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

Доступность

Объявление

Параметры

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

Обсуждение

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

Доступность

Объявление

Параметры

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

Обсуждение

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

Доступность

Атрибуты расположения

Объявление

Обсуждение

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

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

Доступность

Объявление

Обсуждение

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

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

Доступность

См. также

Объявление

Обсуждение

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

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

Доступность

Объявление

Обсуждение

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

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

Доступность

См. также

Объявление

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

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

Доступность

Объявление

Обсуждение

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

Доступность

Измерение расстояния между координатами

Объявление

Параметры

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

Обсуждение

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

Доступность

Получение информации о скорости и курсе

Объявление

Обсуждение

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

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

Доступность

Объявление

Обсуждение

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

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

Доступность