Name | Date | Size | #Lines | LOC | ||
---|---|---|---|---|---|---|
.. | 03-May-2022 | - | ||||
data/ | H | 23-Dec-2020 | - | 460 | 400 | |
demo/ | H | 23-Dec-2020 | - | 910 | 678 | |
docs/ | H | 23-Dec-2020 | - | 255 | 219 | |
interface/ | H | 23-Dec-2020 | - | 590 | 215 | |
libgeoclue/ | H | 23-Dec-2020 | - | 1,279 | 801 | |
po/ | H | 23-Dec-2020 | - | 18 | 14 | |
public-api/ | H | 23-Dec-2020 | - | 138 | 50 | |
src/ | H | 23-Dec-2020 | - | 12,282 | 8,613 | |
.gitlab-ci.yml | H A D | 23-Dec-2020 | 1.4 KiB | 39 | 34 | |
COPYING | H A D | 23-Dec-2020 | 42.7 KiB | 829 | 684 | |
COPYING.LIB | H A D | 23-Dec-2020 | 25.9 KiB | |||
HACKING.md | H A D | 23-Dec-2020 | 2.1 KiB | 84 | 61 | |
NEWS | H A D | 23-Dec-2020 | 21.8 KiB | 687 | 542 | |
README.md | H A D | 23-Dec-2020 | 2.9 KiB | 75 | 55 | |
geoclue.doap | H A D | 23-Dec-2020 | 1,011 | 28 | 24 | |
meson.build | H A D | 23-Dec-2020 | 3.7 KiB | 106 | 90 |
README.md
1Geoclue: The Geoinformation Service 2=================================== 3 4Geoclue is a D-Bus geoinformation service. The goal of the Geoclue project 5is to make creating location-aware applications as simple as possible. 6 7Geoclue is Free Software, licensed under GNU GPLv2+. 8 9Geoclue comprises the following functionalities : 10- WiFi-based geolocation (accuracy: in meters) 11- GPS(A) receivers (accuracy: in centimeters) 12- GPS of other devices on the local network, e.g smartphones (accuracy: 13 in centimeters) 14- 3G modems (accuracy: in kilometers, unless modem has GPS) 15- GeoIP (accuracy: city-level) 16 17WiFi-based geolocation makes use of 18[Mozilla Location Service](https://wiki.mozilla.org/CloudServices/Location). 19 20If geoclue is unable to find you, you can easily fix that by installing 21and running a 22[simple app](https://wiki.mozilla.org/CloudServices/Location#Contributing) on 23your phone. For using phone GPS, you'll need to install the latest version of 24[GeoclueShare app](https://github.com/ankitstarski/GeoclueShare/releases) 25on your phone (currently, this is supported only on Android devices). 26 27Geoclue was also used for (reverse-)geocoding but that functionality has 28been dropped in favour of the 29[geocode-glib library](http://ftp.gnome.org/pub/GNOME/sources/geocode-glib/). 30 31# History 32Geoclue was started during the GNOME Summit 2006 in Boston. At least 33Keith Preston and Tuomas Kuosmanen can be blamed. There was a total rewrite 34after version 0.9. 35 36Use tag "0.9" (as in git checkout 0.9) if you need the old code. 37 38There was yet another rewrite that we call geoclue2. The first version to 39introduce the re-write was version 1.99. 40 41# Communication and Contribution 42 43- Discussions take place on the 44[GNOME Discourse](https://discourse.gnome.org/c/platform). 45- The IRC chat for geoclue is on __#gnome-maps__ at irc.gimp.org . 46- Issues are tracked on 47[Gitlab](https://gitlab.freedesktop.org/geoclue/geoclue/issues). 48 49# Get Source Code 50The source code is available as a tar-ball and in a Git repository. 51 52For latest release tarballs, use the `Download` option of Gitlab on the 53[tag of your choice](https://gitlab.freedesktop.org/geoclue/geoclue/tags/). 54 55Older (than 2.4.13) releases are available 56[here](http://www.freedesktop.org/software/geoclue/releases/2.4/). 57 58Git repository for Geoclue: https://gitlab.freedesktop.org/geoclue/geoclue 59 60# Building Geoclue 61 62The guidelines for building geoclue have been documented 63[here](https://gitlab.freedesktop.org/geoclue/geoclue/blob/master/HACKING.md). 64 65# Using Geoclue in an application 66 67- __D-Bus API__: The documentation for using geoclue with D-Bus API is 68[here](http://www.freedesktop.org/software/geoclue/docs/). 69- __Libgeoclue API documentation__: The documentation is available 70[here](https://www.freedesktop.org/software/geoclue/docs/libgeoclue/). 71- __C user application__: 72[Here](https://gitlab.freedesktop.org/geoclue/geoclue/blob/master/demo/where-am-i.c) 73is an example showing a C application that uses 74geoclue to locate its user. 75