• CLLocation
 

CLLocation класс

CLLocation

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

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

Этот класс спроектирован для использования его как есть и вам не следует создавать его подклассы.

- initWithLatitude:longitude:
- initWithCoordinate:altitude:horizontalAccuracy:verticalAccuracy:timestamp:
- initWithCoordinate:altitude:horizontalAccuracy:verticalAccuracy:course:speed:timestamp:
coordinate
altitude
floor
horizontalAccuracy
verticalAccuracy
timestamp
description
- distanceFromLocation:
speed
course

 

- initWithLatitude:longitude:

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

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

Аргументы:

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

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

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

Рассмотрение:

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

Доступно:

iOS 2.0 и выше

- initWithCoordinate:altitude:horizontalAccuracy:verticalAccuracy:timestamp:

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

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

Аргументы:

coordinateСтруктура, содержащая значения широты и долготы.
altitudeЗначение высоты для местоположения.
hAccuracyТочность значения координат. Задание отрицательного числа означает, что значение координат является недействительным.
timestampВремя, ассоциированное с объектом местоположения. Обычно устанавливается в текущее значение: [NSDate date];.

Рассмотрение:

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

Доступно:

iOS 2.0 и выше

- initWithCoordinate:altitude:horizontalAccuracy:verticalAccuracy:course:speed:timestamp:

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

- (instancetype _Nonnull)initWithCoordinate:(CLLocationCoordinate2D)coordinate altitude:(CLLocationDistance)altitude horizontalAccuracy:(CLLocationAccuracy)hAccuracy verticalAccuracy:(CLLocationAccuracy)vAccuracy course:(CLLocationDirection)course speed:(CLLocationSpeed)speed timestamp:(NSDate * _Nonnull)timestamp

Аргументы:

coordinateСтруктура, содержащая значения широты и долготы.
altitudeЗначение высоты для местоположения.
hAccuracyТочность значения координат. Задание отрицательного числа означает, что значение координат является недействительным.
vAccuracyТочность значения высоты. Задание отрицательного числа означает, что значение высоты является недействительным.
courseНаправление движения для местоположения.
speedТекущая скорость ассоциированная с этим местоположения.
timestampВремя, ассоциированное с объектом местоположения. Обычно устанавливается в текущее значение: [NSDate date];.

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

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

Доступно:

iOS 4.2 и выше

coordinate

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

@property(readonly, nonatomic) CLLocationCoordinate2D coordinate

Рассмотрение:

Когда запускается iOS стимулятор, Core Location использует значение предоставленное симулятором. Вы должны запустить приложение на iOS устройстве, чтобы получить актуальное местоположение.

В iOS это свойство nonatomic, в OS X atomic.

Доступно:

iOS 2.0 и выше

altitude

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

@property(readonly, nonatomic) CLLocationDistance altitude

Рассмотрение:

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

В iOS это свойство nonatomic, в OS X atomic.

Доступно:

iOS 2.0 и выше

floor

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

@property(readonly, nonatomic, copy, nullable) CLFloor *floor

Рассмотрение:

Если информация об этаже недоступна в текущем местоположении, это свойство имеет значение nil.

Доступно:

iOS 8.0 и выше

horizontalAccuracy

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

@property(readonly, nonatomic) CLLocationAccuracy horizontalAccuracy

Рассмотрение:

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

В iOS это свойство nonatomic, в OS X atomic.

Доступно:

iOS 2.0 и выше

verticalAccuracy

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

@property(readonly, nonatomic) CLLocationAccuracy verticalAccuracy

Рассмотрение:

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

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

В iOS это свойство nonatomic, в OS X atomic.

Доступно:

iOS 2.0 и выше

timestamp

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

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

Рассмотрение:

В iOS это свойство nonatomic, в OS X atomic.

Доступно:

iOS 2.0 и выше

description

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

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

Рассмотрение:

Строка имеет формат «<<latitude>, <longitude>> +/- <accuracy>m (speed <speed> kph / heading <heading>) @ <date-time>», где <latitude>, <longitude>, <accuracy>, <speed>, <heading> числа сплавающей точкой, а <date-time> форматированная строка, содержащая дату время и временную зону.

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

Доступно:

iOS 2.0 и выше

- distanceFromLocation:

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

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

Аргументы:

locationДругое местоположение.

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

Дистанцию в метрах между двумя местоположениями.

Рассмотрение:

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

Доступно:

iOS 3.2 и выше

speed

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

@property(readonly, nonatomic) CLLocationSpeed speed

Рассмотрение:

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

В iOS это свойство nonatomic, в OS X atomic.

Доступно:

iOS 2.0 и выше

course

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

@property(readonly, nonatomic) CLLocationDirection course

Рассмотрение:

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

В iOS это свойство nonatomic, в OS X atomic.

Доступно:

iOS 2.0 и выше
 
 
homeЗаметили ошибкукарта сайта 
   Made on a Mac