CLLocation
Соответствует
-
AnyObject
-
CKRecordValue
-
CVarArgType
-
Сопоставимый
-
Hashable
-
NSCoding
-
NSCopying
-
NSObjectProtocol
-
NSSecureCoding
-
Печатаемый
-
NSCopying
-
NSObject
-
NSSecureCoding
Оператор импорта
Swift
import CoreLocation
Objective C
@import CoreLocation;
Доступность
Доступный в iOS 2.0 и позже.
A CLLocation
объект представляет данные расположения, сгенерированные a CLLocationManager
объект. Когда те измерения были сделаны, этот объект включает географические координаты и высоту расположения устройства вместе со значениями, указывающими точность измерений и. В iOS этот класс также сообщает информацию о скорости и возглавляющий, в который перемещается устройство.
Как правило, Вы используете a CLLocationManager
объект создать экземпляры этого класса на основе последнего известного расположения устройства пользователя. Однако, если Вы хотите кэшировать пользовательские данные расположения или получить расстояние между двумя точками, можно создать экземпляры сами.
Этот класс разработан, чтобы быть использованным как есть и не должен быть разделен на подклассы.
-
Инициализирует и возвращает объект расположения с указанной широтой и долготой.
Объявление
Swift
init!(latitude
latitude
: CLLocationDegrees, longitudelongitude
: 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
Доступность
Доступный в iOS 2.0 и позже.
-
init (coordinate:altitude:horizontalAccuracy:verticalAccuracy:timestamp:) - initWithCoordinate:altitude:horizontalAccuracy:verticalAccuracy:timestamp:
Инициализирует и возвращает объект расположения с указанной координатной информацией.
Объявление
Swift
init!(coordinate
coordinate
: CLLocationCoordinate2D, altitudealtitude
: CLLocationDistance, horizontalAccuracyhAccuracy
: CLLocationAccuracy, verticalAccuracyvAccuracy
: CLLocationAccuracy, timestamptimestamp
: 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
Доступность
Доступный в iOS 2.0 и позже.
-
init (coordinate:altitude:horizontalAccuracy:verticalAccuracy:course:speed:timestamp:) - initWithCoordinate:altitude:horizontalAccuracy:verticalAccuracy:course:speed:timestamp:
Инициализирует и возвращает объект расположения с указанной координатой и информацией о курсе.
Объявление
Swift
init!(coordinate
coordinate
: CLLocationCoordinate2D, altitudealtitude
: CLLocationDistance, horizontalAccuracyhAccuracy
: CLLocationAccuracy, verticalAccuracyvAccuracy
: CLLocationAccuracy, coursecourse
: CLLocationDirection, speedspeed
: CLLocationSpeed, timestamptimestamp
: NSDate!)Objective C
- (instancetype)initWithCoordinate:(CLLocationCoordinate2D)
coordinate
altitude:(CLLocationDistance)altitude
horizontalAccuracy:(CLLocationAccuracy)hAccuracy
verticalAccuracy:(CLLocationAccuracy)vAccuracy
course:(CLLocationDirection)course
speed:(CLLocationSpeed)speed
timestamp:(NSDate *)timestamp
Параметры
coordinate
Координатная структура, содержащая широту и значения долготы.
altitude
Высотное значение для расположения.
hAccuracy
Точность координатного значения. Указание отрицательного числа указывает, что координатное значение недопустимо.
vAccuracy
Точность высотного значения. Указание отрицательного числа указывает, что высотное значение недопустимо.
course
Направление перемещения на расположение.
speed
Текущая скорость связалась с этим расположением.
timestamp
Время для соединения с объектом расположения. Как правило, Вы установили бы это в текущее время.
Возвращаемое значение
Объект расположения инициализируется с указанной информацией.
Обсуждение
Как правило, Вы получаете объекты расположения от службы определения местоположения, но можно использовать этот метод для создания новых объектов расположения для другого использования в приложении.
Оператор импорта
Objective C
@import CoreLocation;
Swift
import CoreLocation
Доступность
Доступный в iOS 4.2 и позже.
-
coordinate
СвойствоИнформация о географической координате. (только для чтения)
Объявление
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
Доступность
Доступный в iOS 2.0 и позже.
-
altitude
СвойствоВысота измерилась в метрах. (только для чтения)
Объявление
Swift
var altitude: CLLocationDistance { get }
Objective C
@property(readonly, nonatomic) CLLocationDistance altitude
Обсуждение
Положительные значения указывают высоты над уровнем моря. Отрицательные величины указывают высоты ниже уровня моря.
Специальные замечания
В iOS это свойство объявляется как
nonatomic
. В OS X это объявляется какatomic
.Оператор импорта
Objective C
@import CoreLocation;
Swift
import CoreLocation
Доступность
Доступный в iOS 2.0 и позже.
См. также
-
floor
СвойствоЛогический этаж здания, в котором расположен пользователь. (только для чтения)
Объявление
Swift
@NSCopying var floor: CLFloor! { get }
Objective C
@property(readonly, nonatomic, copy) CLFloor *floor
Обсуждение
Если информация о поле не доступна для текущего расположения, значение этого свойства
nil
.Оператор импорта
Objective C
@import CoreLocation;
Swift
import CoreLocation
Доступность
Доступный в iOS 8.0 и позже.
-
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
Доступность
Доступный в iOS 2.0 и позже.
-
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
Доступность
Доступный в iOS 2.0 и позже.
См. также
-
timestamp
СвойствоВремя, в которое было определено это расположение. (только для чтения)
Объявление
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
Доступность
Доступный в iOS 2.0 и позже.
-
description
СвойствоДанные расположения в строке форматированного текста. (только для чтения)
Объявление
Swift
var description: String! { get }
Objective C
@property(nonatomic, readonly, copy) NSString *description
Обсуждение
Строка формы “<<широта>, <долгота>> +/-<точность> m (скорость <скорость> kph / возглавляющий <возглавляющий>) <разовый датой>”, где <широта>, <долгота>, <точность>, <скорость> и <заголовок> отформатированные числа с плавающей точкой и <разовый датой>, является строкой отформатированной даты, включающей дату, время и информация о часовом поясе.
Возвращаемая строка предназначается в целях дисплея только.
Оператор импорта
Objective C
@import CoreLocation;
Swift
import CoreLocation
Доступность
Доступный в iOS 2.0 и позже.
-
Возвращает расстояние (в метрах) от расположения получателя до указанного расположения.
Объявление
Swift
func distanceFromLocation(_
location
: CLLocation!) -> CLLocationDistanceObjective C
- (CLLocationDistance)distanceFromLocation:(const CLLocation *)
location
Параметры
location
Другое расположение.
Возвращаемое значение
Расстояние (в метрах) между этими двумя расположениями.
Обсуждение
Этот метод измеряет расстояние между этими двумя расположениями путем трассировки строки между ними, следующей за искривлением Земли. Получающаяся дуга является плавной кривой и не принимает во внимание, что определенная высота изменяется между этими двумя расположениями.
Оператор импорта
Objective C
@import CoreLocation;
Swift
import CoreLocation
Доступность
Доступный в iOS 3.2 и позже.
-
- getDistanceFrom:
(iOS 3.2)Возвращает расстояние (в метрах) от расположения получателя до указанного расположения.
Оператор осуждения
Используйте
distanceFromLocation:
метод вместо этого.Объявление
Objective C
- (CLLocationDistance)getDistanceFrom:(const CLLocation *)
location
Параметры
location
Другое расположение.
Возвращаемое значение
Расстояние (в метрах) между этими двумя расположениями.
Обсуждение
Этот метод измеряет расстояние между этими двумя расположениями путем трассировки строки между ними, следующей за искривлением Земли. Получающаяся дуга является плавной кривой и не принимает во внимание, что определенная высота изменяется между этими двумя расположениями.
Оператор импорта
Objective C
@import CoreLocation;
Доступность
Доступный в iOS 2.0 и позже.
Осуждаемый в iOS 3.2.
-
speed
СвойствоМгновенная скорость устройства в метрах в секунду.
Объявление
Swift
var speed: CLLocationSpeed { get }
Objective C
@property(readonly, nonatomic) CLLocationSpeed speed
Обсуждение
Это значение отражает мгновенную скорость устройства в направлении его текущего заголовка. Отрицательная величина указывает недопустимую скорость. Поскольку действительная скорость может измениться много раз между поставкой последующих событий расположения, необходимо использовать это свойство для информационных целей только.
Специальные замечания
В iOS это свойство объявляется как
nonatomic
. В OS X это объявляется какatomic
.Оператор импорта
Objective C
@import CoreLocation;
Swift
import CoreLocation
Доступность
Доступный в iOS 2.2 и позже.
-
course
СвойствоНаправление, в котором перемещается устройство.
Объявление
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
Доступность
Доступный в iOS 2.2 и позже.