https://github.com/inputmice/sharelocationplugin
A plugin to add location sharing capabilities to the open source Jabber/XMPP client Conversations
https://github.com/inputmice/sharelocationplugin
Last synced: 10 months ago
JSON representation
A plugin to add location sharing capabilities to the open source Jabber/XMPP client Conversations
- Host: GitHub
- URL: https://github.com/inputmice/sharelocationplugin
- Owner: iNPUTmice
- License: gpl-3.0
- Created: 2015-03-07T22:00:16.000Z (almost 11 years ago)
- Default Branch: master
- Last Pushed: 2017-11-30T01:06:04.000Z (about 8 years ago)
- Last Synced: 2024-10-20T10:36:26.411Z (about 1 year ago)
- Language: Java
- Homepage: http://conversations.im
- Size: 150 KB
- Stars: 35
- Watchers: 10
- Forks: 10
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Share Location Plugin for Conversations
This plugin adds location sharing capabilities to the open source Jabber/XMPP
client Conversations.
### Why a plugin?
One of the design principles of Conversations is to require as few permissions
as possible. Not every user might be comfortable with Conversations accessing
the device location at any given time.
On top of that this plugin makes heavy use of Google Play Services and the
Google Maps API to improve the user experince. (Better location detection using
cell towers and display of an actual map to verify the users position.)
Both of which are not really suitable for mainline Conversations.
### How to use
This plugin requires Conversations >= 1.2.0. If installed Conversations will
show a *Send location* in the attach menu. (Next to *Choose picture*, *Take
picture* and *Choose file*)
### How does it work
The Share Location Plugin offers an intent called
`eu.siacs.conversations.location.request` which returns (after user confirmation)
a latitude and longitude as well as accuracy and altitude information (which
currently are not being used).
Corresponding to that the plugin also offers an intent
`eu.siacs.conversations.location.show` to simple display a marker on a map. This
is being used to display a contacts location in a more lightweight enviroment than
the actual Google Maps application.
### How to build / install
The primary distrubution channel for this plugin is the Google Play Store because
it just won’t run on AOSP.
If you do want to run your own version you will need a Google Maps API Key and
place this in a string resource called `google_maps_api_key`.