D-Bus интерфейс org.freedesktop.Geoclue.Position

Интерфейс для работы с клиентом GeoClue.

Шина:	системная
Служба:	`сервис провайдера`
Объект:	`путь провайдера`
Интерфейс:	`org.freedesktop.Geoclue.Position`

Публичные типы

enum PositionFields
struct Accuracy

Сигналы

PositionChanged(int &fields, int &timestamp, double &latitude, double &longitude, double &altitude, Accuracy &accuracy)

Методы

GetPosition(int &fields, int &timestamp, double &latitude, double &longitude, double &altitude, Accuracy &accuracy)

Подробное описание

Через данный интерфейс можно получать местоположение от провайдера Geoclue. Приложениям, использующим данный интерфейс, необходимо указать разрешение Location.

Описание типов класса

enum PositionFields

Валидные поля текущей координаты. Используется как битовая маска.

Константа	Значение	Описание
`NoPositionFields`	`0`	Нет никаких данных
`LatitudePresent`	`1`	Есть широта
`LongitudePresent`	`2`	Есть долгота
`AltitudePresent`	`4`	Есть высота

struct Accuracy {
    int level;
    double horizontal;
    double vertical;
};

Точность координаты.

level — уровень, см. AccuracyLevel в описании org.freedesktop.Geoclue.MasterClient;
horizontal — точность по широте в метрах;
vertical — точность по долготе в метрах.

Описание сигналов

PositionChanged(int &fields, int &timestamp, double &latitude, double &longitude, double &altitude, Accuracy &accuracy)

Уведомляет об изменении местоположения.

fields — валидные поля координаты, см. перечисление PositionFields;
timestamp — время, которому соответствует координата (в секундах с начала эпох);
latitude — широта;
longitude — долгота;
altitude — высота;
accuracy — точность местоположения, см. структуру Accuracy.

Описание методов

GetPosition(int &fields, int &timestamp, double &latitude, double &longitude, double &altitude, Accuracy &accuracy)

Возвращает текущее местоположение.

fields — валидные поля координаты, см. перечисление PositionFields;
timestamp — время, которому соответствует координата (в секундах с начала эпох);
latitude — широта;
longitude — долгота;
altitude — высота;
accuracy — точность местоположения, см. структуру Accuracy.