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

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

Разработчик

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

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

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

CLLocation

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


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


Swift

import CoreLocation

Objective C

@import CoreLocation;

Доступность


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

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

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

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

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

    Объявление

    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

    Доступность

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

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

    Объявление

    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

    Доступность

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

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

    Объявление

    Swift

    init!(coordinate coordinate: CLLocationCoordinate2D, altitude altitude: CLLocationDistance, horizontalAccuracy hAccuracy: CLLocationAccuracy, verticalAccuracy vAccuracy: CLLocationAccuracy, course course: CLLocationDirection, speed speed: CLLocationSpeed, timestamp timestamp: 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 и позже.

    См. также

    verticalAccuracy

  • 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!) -> CLLocationDistance

    Objective 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 и позже.